MoeRouter 文档 获取 API Key

Codex 接入 MoeRouter

在 ~/.codex/config.toml 里加一个 MoeRouter provider,用 Responses 接口连接。适用于 Codex CLI 和 Codex 桌面应用,附模型选择建议。

更新于 2026-11-15 阅读约 3 分钟 实测:Codex CLI 0.167.0 / 0.169.0 · macOS

本页目录
  1. 安装
  2. 写入配置
  3. 让 Key 每次都生效
  4. 选哪个模型
  5. Codex 桌面应用
  6. 恢复
  7. 常见问题

想省事可以用 CC Switch 一键导入,或者用配置生成器。这一篇讲手动配置。

安装#

npm install -g @openai/codex
codex --version

写入配置#

编辑 ~/.codex/config.toml(Windows 是 %USERPROFILE%\.codex\config.toml,没有就新建),加入下面的内容。

~/.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,不要运行命令"
手动配置后运行 codex exec,provider 是 moerouter
provider: moerouter,返回 OK。

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

Codex 的 /status 输出
用 CC Switch 导入时 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 不一致 核对变量名

更多报错见报错对照表。

↑↓ 选择Enter 打开可以直接粘贴报错原文