CC-Switch Codex
这一页讲的是通过 CC Switch 管理 Codex 的 Provider。它和 Codex 客户端、Codex CLI 直连配置不是同一件事：这里的重点是先在 CC Switch 中维护服务商，再应用到 Codex。
官方信息 下载和文档以官方站点为准
这一页讲什么
Codex 通常走 OpenAI 或 OpenAI 兼容接口，所以要重点核对 Base URL、Key、模型名三项。Base URL 是否需要带 /v1，以服务商后台展示为准。
开始前确认
| 要确认的事 | 怎么看 | 为什么 |
|---|---|---|
| Codex 能正常打开 | 先确认 Codex CLI 或对应客户端本身能运行 | CC Switch 不替你安装 Codex |
| 服务商支持 OpenAI 兼容接口 | 后台能看到 API 地址、Base URL、OpenAI 兼容等说明 | Codex 需要能请求到兼容接口 |
| 模型可用于 Codex 场景 | 后台模型列表里能看到可用模型名 | 不要把 Claude / Gemini 模型名填到 Codex 里 |
| Key 状态正常 | 后台令牌未过期、未禁用、余额正常 | 401 报错多数先从 Key 查起 |
字段怎么填
| 字段 | 填写方式 | 新手注意 |
|---|---|---|
| Provider 名称 | 写服务商名称或用途 | 例如“主力 OpenAI 兼容中转” |
| 目标工具 / Preset | 选择 Codex 或 OpenAI / Codex 相关预设 | 不要选成 Claude Code 或 Gemini |
| Base URL | 复制服务商后台给出的 API 链接 | 一般是服务商提供的 API 地址；是否带 /v1 按后台示例 |
| API Key | 复制完整 Key | 前后不要多空格，不要复制成备注名 |
| 模型名 | 照抄后台模型列表 | 获取模型列表失败时再手动添加，仍然要照抄后台名称 |
应用到 Codex
- 打开 CC Switch，进入 Provider 管理区域。
- 新增 Provider，或选择已有的 OpenAI 兼容 Provider。
- 目标工具选择 Codex 或 OpenAI / Codex 相关预设。
- 填写 Base URL、API Key、模型名，并保存。
- 执行 Apply / Switch，把这个 Provider 应用到 Codex。
- 关闭当前终端窗口后重新打开，再进行测试。
测试是否生效
先用最短问题测试请求是否能走通。测试成功后，再进入真实项目使用。
Codex 最小测试
codex "请只回复：CC-Switch Codex 已生效"如果返回模型不存在，优先检查模型名；如果返回未授权，优先检查 Key；如果连接超时，优先检查 Base URL 和网络。