想省事可以用 CC Switch 一键导入,或者用配置生成器。这一篇讲手动配置。
安装#
npm install -g @openai/codex
codex --version
写入配置#
编辑 ~/.codex/config.toml(Windows 是 %USERPROFILE%\.codex\config.toml,没有就新建),加入下面的内容。
model_provider = "moerouter"
model = "gpt-6.1-sol"
[model_providers.moerouter]
name = "MoeRouter"
base_url = "https://moerouter.com/v1"
wire_api = "responses"
env_key = "MOEROUTER_API_KEY"
requires_openai_auth = false
三个要点:
- 顶层的
model_provider和model必须放在任何[表名]之前。 写到某个表后面,它们会被当成那个表的字段。 model_provider的值要和[model_providers.xxx]里的xxx一致。不要用保留名openai。base_url要带/v1,wire_api必须是responses。
然后在启动 Codex 的同一个终端里提供 Key:
printf 'MoeRouter API Key: '; read -rs MOEROUTER_API_KEY; printf '\n'
export MOEROUTER_API_KEY
codex exec --skip-git-repo-check "只回复 OK,不要运行命令"
$secure = Read-Host "MoeRouter API Key" -AsSecureString
$env:MOEROUTER_API_KEY = [System.Net.NetworkCredential]::new("", $secure).Password
codex exec --skip-git-repo-check "只回复 OK,不要运行命令"

provider: moerouter,返回 OK。交互模式下输入 /status,可以看到当前的 Model provider:

custom,手动配置时是你自己起的名字。让 Key 每次都生效#
- 把
export MOEROUTER_API_KEY=…写进~/.zshrc或~/.bashrc; - 或者在 provider 表里用
experimental_bearer_token = "sk-…"代替env_key。这样 Key 明文存在文件里,记得chmod 600 ~/.codex/config.toml。CC Switch 写入的配置就是这种写法。
选哪个模型#
Codex 走 OpenAI Responses 接口,要选模型广场里端点带 openai-response 的模型。
| 模型 | 适合 | 能接续上一轮的推理内容 |
|---|---|---|
gpt-6.1-sol |
日常编码,价格低 | 能 |
gpt-6-astra |
复杂任务,推理更强 | 能 |
gpt-6.1-terra |
轻量任务 | 不能 |
长会话优先用 gpt-6.1-sol 或 gpt-6-astra。 Codex 从第二轮起,可能把上一轮的加密推理内容一起发回来。这种内容只有原来那家上游能读,所以只有标了“可接续”的线路能处理,目前是上面标“能”的两个模型。
gpt-6.1-terra 在不带推理内容的多轮对话里可以正常使用(实测三轮通过)。一旦请求里带上加密推理内容,会收到 400 和 stateful_request_not_supported,提示里会列出能接续的模型。遇到这种情况,换模型后开一个新会话。
Codex 桌面应用#
Codex 桌面应用读取同一份 ~/.codex/config.toml。
用 env_key 时要注意:从“程序坞”或“开始菜单”启动的桌面应用读不到终端里 export 的变量。这种情况改用 experimental_bearer_token,或者用 CC Switch 管理。改完要完全退出再打开。
桌面应用启动会话时会先尝试 WebSocket 连接。MoeRouter 目前只提供 HTTP 接口,握手时会回复“请改用 HTTP”,Codex 随即自动改走 HTTP,不需要你做任何设置。
恢复#
把顶层的 model_provider、model 改回原值或者删除。原来的 auth.json 不要动。
常见问题#
| 现象 | 原因 | 处理 |
|---|---|---|
| 配置好像没生效 | 顶层字段写到了某个 [表] 后面 |
把 model_provider、model 移到文件最前面 |
| 404,提示模型不能通过这个接口调用 | 模型不支持 Responses 接口 | 换端点带 openai-response 的模型 |
400 stateful_request_not_supported |
请求带着上一轮的加密推理内容,而模型的线路不能接续 | 换 gpt-6.1-sol 或 gpt-6-astra,开新会话 |
| 桌面应用提示没有 Key | 桌面应用读不到终端里的环境变量 | 改用 experimental_bearer_token |
| 401 | Key 不完整,或环境变量名和 env_key 不一致 |
核对变量名 |
更多报错见报错对照表。