Codex

OpenAI 的命令行编码 Agent。接入 TokenRoute 有两种方式，任选其一。

方式	适合
CC-Switch 图形配置	不想碰配置文件，想在多家服务商间快速切换
手写 config.toml	想精确控制模型和参数，或在 Linux/服务器上用

Codex 只走 Responses API

Codex 的自定义 Provider wire_api 仅支持 responses，不能改成 chat_completions。

因此所选模型必须实际支持 /v1/responses。不能因为某模型的 /v1/chat/completions 能用，就认为它能在 Codex 里用——不支持的模型会返回 not implemented。

装 Codex CLI

系统	命令
Windows	irm https://chatgpt.com/codex/install.ps1 | iex（PowerShell，无需管理员权限）
macOS	curl -fsSL https://chatgpt.com/codex/install.sh | sh，或 brew install --cask codex
Linux	curl -fsSL https://chatgpt.com/codex/install.sh | sh

装了 Node.js 的话，三个系统都可以用 npm install -g @openai/codex。

装完验证：

codex --version

方式一：CC-Switch（图形界面）

从 sourceforge.net/projects/cc-switch.mirror 下载安装并运行。

1. 点顶部导航栏中间的 OpenAI

2. 点右上角 + 添加

3. 填写：

   字段	填什么
   供应商名称	TokenRoute（可自定义）
   官网链接	https://www.tokenroute.com/
   API Key	你的 API Key
   API 请求地址	https://api.smartwan.com/v1

4. 点 保存

然后运行 codex 发一条测试消息，能回复即成功。

方式二：手写 config.toml

自定义 Provider 必须写在用户级 ~/.codex/config.toml。项目级的 .codex/config.toml 不支持定义 model_provider 和 model_providers。

1. 设环境变量

env_key 填的是环境变量名，不是密钥本身——密钥不要写进配置文件。

系统	命令
Windows (PowerShell)	$env:TOKENROUTE_API_KEY = "sk-你的Token"
macOS / Linux	export TOKENROUTE_API_KEY="sk-你的Token"

上面只对当前会话生效。长期使用：Windows 走「用户环境变量」设置，macOS/Linux 写进 ~/.zshrc 或 ~/.bashrc。

2. 写配置文件

mkdir -p ~/.codex

Windows 用 mkdir %USERPROFILE%\.codex，或按 Win+R 输入 %USERPROFILE%\.codex 打开该目录。

~/.codex/config.toml：

model_provider = "tokenroute"
model = "gpt-5.5"
model_reasoning_effort = "low"

[model_providers.tokenroute]
name = "TokenRoute"
base_url = "https://api.smartwan.com/v1"
env_key = "TOKENROUTE_API_KEY"
wire_api = "responses"

四个容易写错的地方

• wire_api 必须是 "responses"
• env_key 填环境变量名，不是密钥
• model 和 model_reasoning_effort 必须在顶层，不能塞进 [model_providers.tokenroute] 里面
• 文件里若有重复的 notify = [...]，只留一行

Windows 上注意文件后缀必须是 .toml 不是 .txt——看不到后缀就在资源管理器「查看」里勾选「文件扩展名」。

3. 重启并验证

改完配置要完全退出 Codex 再打开（托盘图标右键退出，或任务管理器结束进程）。

codex --version
codex

Windows 桌面端可以跑诊断命令，看到 config loaded 即为成功：

"C:\Users\%USERNAME%\AppData\Local\OpenAI\Codex\bin\<版本号>\codex.exe" doctor

桌面端应用

Codex 也有桌面客户端，微软商店下载。

切中文：File → Settings（Ctrl+,）→ General → Language 选「中文（中国）」。等中文包加载完，右下角托盘图标右键退出再重开生效。没生效就再重启一次。

首次发消息若弹 Unable to send message，点 OK，再点输入框旁的黑色 Set up 按钮完成沙箱配置。

模型在输入框下方的下拉里切换。

遇到问题

现象	处理
找不到 .codex 目录	先打开一次 Codex 客户端让它自动生成，或手动 mkdir
Provider 未找到	顶层 model_provider 的值要和 [model_providers.xxx] 的 ID 完全一致
认证失败	确认环境变量已设置且当前终端可见，Key 以 sk- 开头且未过期
404 或协议不兼容	base_url 要带 /v1；确认该模型支持 /v1/responses
返回 not implemented	该模型不支持 Responses API，换一个
桌面端突然不通	托盘图标右键退出，重新打开

换模型就改 ~/.codex/config.toml 顶层的 model 字段，或在 CC-Switch 里重选。模型名要取自模型列表且确认支持 Responses API。