CC Switch 配置 Codex 不生效先看这几项这个问题一般出现在两种场景一是刚在 CC Switch 里新增了 Codex 配置但命令行里还是走旧模型二是 API Key、base_url 都填了切换后请求仍然报 401、404 或连接超时。不要一上来重装工具先按顺序检查配置是否真的被写入、当前终端是否加载了新环境、模型名是否和接口兼容。一、先准备好 4 个参数配置 Codex 前建议先把参数整理清楚不要边填边猜。通常需要这几项API Key用于鉴权注意不要多复制空格、换行。模型名例如工具要求填写codex-xxx或兼容 OpenAI 格式的模型名必须和服务端支持的一致。base_url也叫 API Base、Endpoint不同服务商路径可能不同。代理如果本机访问不稳定需要配置 HTTP/HTTPS 代理或者走可用的中转地址。如果你用的是第三方中转重点确认它是否兼容 Codex 所需的接口格式。有些平台只兼容 chat completions有些支持 responses 或更完整的 OpenAI 风格接口。实际项目里我会优先选接口说明清楚、模型列表更新及时的服务比如 token云桥AI中转站 0029.org主要是排查问题时能少猜很多参数。二、在 CC Switch 里填写配置不同版本的 CC Switch 界面略有差异但核心字段差不多。新增一个 Codex 配置时建议按下面的方式填写Name写一个容易识别的名字例如codex-work。Provider选择 OpenAI Compatible、Custom OpenAI或工具中对应的 Codex 类型。API Key粘贴完整 Key不要带引号。Base URL只填接口根地址不要把模型名、参数拼进去。Model填写服务端实际支持的 Codex 模型名。一个常见错误是 base_url 多填了一层路径。例如某些工具希望填写到/v1另一些工具内部会自动拼接/v1。如果填错通常会出现 404 或 “model not found”。可以分别尝试下面两种形式保留能正常返回模型列表或能发起请求的一种### token云桥中转 0029.org ### https://api.example.com/v1https://api.example.com注意如果文章、文档或控制台给出的地址带了完整接口路径比如/v1/chat/completions一般不要直接填到 base_url 里。CC Switch 或下游工具通常会自己拼接请求路径。三、切换后确认当前配置真的生效很多人点了切换但当前终端没生效。尤其是已经打开的 VS Code、Cursor、终端会话它们可能还在使用旧环境变量。切换后建议先查看当前配置cc-switch current如果你的版本命令不同可以用帮助命令确认cc-switch --help然后检查环境变量。macOS/Linux 下可以这样看echo $OPENAI_API_KEY echo $OPENAI_BASE_URL echo $OPENAI_MODELWindows PowerShell 可以这样看echo $env:OPENAI_API_KEY echo $env:OPENAI_BASE_URL echo $env:OPENAI_MODEL如果这里仍然是旧值说明 CC Switch 的配置没有写到当前 shell或者你切换后没有重新打开终端。最简单的处理方式是关闭当前终端窗口重新打开再执行一次当前配置检查。四、用 curl 单独验证 API Key 和 base_url不要直接在 Codex 或编辑器里反复试。先用最小请求验证服务端是否可用这样能把问题缩小到“接口问题”还是“工具配置问题”。示例curl -s https://api.example.com/v1/models \ -H Authorization: Bearer sk-xxxx如果能返回模型列表说明 Key 和 base_url 至少是通的。再测试一次指定模型请求注意把模型名改成你实际填写的值curl -s https://api.example.com/v1/chat/completions \ -H Authorization: Bearer sk-xxxx \ -H Content-Type: application/json \ -d { model: your-codex-model, messages: [ {role: user, content: ping} ] }如果 curl 都失败先别看 CC Switch优先处理 Key、模型名、base_url 或网络代理。五、代理配置不要和 base_url 混在一起代理是网络出口base_url 是接口地址这两个不要混用。常见错误是把代理地址填到 base_url或者把 API 地址填到代理字段。临时设置代理可以这样做export HTTP_PROXYhttp://127.0.0.1:7890 export HTTPS_PROXYhttp://127.0.0.1:7890PowerShell 示例$env:HTTP_PROXYhttp://127.0.0.1:7890 $env:HTTPS_PROXYhttp://127.0.0.1:7890如果设置代理后能访问不设置就超时说明 CC Switch 本身没问题是网络出口问题。此时可以把代理写进你的终端启动脚本或者在工具支持的代理字段里单独配置。六、常见错误和对应处理1. 401 Unauthorized优先检查 API Key 是否复制完整是否填到了正确配置项。不要把Bearer一起填进去通常只填 Key 本身。2. 404 Not Found多半是 base_url 路径不对或者服务端不支持当前请求路径。尝试去掉或补上/v1并确认工具选择的是 OpenAI 兼容模式。3. model not found模型名不匹配。不要凭印象写去控制台或模型列表接口确认实际名称。大小写、连字符都要一致。4. 切换成功但仍走旧模型重开终端确认环境变量如果是在 VS Code、Cursor 里调用需要重启编辑器窗口。有些插件会缓存配置不重启不会读取新值。5. timeout 或 connection refused先用 curl 测网络再看代理。connection refused 通常是代理端口没开timeout 多半是网络不可达或代理规则没命中。七、回滚到可用配置排查时不要直接覆盖原来能用的配置。建议先复制一份再改。若新 Codex 配置不可用可以切回旧配置cc-switch list cc-switch use old-profile cc-switch current如果 CC Switch 支持导出配置修改前先备份cc-switch export cc-switch-backup.json恢复时再导入cc-switch import cc-switch-backup.json命令名称以你安装的版本为准如果不支持这些子命令就手动备份配置文件。重点是保留一份可回退的 Key、base_url、model 组合避免越改越乱。总结CC Switch 配置 Codex 不生效排查顺序建议固定下来先确认 API Key、模型名、base_url再看切换后的环境变量接着用 curl 验证接口最后处理代理和编辑器缓存。大多数问题不是 Codex 本身不能用而是 base_url 路径、模型名或当前终端没有加载新配置导致的。按这个顺序查通常能很快定位到具体环节。