在 Codex CLI 中使用 NexRouter

完成下面几步，就可以在 Codex CLI 中使用你的 NexRouter 密钥和模型。

还没安装？先看官方说明，安装好后再回来。

1. 准备三项信息复制锚点链接

• 接入地址：打开本站接入设置，复制本教程要求的地址。
• API 密钥：到密钥管理创建或复制一把密钥。不要填写登录密码。
• 模型 ID：从模型列表复制准确 ID，不要用展示名称代替。

地址和密钥要来自同一个站点：国内密钥配国内地址，海外密钥配海外地址。

2. 在 Codex CLI 中填写配置复制锚点链接

复制下面的示例时，先替换这些内容；不要原样保留 YOUR_...：

合并到 ~/.codex/config.toml；顶层字段放在第一个表之前，不重复定义已有键：

model = "YOUR_MODEL_ID"
model_provider = "nexrouter"
web_search = "disabled"

[model_providers.nexrouter]
name = "NexRouter"
base_url = "YOUR_API_BASE_URL"
wire_api = "responses"
env_key = "NEXROUTER_API_KEY"
requires_openai_auth = false

YOUR_API_BASE_URL 保留 /v1，不要追加 /responses。选择支持 Responses 的模型。

在启动 Codex 的终端设置密钥：

export NEXROUTER_API_KEY='YOUR_API_KEY'
codex

运行 /status，确认模型与提供商。

3. 发一句话试试复制锚点链接

选择刚配置的模型，打开新对话，发送：

你好，请只回复：连接成功

看到正常回复，就完成了第一次连接。 接下来可以开始自己的任务。

如果没有收到回复，先看错误提示：

• 401 / API Key 错误：重新复制完整密钥，确认地址与密钥属于同一站点。
• 404 / 找不到接口：对照上面的地址格式，检查是否多写或漏写了 /v1。
• 找不到模型：重新复制模型 ID，并确认当前密钥有权使用它。

其他问题见常见问题。想先单独检查接口，可以使用首次调用示例。

想了解更多复制锚点链接

安装、完整参数及高级功能请查阅 Codex CLI 官方文档。