Skip to content
BranchesTags

Repository files navigation

opencode-claude

GitHub stars GitHub release npm Discord License

Claude Code in OpenCode. Subscription OAuth. Agent SDK.

opencode-claude is the OpenCode plugin for running Claude models — Fable, Opus, Sonnet, and Haiku — from a Claude Pro/Max subscription, with effort variants, tools, attachments, and auto-compact.

Use Claude from OpenCode and OpenChamber without an Anthropic API key. The plugin authenticates with Claude Pro/Max OAuth, runs the Anthropic Agent SDK plus the local claude CLI, and proxies an OpenAI-compatible /v1/chat/completions surface into OpenCode.

Sibling plugins: @openchamber/opencode-cursor and @openchamber/opencode-commandcode.

opencode-claude — Claude Code in OpenCode, subscription OAuth, Agent SDK

What you can do

Sign in with Claude Pro/Max, not an API key

opencode auth login --provider claude-code syncs credentials from the Claude Code CLI or opens a Pro/Max browser OAuth flow. API keys are stripped from the child environment so billing stays on the subscription.

Pick models and thinking effort

Aliases fable / opus / sonnet / haiku plus pinned ids. Native OpenCode variants low → max map to Claude --effort and adaptive thinking.

Keep agent loops moving

OpenCode tools bridge as in-process MCP. Calls park and resume instead of deadlocking or inventing output. Streaming, MCP, and sticky Claude session IDs keep follow-ups on the same Agent SDK turn.

Attachments, compact, and history

Images and PDFs from OpenCode reach Claude (data URLs and remote URLs). Long sessions auto-compact like Claude Code. When a Claude session cannot be resumed, the prior conversation is serialized into the prompt so Claude does not start blind.

Rate-limit counter

Subscription limit state is tracked with its reset time. GET /v1/rate-limit answers when limits return; doomed turns fail fast with 429 and Retry-After.

Quick start

claude-code is not a built-in OpenCode provider. Install the plugin first, or opencode auth login --provider claude-code fails with Unknown provider "claude-code".

1. Install the plugin

npm install -g @openchamber/opencode-claude

Or with OpenCode:

# global (recommended)
opencode plugin @openchamber/opencode-claude -g

# or project-local (writes .opencode/opencode.json)
opencode plugin @openchamber/opencode-claude

2. Register it in OpenCode

Add (or merge) this into ~/.config/opencode/opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["@openchamber/opencode-claude"],
  "provider": {
    "claude-code": { "name": "Claude Code" }
  }
}

3. Authenticate

# Option A — sync from Claude Code CLI (recommended)
claude auth login
opencode auth login --provider claude-code
# pick "Use Claude Code CLI login"

# Option B — browser OAuth (Pro/Max)
opencode auth login --provider claude-code
# pick "Login with Claude Pro/Max"

4. Run a Claude model

opencode run "Summarise this repository in five bullets." --model claude-code/sonnet

In the TUI, pick provider claude-code, choose a model, and set the effort variant (low / medium / high / xhigh / max) when you want deeper thinking.

From source (optional)

git clone https://github.com/openchamber/opencode-claude.git
cd opencode-claude
bun install && bun run build
opencode plugin file://$PWD

Authenticate

Step What happens
claude auth login then opencode auth login --provider claude-code Syncs the Claude Code CLI grant (recommended)
Or pick Login with Claude Pro/Max Browser OAuth for a Pro/Max subscription
Plugin stores credentials OpenCode auth.json; CLI-synced chains stay owned by the CLI
Access expires Plugin-owned tokens refresh with single-flight rotation; CLI-synced tokens are never rotated by the plugin

API keys are not used. Subscription OAuth is the supported path.

Architecture

OpenCode
  └─ /v1/chat/completions
       └─ Bun.serve proxy (ephemeral port; published via auth loader)
            └─ Claude Agent SDK query()
                 └─ claude CLI (subscription OAuth)
Layer Responsibility
Plugin hooks OAuth, provider config, model catalog, effort headers
Proxy OpenAI ↔ Agent SDK protocol, tool parking, compact, rate-limit gate
CLI Subscription credentials and the Claude Code harness

