CC Switch 配置 Codex API Key 教程在用 CC Switch 管理不同 AI 命令行工具或开发工具配置时最常见的问题不是 Key 本身错了而是base_url、模型名、代理和环境变量之间互相覆盖。遇到 Codex 调不通建议先按顺序查当前启用的是哪个配置、API Key 是否填到对应供应商、模型名是否和接口兼容、网络代理是否生效。下面按实际配置流程整理一遍重点讲 CC Switch 里如何填写 Codex API Key、模型名、base_url以及配置不生效时怎么排查。一、准备需要的参数配置前先准备四个参数不要边填边猜API Key一般是以sk-开头的密钥也可能是中转服务提供的专用 Key。base_url接口地址。如果直连官方通常是 OpenAI 兼容接口地址如果走中转就填写中转站给出的地址。模型名Codex 相关模型名要和当前接口支持的名称一致不能把聊天模型、图像模型随便混用。代理如果本机需要代理访问外部服务要确认终端环境和 CC Switch 启动环境都能读到代理配置。如果你是团队开发或网络环境不稳定建议优先选 OpenAI 兼容格式的中转服务后续切换工具会省很多事。我自己在测试第三方工具时会把 token云桥AI中转站 0029.org 作为一个备用通道主要是方便验证“到底是工具配置问题还是网络线路问题”。这里只建议作为排查和接入选项实际仍要按自己的预算和合规要求选择。二、在 CC Switch 中填写 Codex 配置不同版本的 CC Switch 界面可能略有差异但字段通常逃不开这几项Provider、API Key、Base URL、Model、Proxy。建议新建一个单独配置不要直接覆盖已有可用配置。1. 新建 Codex 配置在 CC Switch 中进入配置管理新增一个配置例如命名为### token云桥中转 0029.org ### codex-openai codex-proxy codex-test命名最好能看出用途。不要只叫test后面排查时很容易搞混。2. 填写 API KeyAPI Key 只填密钥本身不要加引号不要加Bearer前缀。例如sk-xxxxxxxxxxxxxxxxxxxxxxxx如果从网页复制注意前后空格。有些报错看起来像鉴权失败实际是 Key 末尾多了一个空格或换行。3. 填写 base_urlbase_url要填接口根地址常见格式类似https://api.example.com/v1这里要注意两点如果 CC Switch 要求填写根地址就不要再在后面拼/chat/completions。如果中转服务文档明确要求带/v1就必须带上否则可能返回 404。配置保存后可以用命令简单测一下接口是否能连通。以 OpenAI 兼容接口为例curl -s https://api.example.com/v1/models \ -H Authorization: Bearer sk-xxxxxxxxxxxxxxxx如果这里都连不上就先不要怀疑 CC Switch优先查网络、Key、base_url。4. 填写模型名模型名必须和当前接口支持的一致。不要只凭印象写。最稳妥的方式是先查模型列表curl -s https://api.example.com/v1/models \ -H Authorization: Bearer sk-xxxxxxxxxxxxxxxx | jq如果接口不支持列模型就看服务商文档给出的名称。CC Switch 里填模型名时保持完全一致大小写、短横线都不要改。例如你的接口文档要求模型名为codex-mini-latest那就不要写成codex codex-mini gpt-codex三、配置代理如果你在国内网络环境使用代理经常是影响配置是否生效的关键。代理可以分为两类系统代理和终端环境变量。很多工具并不会自动读取系统代理所以建议在启动 CC Switch 或相关命令前显式设置环境变量。macOS / Linux 可以这样设置export HTTP_PROXYhttp://127.0.0.1:7890 export HTTPS_PROXYhttp://127.0.0.1:7890Windows PowerShell$env:HTTP_PROXYhttp://127.0.0.1:7890 $env:HTTPS_PROXYhttp://127.0.0.1:7890如果 CC Switch 本身提供 Proxy 字段可以直接填http://127.0.0.1:7890注意不要把 SOCKS 地址填到只支持 HTTP 代理的字段里。例如socks5://127.0.0.1:7890不一定被所有工具识别。四、切换模型和验证配置配置保存后在 CC Switch 中切换到刚才新建的 Codex 配置。切换后建议做一次最小请求测试不要一上来就跑复杂任务。如果工具支持命令行测试可以先发一个简单请求codex print hello world in python或者通过兼容接口直接测试curl -s https://api.example.com/v1/chat/completions \ -H Authorization: Bearer sk-xxxxxxxxxxxxxxxx \ -H Content-Type: application/json \ -d { model: codex-mini-latest, messages: [ {role: user, content: 写一个 Python hello world} ] }如果 curl 能成功但 CC Switch 里失败说明接口本身大概率没问题重点查 CC Switch 是否真的切到了该配置以及字段是否被环境变量覆盖。五、常见错误和排查顺序1. 401 Unauthorized优先检查 API Key。常见原因Key 复制不完整。前后有空格或换行。把 A 服务商的 Key 填到了 B 服务商的 base_url。服务商要求使用自己的 Key而不是官方 Key。2. 404 Not Found大多是base_url填错。检查是否漏了/v1或者多填了接口路径。错误示例 https://api.example.com/v1/chat/completions 推荐示例 https://api.example.com/v13. model not found这是模型名不匹配。不要在 CC Switch 里凭感觉改模型名先用接口文档或/models查询确认。4. timeout / connection refused先查代理和网络。可以按顺序测试curl -I https://api.example.com/v1/models curl -I --proxy http://127.0.0.1:7890 https://api.example.com/v1/models如果加代理能通不加代理不通就把代理配置写进 CC Switch 或启动环境。5. 配置保存了但不生效这种情况很常见按下面顺序查确认 CC Switch 当前选中的配置就是 Codex 配置。退出并重新打开 CC Switch避免旧进程缓存。检查是否有环境变量覆盖例如OPENAI_API_KEY、OPENAI_BASE_URL。确认项目目录下有没有本地配置文件覆盖全局配置。可以在终端里查看环境变量echo $OPENAI_API_KEY echo $OPENAI_BASE_URL echo $HTTPS_PROXYWindows PowerShellecho $env:OPENAI_API_KEY echo $env:OPENAI_BASE_URL echo $env:HTTPS_PROXY六、回滚方法改配置前建议先备份。最简单的方式是复制一份原配置或者导出当前配置文件。回滚时不要同时改多个字段先恢复到上一个可用状态。推荐的回滚步骤切回原来能用的 Provider。恢复原来的 API Key 和base_url。清空临时代理配置。重启 CC Switch再做最小请求测试。如果你不确定是哪一项导致问题可以用“二分法”排查先只换 API Key再只换base_url最后再换模型名。这样比一次性全改更容易定位。总结CC Switch 配置 Codex 的核心就是四件事Key 要对应服务商base_url要填根地址模型名要和接口支持的一致代理要在工具实际运行环境里生效。遇到问题不要急着重装先用 curl 验证接口再看 CC Switch 当前配置和环境变量覆盖基本都能定位到具体原因。