[!CAUTION] This project is for personal development use with your own ChatGPT Plus/Pro subscription.

By using this plugin, you acknowledge:

• This is an independent open-source project, not an official OpenAI product
• It is not intended for commercial resale, shared multi-user access, or production services
• You are responsible for your own usage and policy compliance
• For production/commercial workloads, use the OpenAI Platform API

Option A: Standard install

npx -y oc-codex-multi-auth@latest

Option B: Full explicit model catalog

Use this when you want direct selector IDs such as openai/gpt-5.5-medium in addition to OpenCode variants.

npx -y oc-codex-multi-auth@latest --full

Option C: Verify wiring

opencode --version
opencode debug config
opencode auth login

The installer updates ~/.config/opencode/opencode.json, backs up the previous config, normalizes the plugin entry to "oc-codex-multi-auth", and clears the OpenCode cached plugin copy so OpenCode reinstalls the latest package.

Step-by-step

1. Install or refresh config:
   • npx -y oc-codex-multi-auth@latest
2. Run first login flow:
   • opencode auth login
3. Validate config:
   • opencode debug config
4. Run a smoke request:
   • opencode run "Explain this repository" --model=openai/gpt-5.5 --variant=medium
5. Inspect plugin state with the OpenCode tool surface:
   • codex-status
   • codex-doctor
   • codex-list

Verification

opencode debug config
opencode auth login
opencode run "ping" --model=openai/gpt-5.5 --variant=medium

By default, account pools are stored locally as V3 JSON files. File permissions are restricted where the platform supports them.

Use JSON storage when you want predictable, inspectable local files and easy backup/export behavior.

Set CODEX_KEYCHAIN=1 to store account pools in the OS keychain instead:

• macOS: Keychain
• Windows: Credential Manager
• Linux: libsecret, with a running secret service such as GNOME Keyring or KWallet

Manage the backend from OpenCode:

codex-keychain status
codex-keychain migrate
codex-keychain rollback

If the keychain is unavailable, the plugin logs a warning and falls back to JSON storage for that operation. Credentials are never silently deleted.

codex-doctor --fix
codex-next
codex-status format="json"

If still broken:

opencode auth login

• Plugin does not load: rerun npx -y oc-codex-multi-auth@latest, then restart OpenCode
• Config looks wrong: run opencode debug config and confirm "plugin": ["oc-codex-multi-auth"]
• OAuth callback fails: free port 1455, then rerun opencode auth login
• Browser launch is blocked: use the device-code/manual login path from docs/getting-started.md
• Wrong account is selected: run codex-list, then codex-switch
• Account pool looks unhealthy: run codex-health format="json" and codex-doctor deep=true format="json"
• Import/export feels risky: run codex-import path="..." dryRun=true before applying
• Debugging model fallback: enable ENABLE_PLUGIN_REQUEST_LOGGING=1 and inspect ~/.opencode/logs/codex-plugin/

codex-status format="json"
codex-limits format="json"
codex-health format="json"
codex-next format="json"
codex-list format="json"
codex-dashboard format="json"
codex-metrics format="json"
codex-doctor deep=true format="json"

• Not affiliated with OpenAI.
• "ChatGPT", "GPT-5", "Codex", and "OpenAI" are trademarks of OpenAI.
• You assume responsibility for your own usage and compliance.