opencode-openai-codex-auth

Open source

OAuth authentication plugin for personal coding assistance with ChatGPT Plus/Pro subscriptions - uses OpenAI's official authentication method

2.2K stars0 likes0 views

Website GitHub

About

OAuth authentication plugin for personal coding assistance with ChatGPT Plus/Pro subscriptions - uses OpenAI's official authentication method

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

bash

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

Then:

bash

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):

bash

npx -y opencode-openai-codex-auth@latest --legacy
opencode run "write hello world to test.txt" --model=openai/gpt-5.2-medium

Uninstall:

bash

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.