用途：为 OpenCode 提供官方 ChatGPT OAuth 认证，无需 API Key 即可使用 GPT-5.x 与 Codex 模型，直接用现有 ChatGPT Plus/Pro 订阅。
主要能力：支持 GPT-5.2、GPT-5.2-Codex、GPT-5.1、gpt-5.1-codex-max、gpt-5.1-codex、gpt-5.1-codex-mini 等 22 个模型预设；提供 none/low/medium/high/xhigh 变体控制；自动刷新令牌与用量感知错误处理；支持文本、图片、文件等多模态输入；兼容 OpenCode v1.0.209 及以下（旧版）与 v1.0.210+（新版）。
安装：新版用 npx -y opencode-openai-codex-auth@latest；旧版加 --legacy。手动方式为克隆仓库后，将 config/opencode-modern.json 或 config/opencode-legacy.json 复制到 ~/.opencode/config.json。卸载用 --uninstall，加 --all 可同时移除全部配置。
认证与使用：执行 opencode auth login 完成浏览器 OAuth；用 opencode auth status 检查状态，opencode auth refresh 刷新，opencode auth logout 退出。调用方式如 opencode run "write hello world to test.txt" --model=openai/gpt-5.2 --variant=medium；旧版把变体写入模型名，如 --model=openai/gpt-5.2-medium。也支持 opencode chat 交互模式，并可通过 ~/.opencode/config.json 自定义模型预设（provider、model、temperature、maxTokens、topP、capabilities 等）。令牌自动存储于 ~/.opencode/auth/session.json。
适用场景：代码生成、重构、调试、代码审查、项目脚手架、批量文件处理，以及文档与混合内容任务。
限制：依赖有效的 ChatGPT Plus/Pro 订阅，受其用量与配额限制；模型名称区分大小写；需按 OpenCode 版本选择对应配置格式，现代版与旧版语法不通用；令牌属于敏感信息，不应提交至版本库。文中未提供的收费、价格与其他平台支持信息暂未提供。