Use your Claude Pro or Max subscription with OpenCode. Supports multiple accounts with automatic rotation when you hit rate limits.

Prerequisites: OpenCode installed, a Claude Pro or Max subscription, Node.js 18+.

# 1. Clone and install git clone https://github.com/actualyze-ai/opencode-anthropic-auth.git cd opencode-anthropic-auth npm install # 2. Install the plugin + CLI npm run install:link # 3. Start OpenCode and connect opencode # Press Ctrl+K → Connect Provider → Anthropic → "Claude Pro/Max (multi-account)" # Follow the OAuth prompts to log in

That's it. OpenCode will now use your Claude subscription directly. All model costs show as $0.00.

The upstream plugin ships as a built-in default with OpenCode. This fork adds:

• Multi-account support — add up to 10 Claude accounts and rotate between them
• Automatic rate limit handling — when one account hits a limit, the plugin switches to another
• Health scoring — tracks account reliability and prefers healthy accounts
• Standalone CLI — manage accounts without opening OpenCode
• Configurable strategies — sticky, round-robin, or hybrid account selection

Best for active development. Edits to source files take effect immediately.

npm run install:link

This creates:

• Plugin: ~/.config/opencode/plugin/opencode-anthropic-auth-plugin.js → ./index.mjs
• CLI: ~/.local/bin/opencode-anthropic-auth → ./cli.mjs

Bundles the plugin and CLI into self-contained single files (via esbuild) and copies them. No symlinks, no node_modules needed at the destination.

npm run install:copy

This creates:

• Plugin: ~/.config/opencode/plugin/opencode-anthropic-auth-plugin.js (standalone, ~50KB)
• CLI: ~/.local/bin/opencode-anthropic-auth (standalone, ~35KB)

npm run uninstall

If ~/.local/bin isn't on your PATH, add it:

export PATH="$HOME/.local/bin:$PATH"

1. Open OpenCode
2. Press Ctrl+K → Connect Provider → Anthropic
3. Select "Claude Pro/Max (multi-account)"
4. Open the URL in your browser, authorize, and paste the code back

You can also add accounts directly from the CLI without opening OpenCode:

opencode-anthropic-auth login

