Skip to main content
Codex CLI 是 OpenAI 官方的命令行编码助手，类似 Claude Code。它通过 OpenAI Responses API 和模型通信，所以只要在 ~/.codex/config.toml 里加一个 provider，就能切到 RuAPI。
在 Codex 里能用的是 GPT 模型：gpt-5.4、gpt-5.5、gpt-5.6 系列、gpt-6-astra。Codex 只发 Responses API 格式的请求，而 RuAPI 上 GPT 模型支持这种格式。用 Claude 请看 Claude Code，用 DeepSeek 请看 Claude Code 接 DeepSeek。

​
前置条件

1

RuAPI 账号 + API key

控制台 → 令牌管理 → 添加令牌。详见 API key 与安全。
2

装好 Node.js 和 npm

没装的话去 nodejs.org 下载。

​
安装 Codex CLI

确认：

​
配置 RuAPI

编辑 ~/.codex/config.toml（Windows 是 %USERPROFILE%\.codex\config.toml），不存在就新建：
然后把 key 设成环境变量（或写进 ~/.zshrc / ~/.bashrc）：
base_url 末尾必须带 /v1，这点和 Anthropic 不同。wire_api 必须是 "responses"："chat" 这个选项 2026 年 2 月起已从 Codex 删除，写成 "chat" 的话 Codex 会直接启动失败。

​
第一次验证

交互界面里：
正常回复 + RuAPI 控制台 → 使用日志 里出现对应记录 = 成功。

​
切换模型

会话内：
或者直接改 config.toml 开头的 model = "..."。价格页面上的 GPT 模型都可以用。

​
常见问题

  • RUAPI_API_KEY 应该是 RuAPI 令牌（sk-...），不是 OpenAI 官方的 sk-proj-...。
  • 这个变量要在运行 codex 的那个终端里生效（把 export 写进 ~/.zshrc 后，新开一个终端）。
  • 在控制台 → 令牌管理 确认 key 没被禁用，当前模型也没被这把 key 的「模型限制列表」排除（如果设置了的话）。
  • 模型 ID 拼错。GPT 模型在 RuAPI 上的命名和 OpenAI 官方一致，准确名字从价格页复制。
  • base_url 末尾要带 /v1。
这是旧版配置。把 config.toml 里的 wire_api = "chat" 改成 wire_api = "responses"。
这是正常的：Codex 只走 Responses API，而 RuAPI 上支持它的是 GPT 模型。用 Claude 和 DeepSeek 请改用 Claude Code，那里所有模型都能用。
RuAPI 原样转发工具调用。如果 Codex 报错，先拿同样的提示词直接调 OpenAI 试试，排除是提示词本身的问题。
最方便的是用 CC Switch 切换。手动的话，改 config.toml 开头的 model_provider 即可。

​
进阶：和 Claude Code 一起用

很多人同时用 Codex（GPT 模型擅长的任务）和 Claude Code（长上下文、读代码）。两者互不干扰：按 Claude Code 和本页分别配置即可，同一把 RuAPI key 两边都能用。