跳转到主要内容
Codex CLI 是 OpenAI 官方的命令行编码助手,类似 Claude Code。它通过 OpenAI Responses API 和模型通信,所以只要在 ~/.codex/config.toml 里加一个 provider,就能切到 RuAPI。不需要 ChatGPT 账号,也不用登录 OpenAI。 更新于:2026-11-05 在俄罗斯为什么用 RuAPI 接 Codex 比用 ChatGPT 账号方便、不用境外银行卡怎么付,简要说明见 www.ruapi.ai/codex-v-rossii;下面是具体设置步骤。
在 Codex 里不只能用 GPT 模型(例如 gpt-5.4、gpt-5.5),也能用别家的模型:Claude、DeepSeek、Gemini、Kimi、GLM、Qwen、MiniMax 和 Grok。Codex 发的是 Responses API 格式的请求,RuAPI 会自己转成各家模型认的格式。每一家我们都用 Codex 格式的请求实测过(调用工具、带工具结果的下一步、流式和非流式回复),例如 claude-sonnet-5-5、deepseek-flash、gemini-3.8-flash、kimi-k3.1-pro、glm-5.3、qwen3.8-max、MiniMax-M3.1-Flash、grok-4.7。/model 菜单会自动列出你这把 key 能用的这些模型,GPT 排在最前面。

最快:一条命令

1

打开接入窗口

在 www.ruapi.ai 注册(第一次试用可以先不充值),打开 控制台 → 令牌管理,点 接入 Claude Code、Cline 等工具,选 Codex。
2

复制命令

点 复制命令,你的 key 和 RuAPI 地址会自动填好。命令只能用一次,30 分钟内有效;过期了点 新命令。如果窗口里直接显示的是配置内容,先在窗口上方的 方式 里选 一条命令(推荐)。
3

粘贴到终端

macOS:⌘ + 空格 →「终端」。Linux:Ctrl + Alt + T。Windows:Win + X →「终端」或「Windows PowerShell」(不要用「命令提示符」)。粘贴命令后回车,剩下的脚本会自己做完。
4

等 Codex 自己打开

一般 1–5 分钟。没装 Codex 的话,脚本用 npm 安装(没有 Node.js 也会一起装,装在单独的文件夹,不需要管理员权限),先备份 config.toml,再把 RuAPI 的设置加进去、不动其他内容,检查连接后打开 Codex。以后直接运行 codex(Windows 默认禁止运行 PowerShell 脚本,这时用 codex.cmd;脚本最后会显示该用哪条)。
RuAPI 令牌管理页:地址 https://www.ruapi.ai 和「接入 Claude Code、Cline 等工具」按钮

控制台 → 令牌管理:「接入 Claude Code、Cline 等工具」按钮

出了问题,脚本会打印一行带 [!] 的提示,告诉你怎么办。如果你的 config.toml 写法比较特殊,脚本不会改它,而是告诉你要手动加什么(见下文)。

手动配置

前置条件

1

RuAPI 账号 + API key

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

装好 Node.js 和 npm

没装的话去 nodejs.org 下载。

安装 Codex CLI

确认:
需要 0.161 或更新 的版本:从这一版起,Codex 会自己从 RuAPI 读取模型列表。更新用当初安装的方式:npm install -g @openai/codex@latest 或 brew upgrade codex。

config.toml

打开 ~/.codex/config.toml(Windows 是 %USERPROFILE%\.codex\config.toml;如果设置了 CODEX_HOME 环境变量,就是那个文件夹里的 config.toml)。没有这个文件就新建,整段粘贴进去,把 sk-你的key 换成你的 key:
文件里原来就有内容的话:
  • 开头的 model、model_provider 两行要放在文件最前面、第一个 [ … ] 标题之前;已经有同名的就替换;
  • [model_providers.ruapi] 整段放在文件末尾;已经有这一段就整段替换,留两段同名的 Codex 会打不开。
