~/.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;脚本最后会显示该用哪条)。
控制台 → 令牌管理:「接入 Claude Code、Cline 等工具」按钮
[!] 的提示,告诉你怎么办。如果你的 config.toml 写法比较特殊,脚本不会改它,而是告诉你要手动加什么(见下文)。
手动配置
前置条件
1
RuAPI 账号 + API key
控制台 → 令牌管理 → 添加令牌。详见 API key 与安全。
2
装好 Node.js 和 npm
安装 Codex CLI
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。
model_catalog_url 这一行让 /model 菜单的模型列表自动更新。Codex 0.156–0.160 认识这一行,但不会自己去读列表,菜单是空的:请更新 Codex,或者删掉这一行。更老的版本会直接忽略它。第一次验证
切换模型
在会话里输入/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 里选的模型可能会留到下次启动。
常见问题
/model 菜单是空的,或者模型不对
/model 菜单是空的,或者模型不对
- 看版本:
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 里点了更新,版本还是旧的
如果 Codex 是用控制台的那条命令装的,它在一个单独的文件夹里,Codex 自带的更新按钮会把新版装到别处。请这样更新:
- macOS / Linux
- Windows (PowerShell)
找不到模型(503)或 404
找不到模型(503)或 404
- 模型 ID 打错了。可以在
/model菜单里选,或者从价格页复制准确的名字。 base_url要以/v1结尾。
报错:wire_api = 'chat' is no longer supported
报错:wire_api = 'chat' is no longer supported
这是旧版配置。把
config.toml 里的 wire_api = "chat" 改成 wire_api = "responses"。之前按本页旧版用 env_key 配的
之前按本页旧版用 env_key 配的
旧写法
env_key = "RUAPI_API_KEY" 加环境变量照样能用,只是 /model 菜单不会自动更新。想要自动更新,把 [model_providers.ruapi] 整段换成上面的新写法。哪些功能不是所有模型都能用
哪些功能不是所有模型都能用
- Codex 自带的联网搜索只有 GPT 模型能用。用别的模型时这个工具不会传给模型;你自己的工具(运行命令、改文件、MCP)所有模型都能用。
- DeepSeek 在 Codex 里只收文字,看不到请求里的图片。
- 所有模型都不支持用
previous_response_id接着上一次的回复,Codex 本来也不用它(见报错说明)。
工具调用 / Function calling 报错
工具调用 / Function calling 报错
GPT 模型的工具调用 RuAPI 原样转发;别家模型会转成该模型认的格式。如果 Codex 报错,把报错原文和控制台 → 使用日志 里的请求时间发给客服。
想同时保留官方账号和 RuAPI
想同时保留官方账号和 RuAPI
最方便的是用 CC Switch 切换。手动的话,改
config.toml 开头的 model_provider 即可。