主题
Codex CLI 使用指南
把 OpenAI Codex CLI 的模型路由到 ooioo。macOS / Linux / Windows 通用。
内测提示
Codex 产品线在等待名单阶段；本页配置同样适用于用 Codex CLI 调用 ooioo 上的其他模型（如 CC 国产模型）。可用模型以控制台「模型广场」为准。
（一）安装 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 = "模型名见控制台模型广场"
model_provider = "ooioo"
[model_providers.ooioo]
name = "ooioo"
base_url = "https://ooioo.work/v1"
env_key = "OOIOO_API_KEY"
wire_api = "responses"然后设置环境变量（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 | 余额不足或超预算拦截，见计费说明 |
启动提示 failed to refresh available models | 无害警告：Codex 拉模型列表期望特殊格式，不影响推理 |
| 模型报不存在 | 模型名与控制台「模型广场」不一致 |
| 连接慢 / 流式中断 | 检查本地网络与代理设置；持续出现请联系我们 |