Codex
Codex 配置模型供应商
用 CC Switch 把 Flatrouter 接入 Codex CLI，并注意 Responses 协议的模型选择。
推荐使用 CC Switch 完成配置 —— 一款开源的供应商管理工具，可视化操作，无需手动编辑 JSON 或环境变量。
1. 安装 CC Switch
macOS
brew install --cask cc-switch或前往 Releases 下载 .dmg 手动安装。
Windows
前往 Releases 下载 .msi 安装程序。
Linux
# Debian / Ubuntu
sudo dpkg -i CC-Switch-*.deb
# Fedora / RHEL
sudo rpm -i CC-Switch-*.rpm
# AppImage
chmod +x CC-Switch-*.AppImage && ./CC-Switch-*.AppImage支持 macOS 12+、Windows 10+、Ubuntu 22.04+ / Debian 11+ / Fedora 34+。
2. 添加供应商
第 1 步：新增供应商
切换到顶部 Codex 标签页，点击右上角 + 按钮。
第 2 步：填写配置
按下表填写，点击 + 添加 完成。
| 配置项 | 值 | 说明 |
|---|---|---|
| ❶ 供应商名称 | flatrouter-codex | 自定义，方便识别 |
| ❷ 官网链接 | https://flatrouter.com | 供应商官网 |
| ❸ API Key | 你的 Flatrouter API Key | 在 控制台 → API Keys 获取 |
| ❹ 请求地址 | https://api.flatrouter.com/v1 | 末尾不要加斜杠 |
| ❺ API 格式 | OpenAI Compatible | 选择 OpenAI 兼容格式 |
| ❻ 写入通用配置 | ✅ 勾选 | 写入全局配置，所有项目生效 |
CC Switch 会自动写入配置文件，无需手动编辑任何文件。
第 3 步：启用供应商
添加完成后回到列表，选中 flatrouter-codex，点击使用按钮，看到「切换成功」提示即完成。确认 写入通用配置 已勾选，配置会自动写入 config.toml。
3. 验证配置
codex "你好，介绍一下自己"正常返回 AI 响应即表示配置成功。
4. 指定模型
codex --model <model-id> "重构这个函数"注意 Responses 协议
Codex CLI 使用 OpenAI Responses API（wire_api = "responses"），并非所有模型都支持这种格式。选择模型前，请在 Flatrouter 模型列表 确认该模型支持 Responses 协议，否则会报错。
故障排除
Q: 提示 “Authentication error”
确认 API Key 已正确填写，并检查请求地址末尾无斜杠。
Q: 连接超时
确认请求地址为 https://api.flatrouter.com/v1，末尾不带斜杠。