Run the auth flow again (via CLI login or OpenCode's Connect Provider). The plugin detects existing accounts and shows a menu:

2 account(s) configured: 1. alice@example.com (active) 2. bob@example.com (a)dd new, (f)resh start, (m)anage, (c)ancel? [a/f/m/c]: 

• Add — log in with another Claude account
• Fresh start — clear all accounts and start over
• Manage — enable/disable/remove accounts inline
• Cancel — keep current setup

You can also use the "Create an API Key" or "Manually enter API Key" auth methods if you prefer API key auth (single account, no rotation).

The CLI lets you manage accounts outside of OpenCode.

opencode-anthropic-auth [command] [args]

# Add a new account via browser OAuth opencode-anthropic-auth login # See account status (includes live usage quotas) opencode-anthropic-auth list # Output: # Anthropic Multi-Account Status # # Account Status Failures Rate Limit # ────────────────────────────────────────────────────────────── # 1 alice@example.com ● active 0 — # 5h █████░░░░░ 45% resets in 2h 30m # 7d █████░░░░░ 45% resets in 4d 16h # Sonnet 7d ░░░░░░░░░░ 0% # # 2 bob@example.com ● ready 0 — # 5h ███░░░░░░░ 31% resets in 30m # 7d ███████░░░ 70% resets in 19h 31m # Sonnet 7d █░░░░░░░░░ 11% resets in 2d 10h # # Strategy: sticky | 2 of 2 enabled # Storage: ~/.config/opencode/anthropic-accounts.json # Switch active account opencode-anthropic-auth switch 2 # Re-authenticate a broken account (opens browser) opencode-anthropic-auth reauth 1 # Quick token refresh without browser opencode-anthropic-auth refresh 1 # Revoke tokens and remove an account opencode-anthropic-auth logout 2 # Revoke all tokens and clear all accounts opencode-anthropic-auth logout --all # View token usage per account opencode-anthropic-auth stats # Reset all usage counters opencode-anthropic-auth reset-stats all # One-liner for shell prompts opencode-anthropic-auth status # anthropic: 2 accounts (2 active), strategy: sticky, next: #1 # Interactive management opencode-anthropic-auth manage

Most commands have short aliases: ln, lo, ra, rf, ls, st, sw, en, dis, rm, strat, cfg, mg.

The plugin also registers a built-in /anthropic slash command so you can manage accounts without leaving OpenCode.

/anthropic # list (default) /anthropic usage # full account list + quota windows /anthropic switch 2 /anthropic refresh 1 /anthropic logout 2 # revoke tokens and remove account 2 /anthropic logout --all # revoke all tokens and clear all accounts /anthropic strategy hybrid /anthropic stats /anthropic config 

Login and reauth are two-step flows in slash mode:

/anthropic login # opens URL instructions in chat /anthropic login complete <code#state> /anthropic reauth 1 # opens URL instructions in chat /anthropic reauth complete <code#state> 

Pending slash OAuth flows expire after 10 minutes. If completion fails with an expiration message, run the start command again.

• Destructive commands (remove, logout) run with non-interactive --force behavior in slash mode.
• Interactive manage is terminal-only; use granular slash commands instead.

Control how the plugin picks which account to use for each request.

# Via CLI opencode-anthropic-auth strategy round-robin # Via environment variable (overrides config file) export OPENCODE_ANTHROPIC_STRATEGY=hybrid # Via config file # Edit ~/.config/opencode/anthropic-auth.json

Configuration is stored at ~/.config/opencode/anthropic-auth.json. All settings are optional — defaults work well for most users.

{ // Account selection strategy: "sticky" | "round-robin" | "hybrid" "account_selection_strategy": "sticky", // Seconds before consecutive failure count resets (60-7200) "failure_ttl_seconds": 3600, // Enable debug logging "debug": false, // Health score tuning (0-100 scale) "health_score": { "initial": 70, "success_reward": 1, "rate_limit_penalty": -10, "failure_penalty": -20, "recovery_rate_per_hour": 2, "min_usable": 50, "max_score": 100, }, // Client-side rate limiting (token bucket) "token_bucket": { "max_tokens": 50, "regeneration_rate_per_minute": 6, "initial_tokens": 50, }, // Toast notification settings "toasts": { // Suppress non-error toasts (account status, switching) "quiet": false, // Minimum seconds between account-switch toasts (0-300) "debounce_seconds": 30, }, }

When you make a request through OpenCode:

1. The plugin selects an account based on your strategy
2. It refreshes the OAuth token if expired
3. It transforms the request (adds OAuth headers, beta flags, tool prefixes)
4. If the response is account-specific (429/401, plus 400/403 billing/quota/permission errors), it marks that account and immediately tries the next account
5. If the response is service-wide (500/503/529), it returns the error directly (switching accounts would not help)
6. It tries each available account at most once per request
7. Successful responses have tool name prefixes stripped from the stream

The plugin also:

• Zeros out model costs (your subscription covers usage)
• Prepends the "Claude Code" system prompt prefix
• Sanitizes "OpenCode" references to "Claude Code" in system prompts (required by Anthropic's API)
• Adds ?beta=true to /v1/messages requests

Account credentials are stored with restrictive file permissions (owner read/write only) and are excluded from git via an auto-generated .gitignore.

Make sure the plugin is installed in ~/.config/opencode/plugin/. Restart OpenCode after installing.

Your OAuth token may have expired. Try a quick refresh first, or re-authenticate with fresh browser login:

# Quick token refresh (no browser needed) opencode-anthropic-auth refresh 1 # Full re-authentication (opens browser) opencode-anthropic-auth reauth 1

Or re-run the auth flow from OpenCode: Ctrl+K → Connect Provider → Anthropic.

When all accounts are exhausted for an account-specific error, the plugin returns immediately instead of sleeping in-process. Try:

# Check status opencode-anthropic-auth list # Reset tracking if stuck opencode-anthropic-auth reset all

You may see Claude: <email> toasts even when your selected model is not Anthropic (e.g., OpenAI Codex, Gemini). This is expected behavior — OpenCode uses Claude Haiku as a background "small model" for internal tasks like generating session titles, regardless of which model you selected. These background API calls go through the Anthropic provider, which triggers the plugin's fetch interceptor and its account-usage toast.

To suppress non-error toasts, set quiet mode in your config:

// ~/.config/opencode/anthropic-auth.json { "toasts": { "quiet": true }, }

Or via environment variable:

export OPENCODE_ANTHROPIC_QUIET=1

Error toasts (e.g., "Disabled Account 1 (token refresh failed)") are never suppressed.

Make sure ~/.local/bin is on your PATH:

export PATH="$HOME/.local/bin:$PATH"

Same as upstream. See anomalyco/opencode-anthropic-auth.

Maintained at actualyze-ai/opencode-anthropic-auth.