opencode-codex

Multi-account ChatGPT Codex auth plugin for OpenCode.

Important

opencode-codex is an unofficial community project. It is not built by the OpenCode team and is not affiliated with OpenCode.

opencode-codex lets OpenCode treat the built-in openai OAuth flow as a Codex subscription path with managed multi-account rotation.

It preserves OpenCode's own openai model list and only replaces the auth and request transport used for the Codex account pool.

Install

Add the published npm package to your OpenCode config:

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["opencode-codex"]
}

OpenCode installs npm plugins automatically with Bun at startup.

For local development, place this project in .opencode/plugins/ or point OpenCode at a local plugin file.

Login

Run:

opencode auth login --provider openai

Methods exposed by the plugin:

• Codex
• Manually enter API Key

Selecting Codex opens the plugin-managed account screen:

opencode auth login --provider openai

In a normal TTY terminal it opens a navigable account-management menu. In non-TTY environments it falls back to a readline flow.

From the management flow you can:

• Inspect which account is currently active for routing
• See the saved label, plus account email when available
• Review enabled, disabled, and rate-limited state with quota summaries
• Edit an account label
• Enable or disable an account
• Refresh an account's quota snapshot without rotating tokens
• Remove an account with confirmation

The plugin stores the full account pool in ~/.config/opencode/codex-accounts.sqlite and keeps one sentinel OAuth record under the openai provider in opencode's auth.json so OpenCode uses its built-in Codex-compatible request path.

The plugin reuses opencode's built-in openai provider instead of creating a standalone codex provider.

While the plugin is active, openai OAuth is treated as the Codex subscription path.

Requirements

• OpenCode with npm plugin loading enabled
• A Codex-compatible OpenAI account
• Bun for local development and test runs

Behavior

• Sticky account selection
• Switches immediately on 429
• Tracks per-account Codex usage windows from response headers and GET /backend-api/wham/usage
• Respects 5-hour, weekly, and alternate metered-bucket exhaustion during account rotation
• Fails fast when all accounts are rate-limited

Config

Optional config file: .opencode/opencode-codex.json

{
  "rateLimitMs": 3600000
}

Development

bun install
bun run typecheck
bun test
bun run build

The published package ships compiled output from dist/.