Codex 配置

Codex CLI 按 OpenAI 兼容协议接入 DevRouter。核心是三项：Base URL、API Key、模型名。

1. 前置条件

• 已经在 DevRouter 控制台 创建好对应的 API Key，并确认 Key 已分配到可用分组。
• 账户余额充足，当前分组有可用额度和可用模型权限。
• Node.js 环境已经安装，并且当前终端可以正常执行 node -v 和 npm -v。

2. 安装 CLI 终端

执行下面命令安装 Codex CLI：

npm install -g @openai/codex

安装完成后检查命令是否可用：

codex --version

3. 用 CCS 一键导入配置

CCS（CC Switch）可以理解成一个“CLI 配置管家”。你不用手动去找 Codex 的配置文件，也不用自己复制 Base URL、API Key 和模型名；在 DevRouter 控制台点一次导入，CCS 会把这些信息写进 Codex 的 Provider 配置里。

先安装 CCS：https://www.ccswitch.io/zh/

安装完成后按下面步骤操作：

1. 打开 CCS，确认左侧能看到 Codex。
2. 回到 DevRouter 控制台，进入 API密钥 页面。
3. 找到要用于 Codex 的 API Key，点击上方的 导入到 CCS 按钮。
4. 在弹出的导入窗口中选择 Codex，确认 Provider 名称为 DevRouter，然后导入。
5. 回到 CCS，确认 DevRouter 已切换为当前 Codex Provider。

确认：

• Codex 使用 OpenAI 兼容协议，Base URL 必须包含 /v1。
• API Key 已经分配到可用分组。
• 模型名和 DevRouter 控制台中的 OpenAI 兼容模型名一致。
• 如果 Codex 已经打开，切换 Provider 后重新启动 Codex。

4. 使用 Codex 命令验证

打开终端，输入下面命令启动 Codex：

codex

进入 Codex 后，先发送：

/status

先看 /status 里显示的 Base URL 和模型是否正确：

• Base URL 应该是 https://devrouter.dev/v1。
• 模型名应该是 DevRouter 控制台 模型广场 中可用的 OpenAI 兼容模型名。

如果 Base URL 不正确，先回到 CCS，重新启用 DevRouter Provider，并重新保存一次 Codex 配置。保存后关闭当前 Codex，再重新执行 codex 启动。

如果 Base URL 正确，但模型不正确，在 Codex 里发送：

/model

然后切换到 DevRouter 控制台中已有权限、可调用的 OpenAI 兼容模型。模型切换完成后，可以再次发送 /status 确认。

确认 Base URL 和模型都正确后，再发送一条短消息测试：

你好

如果 Codex 能正常回复，就说明配置已经生效。验证成功后，你应该看到：

• 终端返回一段简短回复。
• DevRouter 控制台出现对应用量记录。
• 用量记录中的模型名和 /status 中确认的模型一致。