Forked from numman-ali/opencode-openai-codex-auth (by Numman Ali) Maintained by ndycode

One install. Every Codex model. Install · Models · Configuration · Docs

💡 Philosophy

"One config. Every model." OpenCode should feel effortless. This plugin keeps the setup minimal while giving you full GPT‑5.x + Codex access via ChatGPT OAuth.

┌─────────────────────────────────────────────────────────┐
│                                                         │
│  ChatGPT OAuth → Codex backend → OpenCode               │
│  One command install, full model presets, done.         │
│                                                         │
└─────────────────────────────────────────────────────────┘

🚀 Quick Start

Install from npm (recommended)

npx -y opencode-openai-codex-auth-multi@latest

Legacy OpenCode (v1.0.209 and below):

npx -y opencode-openai-codex-auth-multi@latest --legacy

Then:

# Modern OpenCode (v1.0.210+)
opencode auth login
opencode run "write hello world to test.txt" --model=openai/gpt-5.2 --variant=medium

# Legacy OpenCode (v1.0.209 and below)
opencode run "write hello world to test.txt" --model=openai/gpt-5.2-medium

Install from source (optional)

git clone https://github.com/ndycode/opencode-openai-codex-auth-multi.git
cd opencode-openai-codex-auth-multi
npm ci
npm run build

Point OpenCode at the local build output (replace with your absolute path):

{
  "plugin": ["file:///absolute/path/to/opencode-openai-codex-auth-multi/dist"]
}

📦 Models

• gpt-5.2 (none/low/medium/high/xhigh)
• gpt-5.2-codex (low/medium/high/xhigh)
• gpt-5.1-codex-max (low/medium/high/xhigh)
• gpt-5.1-codex (low/medium/high)
• gpt-5.1-codex-mini (medium/high)
• gpt-5.1 (none/low/medium/high)

🧩 Configuration

• Modern (OpenCode v1.0.210+): config/opencode-modern.json
• Legacy (OpenCode v1.0.209 and below): config/opencode-legacy.json

Minimal configs are not recommended for GPT–5.x/Codex; use the full configs above. For advanced/debug use only, see config/minimal-opencode.json.

Multi-account

• Add multiple accounts by running opencode auth login and choosing add more accounts.
• Auto-rotation kicks in on rate limits.
• Manage accounts with openai-accounts, openai-accounts-switch, and openai-accounts-status.
• Storage: ~/.opencode/openai-codex-accounts.json

✅ Features

• ChatGPT Plus/Pro OAuth authentication (official flow)
• 22 model presets across GPT–5.2 / GPT–5.2 Codex / GPT–5.1 families
• Variant system support (v1.0.210+) + legacy presets
• Multimodal input enabled for all models
• Usage–aware errors + automatic token refresh

📚 Docs

• Getting Started: docs/getting-started.md
• Configuration: docs/configuration.md
• Troubleshooting: docs/troubleshooting.md
• Architecture: docs/development/ARCHITECTURE.md

⚠️ Usage Notice

This plugin is for personal development use with your own ChatGPT Plus/Pro subscription. For production or multi‑user applications, use the OpenAI Platform API.

Built for developers who value simplicity.