主题
Codex CLI 使用指南
把 OpenAI Codex CLI 的模型路由到 ooioo。macOS / Linux / Windows 通用。
TIP
Codex 套餐在售（购买入口：控制台 → 钱包）。本页默认使用 Codex 模型 gpt-5.6-sol；可用的 Codex 模型以模型广场为准。
（一）安装 Codex CLI
bash
npm install -g @openai/codex需 Node.js ≥ 18。验证：
bash
codex --version（二）接入 ooioo
编辑 ~/.codex/config.toml（Windows 为 C:\Users\你的用户名\.codex\config.toml，没有就新建）：
toml
model = "gpt-5.6-sol"
model_provider = "ooioo"
[model_providers.ooioo]
name = "ooioo"
base_url = "https://ooioo.work/v1"
env_key = "OOIOO_API_KEY"
wire_api = "responses"示例中的 gpt-5.6-sol 是 Codex 模型。使用 Codex 套餐时，保持这一模型类别；完整列表以模型广场为准。
然后设置环境变量（macOS/Linux 写进 ~/.zshrc 或 ~/.bashrc）：
bash
export OOIOO_API_KEY="sk-你的Token"Windows PowerShell：
powershell
setx OOIOO_API_KEY "sk-你的Token"wire_api 选哪个
ooioo 同时支持 OpenAI 的 /v1/responses 与 /v1/chat/completions。wire_api = "responses" 是 Codex 的原生协议，优先用它；个别模型如遇兼容问题，改成 wire_api = "chat" 再试。
（三）开始使用
bash
codex对话能正常返回即接入成功。
只想部分场景走 ooioo？ 用 profile：主配置保持不变，把上面 model / model_provider 两行移到独立 profile 里，需要时 codex --profile ooioo 启用。
常见问题
| 现象 | 原因与处理 |
|---|---|
401 | OOIOO_API_KEY 未生效（重开终端）或 Token 错误 |
402 | 额度不足，或触发 API Key 价格保护；按 error.type 区分，见计费说明 |
启动提示 failed to refresh available models | 无害警告：Codex 拉模型列表期望特殊格式，不影响推理 |
| 模型报不存在 | 模型名与模型广场不一致 |
| 连接慢 / 流式中断 | 检查本地网络与代理设置；持续出现请联系我们 |