Model catalog: aliases fable / opus / sonnet / haiku plus pinned ids. Effort selection is encoded in x-opencode-claude-effort so the proxy passes the exact effort (and adaptive thinking) into the Agent SDK.

Rate-limit counter

The proxy records Agent SDK rate_limit_event telemetry and hard session-limit errors (including the parsed reset time) to ~/.local/share/opencode-claude/rate-limit.json.

  • GET /v1/rate-limit → { limited, status, rateLimitType, utilization, resetsAt, resetsAtISO, resetInSeconds, message, updatedAt } — poll this for a "limits reset in …" countdown. utilization is only present when the latest SDK event reported it — it is never carried over from an earlier limit window.
  • GET /health includes a compact rateLimit summary.
  • While a confirmed hard limit is active, new chat turns return HTTP 429 with Retry-After + x-claude-rate-limit-reset headers and an error.type = "rate_limit_error" body (title/summary meta requests are never gated). The block lifts automatically at reset time; the next turn resumes the same Claude session.
  • OPENCODE_CLAUDE_RATE_LIMIT_FAST_FAIL=0 disables the 429 gate (turns are attempted and error normally).

Requirements

  • OpenCode
  • Claude Code CLI on PATH
  • Claude Pro/Max subscription (or CLI OAuth credentials)
  • Bun (plugin runtime) · Node.js ≥ 18

Development

bun install
bun run build
bun run test

Debug logging: OPENCODE_CLAUDE_DEBUG=1.

Optional knobs:

  • OPENCODE_CLAUDE_PROXY_PORT — optional pinned proxy port (default: ephemeral / OS-assigned; live URL is published to OpenCode via config + auth loader)
  • OPENCODE_CLAUDE_CWD — working directory passed to the Agent SDK
  • CLAUDE_CODE_OAUTH_TOKEN — inject a subscription token (CI / headless)
  • OPENCODE_CLAUDE_RATE_LIMIT_FAST_FAIL — 0 disables the 429 rate-limit gate
  • OPENCODE_CLAUDE_RATE_LIMIT_STORE — override the rate-limit store path (tests)
  • OPENCODE_CLAUDE_HISTORY_MAX_CHARS — budget for transferred conversation history when a Claude session cannot be resumed (default 400000; newest messages are kept, 0 disables transfer)

Troubleshooting

Symptom Fix
Unknown provider claude-code Install @openchamber/opencode-claude and restart OpenCode
Claude Code missing from provider list Confirm plugin includes @openchamber/opencode-claude and restart OpenCode
Auth / revoked grant Re-run claude auth login then opencode auth login --provider claude-code. Do not share one OAuth chain between the plugin and the stock Anthropic provider
429 / rate-limit Poll GET /v1/rate-limit or wait until resetsAt; the next turn resumes the same session
Tools hang or invent output Update to the latest plugin — park/resume MCP bridging is required
Attachments ignored Use a current build; image/PDF parts are converted to Claude blocks

Release

Publish via GitHub Actions → Actions → Release → Run workflow:

Input Purpose
version Explicit semver (0.6.0). Empty → use bump
bump minor (default) / patch / major
dry_run Skip npm publish; create a draft GitHub release

Requires repo secrets: NPM_TOKEN, optional DISCORD_WEBHOOK_URL.

Local pin refresh after a release:

./scripts/update-plugin.sh --dry-run
./scripts/update-plugin.sh

Contributing

Issues and pull requests belong in this repository: openchamber/opencode-claude.

bun install
bun run build
bun run test

Acknowledgments

This plugin started as community work around Claude Code in OpenCode. Special thanks to:

  • OpenCode for the plugin API
  • OpenChamber for the workspace that runs this plugin in production
  • Anthropic for the Claude Agent SDK and Claude Code CLI
  • Contributors who shaped OAuth, the proxy, tools, and compact

License

MIT

About

Anthropic provider plugin for OpenCode

Resources

Readme
MIT license
Activity
Custom properties

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Contributors

Languages