[FEATURE]: First-class Claude Code bridge / external runtime support for Claude models

[nianyi778]

Feature hasn't been suggested before.

• I have verified this feature I'm about to request hasn't been suggested before.

Describe the enhancement you want to request

I'm a Claude Pro/Max subscriber using OpenCode daily. After upgrading to 1.3.x, I noticed the built-in Anthropic OAuth was removed (#18186). Before that, I was constantly hitting Token refresh failed: 429 — same as what's reported in #18329, #18315, and #15562.

Right now I'm using the community plugin opencode-claude-bridge, which reads credentials from my local Claude Code installation instead of doing its own OAuth token refresh. It works, and it's been stable for me.

What I'm requesting: make this kind of path a first-class feature instead of relying on community plugins.

Specifically:

• External runtime / bridge mode: let OpenCode use Claude models through a local Claude Code installation. OpenCode handles UX, tools, and sessions; Claude Code handles auth and request format. This avoids OpenCode needing to own subscription token refresh logic.
• Detection and migration: if OpenCode detects that Anthropic OAuth is broken but Claude Code is installed and logged in locally, offer a one-click switch to bridge mode instead of just showing Token refresh failed: 429.
• Better error diagnostics: replace raw errors like Token refresh failed: 429 with actionable messages — e.g. "Anthropic OAuth refresh failed. Claude Code is installed on this machine. Switch to bridge mode?"

Why this is different from #18329 / #18315 / #15562: those are bug reports about the old OAuth flow breaking. This is a feature request for a more durable integration path that doesn't depend on OpenCode managing Claude subscription tokens directly.

If policy or legal reasons prevent official support, I'd appreciate a clear statement so the community knows to maintain plugins independently. Either way, I'm happy to help test.

[github-actions]

This issue doesn't fully meet our contributing guidelines.

What needs to be fixed:

• No issue template was used. This project requires one of three templates: Bug Report, Feature Request (title must start with [FEATURE]:), or Question.
• The issue reads as an AI-generated wall of text — long, highly structured prose with option A/B breakdowns and multi-step product proposals. We ask that issues reflect the author's actual experience in their own words.
• If this is a question for maintainers, please use the Question template and provide the Question field with your specific ask. If it's a feature request, use the Feature Request template with a [FEATURE]: prefix in the title.

Please edit this issue to address the above within 2 hours, or it will be automatically closed.

---

This issue might be a duplicate of or closely related to existing issues. Please check:

• Anthropic Claude Pro/Max OAuth login fails with 429 on token exchange #18329: Anthropic Claude Pro/Max OAuth login fails with 429 on token exchange (open)
• Claude Pro/Max auth flow returns Invalid token. #18315: Claude Pro/Max auth flow returns Invalid token (open)
• Claude OAuth token requires re-authentication after every usage limit reset #15562: Claude OAuth token requires re-authentication after every usage limit reset

The concerns raised here appear to be a meta-discussion about those existing bugs rather than a new standalone issue.

If you believe this was flagged incorrectly, please let a maintainer know.

[github-actions]

Thanks for updating the issue! It now meets the contributing guidelines and looks good. We appreciate the detailed context and the clear feature request.

[sakithajayasinghe]

https://github.com/sakithajayasinghe/opencode/tree/feat/claude-code-oauth

use this fix. it is working with claude code subscription

[nianyi778]

Thanks for sharing this! Does this branch handle token refresh automatically, or does it still rely on Claude Code's local credentials each time? Also curious whether you're planning to submit a PR upstream — this seems like exactly the use case the feature request is about.

[sakithajayasinghe]

Thanks for sharing this! Does this branch handle token refresh automatically, or does it still rely on Claude Code's local credentials each time? Also curious whether you're planning to submit a PR upstream — this seems like exactly the use case the feature request is about.

Open code has replied me this is not legally possible. therefore i discontinued the work.

[nianyi778]

Thanks for the update. That's a shame — the feature seemed genuinely useful. Appreciate you sharing your work regardless.