@xtruder/opencode-claude-max-plugin weekly downloads statistics

@xtruder/opencode-claude-max-plugin

Use Claude Pro/Max subscription credentials in OpenCode, with a subscription-usage sidebar and /usage dialog. The plugin uses the official Anthropic SDK through OpenCode's AI SDK adapter.

Requires OpenCode 2.0.16 or later. OpenCode v1 is not supported. Model availability depends on your account.

Installation

Sign in to Claude Code, then add the plugin to ~/.config/opencode/opencode.json or your existing opencode.jsonc:

claude auth login

{
  "plugins": ["@xtruder/opencode-claude-max-plugin"]
}

OpenCode installs the package and discovers both its provider and terminal UI. No separate provider configuration is needed. Restart OpenCode after changing the configuration; if you use a shared server, restart it and the terminal client.

When migrating from v1, replace the old plugin entry with the v2 plugins configuration and remove any separate registration of src/tui.tsx. Use a v2-compatible plugin release; version 0.4.6 predates this migration.

Authentication

For subscription access, sign in with Claude Code:

claude auth login

The plugin reads ~/.claude/.credentials.json. Credential refresh is deferred until an inference request needs it.

Authentication is selected in this order:

1. An explicit apiKey plugin option.
2. The ANTHROPIC_API_KEY environment variable.
3. Claude Code's OAuth credentials.

If you intend to use your subscription, make sure an API key is not overriding it. API-key requests use API billing rather than subscription access.

For a custom credentials file, supply server plugin options:

{
  "plugins": [
    {
      "package": "@xtruder/opencode-claude-max-plugin",
      "options": {
        "credentialsPath": "/absolute/path/to/.credentials.json"
      }
    }
  ]
}

The credentials must be accessible to the process running the provider. The usage TUI reads credentials on the machine running the terminal client.

Usage

Choose a model from the anthropic-sdk provider in OpenCode, or run:

opencode run --standalone -m anthropic-sdk/claude-haiku-5-5 'Reply with exactly OK.'
opencode run --standalone -m 'anthropic-sdk/claude-sonnet-5-5#high' 'Explain this code.'

Registered models (each row is a separate selectable entry):

Model	OpenCode model ID
Claude Haiku 5.5	claude-haiku-5-5
Claude Sonnet 5	claude-sonnet-5
Claude Sonnet 5.5	claude-sonnet-5-5
Claude Opus 4.8	claude-opus-4-8
Claude Opus 5	claude-opus-5
Claude Opus 5.5	claude-opus-5-5
Claude Fable 5	claude-fable-5
Claude Fable 5.1	claude-fable-5-1

Claude Opus 5 remains available as a legacy model; it is not an alias for Opus 5.5. Anthropic names it “Claude Opus 5”, not “Claude Opus 5.0”.

Haiku 4.5, Sonnet 4.6, Opus 4.6 (including the -1m variant), and Opus 4.7 are no longer registered by this plugin. Select a supported model when continuing sessions that used them.

Registration does not guarantee account access to a model. Use these OpenCode IDs rather than dated API aliases.

Model settings

Use OpenCode v2's providers configuration for model overrides. For example, to disable refusal fallback for a model:

{
  "providers": {
    "anthropic-sdk": {
      "models": {
        "claude-fable-5": {
          "settings": { "refusalFallback": false }
        }
      }
    }
  }
}

The provider supports model-specific prompts, prompt caching, thinking, tool calls, pause-turn continuation, and server-side refusal fallbacks. See RESEARCH.md for request-format details.

Subscription usage

The terminal sidebar shows available 5-hour and 7-day usage windows and reset times. Run /usage or select it from the command palette for additional model-specific windows and extra-usage status. Press Escape to close the dialog.

Usage comes from subscription data, not estimates derived from token counts. It is separate from OpenCode's native token/cost statistics.

The display checks its shared cache every 60 seconds by default. Usage API results are cached for five minutes; opening /usage does not bypass that cache or rate-limit backoff. Failed requests retain cached values with a status notice. Fetching usage does not send an inference request or launch Claude Code to refresh credentials.

TUI settings

Defaults work with the server plugin registration alone. To customize the terminal UI, add an entry to ~/.config/opencode/cli.json:

{
  "plugins": [
    {
      "package": "@xtruder/opencode-claude-max-plugin",
      "options": {
        "enabled": true,
        "sidebar": true,
        "poll_interval": 60
      }
    }
  ]
}

Option	Default	Description
enabled	true	Enable the usage TUI.
sidebar	true	Show sidebar usage. Disabling it keeps /usage available.
poll_interval	60	Cache polling interval in seconds; minimum 10.
credentialsPath	~/.claude/.credentials.json	Credentials file used by the usage TUI.

Server plugin options are not automatically passed to the TUI. Set a custom TUI credentials path in cli.json, even if it is already configured for the server. The usage cache is shared within an XDG state directory, not separated by credentials file or account.

Development…