准备工作
开始前请准备：- ToAPIs API 密钥：前往 ToAPIs 控制台 创建密钥。
-
Codex CLI：按照 Codex 官方文档 安装，或使用以下命令：
- CC Switch：只从 CC Switch 官网 或 官方 GitHub Releases 下载。
在 CC Switch 中添加 ToAPIs
- 打开 CC Switch，在顶部应用切换器中选择 Codex。
- 点击右上角 +，选择 应用专属供应商。
- 在预设中选择 自定义，填写以下内容：
- 点击 添加，然后在 ToAPIs 供应商卡片上点击 启用。
- 关闭正在运行的 Codex 和终端窗口，重新打开终端使配置生效。
ToAPIs 原生支持
POST /v1/responses，因此不要开启“需要本地路由映射”。该开关用于只支持 Chat Completions 的供应商。启动并验证
切换模型
如果账户开放了其他 Responses 模型，可以编辑 ToAPIs 供应商并更换模型。CC Switch 的模型输入框支持通过/v1/models 获取可用列表；也可以前往 ToAPIs 模型一览 查看模型 ID。
常用选择：
模型是否可用取决于账户和渠道配置，请优先以 CC Switch 获取到的
/v1/models 列表为准。
常见问题
启用后仍使用旧供应商
Codex 不会热重载供应商配置。请完全退出 Codex，并重新打开终端后再启动codex。
401 Unauthorized
- 检查 CC Switch 中的 API Key 是否完整
- 在 ToAPIs 控制台 确认密钥有效
- 确认账户余额充足
404 或 Responses 路径错误
确认 Base URL 是 https://toapis.com/v1，API 协议为 Responses，并且“需要本地路由映射”处于关闭状态。
模型不可用
在 CC Switch 中点击模型字段旁的“获取模型”，或调用GET https://toapis.com/v1/models 检查当前密钥可用的模型。
配置文件与密钥安全
CC Switch 会管理~/.codex/auth.json 和 ~/.codex/config.toml。不要把这些文件、API Key 或包含密钥的截图提交到 Git 仓库。
更多 CC Switch 操作说明参阅其 官方用户手册。