opencode-openai-codex-auth
v4.4.0
Published
OpenAI ChatGPT (Codex backend) OAuth auth plugin for opencode - use your ChatGPT Plus/Pro subscription instead of API credits
Maintainers
Readme
Curated by Numman Ali
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
npx -y opencode-openai-codex-auth@latestThen:
opencode auth login
opencode run "write hello world to test.txt" --model=openai/gpt-5.2 --variant=mediumLegacy OpenCode (v1.0.209 and below):
npx -y opencode-openai-codex-auth@latest --legacy
opencode run "write hello world to test.txt" --model=openai/gpt-5.2-mediumUninstall:
npx -y opencode-openai-codex-auth@latest --uninstall
npx -y opencode-openai-codex-auth@latest --uninstall --all📦 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 supported for GPT‑5.x; use the full configs above.
✅ 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.
