CC Switch 配置 Codex 不生效怎么办

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/v1

https://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_MODEL

Windows 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_PROXY=http://127.0.0.1:7890 export HTTPS_PROXY=http://127.0.0.1:7890

PowerShell 示例：

$env:HTTP_PROXY="http://127.0.0.1:7890" $env:HTTPS_PROXY="http://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 路径、模型名或当前终端没有加载新配置导致的。按这个顺序查，通常能很快定位到具体环节。