保存后重新运行 codex。
key 直接写在文件里:别把 config.toml 放进项目目录,也别提交到 git。base_url 必须以 /v1 结尾,wire_api 必须是 "responses":"chat" 已经在 2026 年 2 月从 Codex 里删掉了,写成它 Codex 会启动不了。
model_catalog_url 这一行让 /model 菜单的模型列表自动更新。Codex 0.156–0.160 认识这一行,但不会自己去读列表,菜单是空的:请更新 Codex,或者删掉这一行。更老的版本会直接忽略它。

第一次验证

第一次在新文件夹里启动时,Codex 会问是否信任这个文件夹,按回车即可。然后在交互界面里输入:
正常回复 + RuAPI 控制台 → 使用日志 里出现对应记录 = 成功。

切换模型

在会话里输入 /model,会打开一个菜单,列出你这把 key 能用的模型:先是 GPT,然后是 Claude、DeepSeek、Gemini、Kimi、GLM、Qwen、MiniMax 和 Grok。Codex 启动时从 RuAPI 读取这个列表,我们上新模型后会自动更新。试用余额下,模型旁边会标「✓ 试用可用」或「🔒 充值后解锁」。 也可以手动改 config.toml 开头的 model = "..."。/model 菜单里或 价格页 上的模型都可以用。 省钱选法。 我们这里最便宜的 GPT 是 gpt-6-luna:价格只有 gpt-5.4 的零头。在 config.toml 开头(第一个方括号小节之前),把 model = "..." 这一行改成 model = "gpt-6-luna"。真遇到难题再用 /model 换成 gpt-5.4,做完记得换回 gpt-6-luna:在 /model 里选的模型可能会留到下次启动。

常见问题

  • experimental_bearer_token 里要填完整的 RuAPI key(带 sk-),不是 OpenAI 官方的 sk-proj-...。
  • 在控制台 → 令牌管理 确认 key 是启用状态;如果给 key 设了「可用模型」,要包含你用的模型。
  • 看版本:codex --version,需要 0.161 或更新(0.156–0.160 的情况见上文)。
  • [model_providers.ruapi] 里要有 model_catalog_url 这一行,model_provider = "ruapi" 要在文件开头。
  • 如果给 key 设了「可用模型」,菜单里只会出现其中的模型。
  • 如果选了配置档(config.toml 开头有 profile = ...),配置档里的 model、model_provider 会盖过 RuAPI 的设置。
如果 Codex 是用控制台的那条命令装的,它在一个单独的文件夹里,Codex 自带的更新按钮会把新版装到别处。请这样更新:
  • 模型 ID 打错了。可以在 /model 菜单里选,或者从价格页复制准确的名字。
  • base_url 要以 /v1 结尾。
这是旧版配置。把 config.toml 里的 wire_api = "chat" 改成 wire_api = "responses"。
旧写法 env_key = "RUAPI_API_KEY" 加环境变量照样能用,只是 /model 菜单不会自动更新。想要自动更新,把 [model_providers.ruapi] 整段换成上面的新写法。
  • Codex 自带的联网搜索只有 GPT 模型能用。用别的模型时这个工具不会传给模型;你自己的工具(运行命令、改文件、MCP)所有模型都能用。
  • DeepSeek 在 Codex 里只收文字,看不到请求里的图片。
  • 所有模型都不支持用 previous_response_id 接着上一次的回复,Codex 本来也不用它(见报错说明)。
GPT 模型的工具调用 RuAPI 原样转发;别家模型会转成该模型认的格式。如果 Codex 报错,把报错原文和控制台 → 使用日志 里的请求时间发给客服。
最方便的是用 CC Switch 切换。手动的话,改 config.toml 开头的 model_provider 即可。

进阶:和 Claude Code 一起用

很多人同时用 Codex 和 Claude Code——两边现在能用的模型家族一样,按自己顺手的工具选就行,不用为了某个模型换工具。两者互不干扰:按 Claude Code 和本页分别配置即可,同一把 RuAPI key 两边都能用。