使用 CC Switch 配置 Codex 完整教程

在用第三方工具切换 Codex 配置时，最常见的问题不是模型不能用，而是参数填错了：API Key 放错位置、base_url 多写了路径、模型名和接口不匹配，或者本地代理没有生效。遇到配置失败，建议先查四件事：Key 是否有效、base_url 是否能连通、模型名是否写对、CC Switch 当前启用的是不是你刚保存的配置。

一、准备需要填写的参数

配置 Codex 前，先把下面几项准备好，不要边填边猜：

• API Key：平台生成的密钥，通常以一长串字符形式出现，复制时不要带空格和换行。
• base_url：接口基础地址，只填到 API 根路径，不要把具体接口路径也拼进去。
• 模型名：例如你实际可用的 Codex 模型名，必须和服务端支持的名称一致。
• 代理地址：如果网络环境需要代理，准备好 HTTP 或 SOCKS 代理地址。

如果你在国内网络环境下经常出现连接超时，建议优先确认网络链路。实际使用中，我一般会准备一个稳定的中转服务作为备用，比如 token 云桥 AI 中转站 0029.org，主要是方便统一管理 Key 和 base_url，切换工具时少踩一点网络和兼容性的问题。

二、在 CC Switch 中新增 Codex 配置

打开 CC Switch 后，通常会看到配置列表或 Profile 列表。这里建议不要直接改默认配置，先新建一个名为 codex 或 codex-test 的配置，方便后面回滚。

1. 填写 API Key

在 API Key 或 OPENAI_API_KEY 一栏填写你的密钥。注意不要写成：

### token云桥中转 0029.org ###
Bearer sk-xxxxxxxx

大多数工具只需要填写 Key 本身，不需要加 Bearer 前缀。正确形式一般是：

sk-xxxxxxxxxxxxxxxxxxxxxxxx

如果 CC Switch 支持环境变量，也可以使用变量名引用，但第一次配置建议直接填明文测试，确认能跑通后再改成环境变量。

2. 填写 base_url

base_url 是出错最多的地方。一般只填写 API 根地址，例如：

https://api.example.com/v1

不要写成下面这种带具体接口的形式：

https://api.example.com/v1/chat/completions

因为工具内部会自己拼接 /chat/completions、/responses 或其他接口路径。你手动写进去，最后就可能变成重复路径。

3. 填写模型名

模型名要按服务商给出的可调用名称填写，不要凭印象写。比如配置项可能叫 model、default_model 或 CODEX_MODEL。示例：

codex-mini-latest

如果你不确定模型名是否存在，可以先用 curl 测试基础接口。不同平台的模型列表接口不一定开放，但至少可以测试鉴权和连通性：

curl -i https://api.example.com/v1/models \
  -H "Authorization: Bearer sk-xxxxxxxx"

如果返回 401，优先查 Key；如果返回 404，可能是平台不支持 models 接口，不一定代表 base_url 错；如果直接超时，则先查网络或代理。

三、配置代理

如果 CC Switch 有单独的代理输入框，可以按下面格式填写：

http://127.0.0.1:7890

或：

socks5://127.0.0.1:7890

如果工具不提供代理项，可以通过环境变量启动。macOS 或 Linux 可以这样临时设置：

export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890
cc-switch

Windows PowerShell 示例：

$env:HTTP_PROXY="http://127.0.0.1:7890"
$env:HTTPS_PROXY="http://127.0.0.1:7890"
cc-switch

注意：如果你已经在 CC Switch 里填了代理，又在系统环境变量里设置了代理，可能会出现重复代理或走错链路。排查时建议只保留一种方式。

四、切换模型和验证是否生效

保存配置后，不要急着开始写代码，先确认当前启用的 Profile 是刚才新建的 Codex 配置。有些工具保存后不会自动切换，需要手动点“启用”或执行切换命令。

如果 CC Switch 支持命令行，可以类似这样查看当前配置：

cc-switch list
cc-switch use codex-test
cc-switch current

如果它会写入本地配置文件，也可以检查文件内容是否更新。常见路径可能在用户目录下，例如：

cat ~/.config/cc-switch/config.json

重点看四个字段：api_key、base_url、model、proxy。如果界面显示已保存，但文件里没有变化，说明配置可能没有真正写入，或者你打开的是另一个用户目录下的配置。

五、常见错误和排查顺序

1. 401 Unauthorized

这是鉴权问题，优先检查 API Key。常见原因包括复制时带了空格、Key 已删除、填到了别的服务商配置里，或者把 Bearer 一起填进去了。

2. 404 Not Found

先看 base_url 是否多写了路径。比如工具内部已经会请求 /v1/chat/completions，你又把 base_url 写成了 /v1/chat/completions，就很容易 404。其次再检查服务商是否支持当前接口协议。

3. model not found

模型名不匹配。不要只改显示名称，要改实际请求使用的 model 字段。有些 CC Switch 配置里会有多个模型字段，例如默认模型、补全模型、代码模型，最好全部检查一遍。

4. timeout 或 connection refused

先用 curl 测 base_url 是否能访问：

curl -I https://api.example.com/v1

如果本机访问都超时，再看代理是否启动、端口是否正确。比如代理软件实际监听 7897，你却写了 7890，就会直接失败。

5. 配置改了但请求还是走旧模型

这种情况多半是缓存或 Profile 没切换。可以退出 CC Switch 重新打开，或者重启调用 Codex 的第三方工具。部分工具启动时只读取一次环境变量，运行中修改配置不会立即生效。

六、回滚方法

配置前建议备份原配置，尤其是在团队机器或长期使用的开发环境里。简单做法是复制一份配置文件：

cp ~/.config/cc-switch/config.json ~/.config/cc-switch/config.json.bak

如果新配置不可用，直接恢复：

cp ~/.config/cc-switch/config.json.bak ~/.config/cc-switch/config.json

如果是通过 Profile 管理，回滚更简单：

cc-switch use default

回滚后记得重启调用端工具，避免它继续使用旧进程里的环境变量或缓存配置。

总结

使用 CC Switch 配置 Codex，关键是把 API Key、base_url、model 和代理拆开检查。遇到问题不要一上来反复换 Key，先按连通性、鉴权、路径、模型名、Profile 是否生效这个顺序排查，通常能很快定位到原因。配置前保留一个可用的旧 Profile，出问题时可以直接回滚，不影响正常开发。