CC Switch 切换 Codex 模型配置教程

CC Switch 切换 Codex 模型配置教程

在公司网络、个人代理、多个 API 服务商来回切换时，Codex 经常会遇到一个问题：明明在 CC Switch 里改了模型和 Key，终端里调用时还是走旧配置，或者直接报 401、404、连接超时。遇到这种情况不要先怀疑工具坏了，建议按顺序先看三个地方：API Key 是否填对、base_url 是否和服务商匹配、当前终端环境变量有没有覆盖 CC Switch 的配置。

一、先准备好需要填写的参数

切换 Codex 模型前，至少要准备下面几项。不同服务商叫法可能略有差异，但配置逻辑基本一致。

• API Key：通常以一长串字符形式提供，复制时注意不要带空格、换行。
• 模型名：例如 codex-mini-latest、gpt-4.1、服务商提供的 Codex 兼容模型名等，必须和接口支持的名称一致。
• base_url：API 接口地址，常见格式类似 https://api.example.com/v1，末尾是否带 /v1 要看服务商文档。
• 代理地址：如果本机访问接口不稳定，需要填写 HTTP 或 SOCKS 代理，例如 http://127.0.0.1:7890。

如果你经常在不同模型和供应商之间切换，建议单独建一个记录表，把 Key、base_url、模型名、用途写清楚。实测下来，很多配置问题不是工具问题，而是把 A 服务商的模型名填到了 B 服务商的 base_url 下面。

中转服务的选择也要注意稳定性和兼容性。我自己做测试时，如果需要快速验证 Codex 兼容接口，会优先找能直接提供 Key、base_url、模型列表的服务，比如 token云桥AI中转站 0029.org，主要是省去反复猜接口路径和模型名的时间。正式使用前仍建议先用小额度测试连通性和返回格式。

二、在 CC Switch 中填写 Codex 配置

打开 CC Switch 后，一般会有类似“Provider”“Model”“API Key”“Base URL”“Proxy”的配置项。不同版本界面名称可能不完全一样，但含义基本对应。

1. 新建或编辑 Codex 配置

建议不要直接覆盖原来的可用配置，先新建一个配置项，例如命名为 codex-work 或 codex-test。这样出问题时可以快速切回旧配置。

### token云桥中转 0029.org ###
配置名称：codex-test
Provider：OpenAI Compatible
API Key：sk-xxxxxxxxxxxxxxxx
Base URL：https://api.example.com/v1
Model：codex-mini-latest
Proxy：http://127.0.0.1:7890

如果你的服务商明确要求使用 OpenAI 兼容接口，Provider 一般选择 OpenAI Compatible 或类似选项。不要只看模型名里有 Codex 就选择特殊通道，关键看接口协议是否兼容。

2. API Key 填写注意事项

Key 最容易出低级错误。复制后建议先粘贴到临时文本里确认没有多余空格，尤其是从网页后台复制时，末尾可能带换行。CC Switch 保存后如果有“测试连接”按钮，先点一次，不要直接进项目里跑。

# 如果想在终端里快速确认环境变量是否覆盖了配置
echo $OPENAI_API_KEY
echo $OPENAI_BASE_URL

如果这里输出了旧 Key 或旧 base_url，而你的 Codex 工具优先读取环境变量，那么 CC Switch 里的配置可能不会生效。这个问题在 macOS、Linux 和 WSL 里都很常见。

三、切换 Codex 模型

模型切换不要只改模型名，还要确认 base_url 是否支持该模型。比较稳妥的做法是：先在 CC Switch 里切换配置，再开一个新的终端会话测试。

# 查看当前 shell 中可能影响 Codex 的变量
env | grep -E 'OPENAI|CODEX|HTTP_PROXY|HTTPS_PROXY|ALL_PROXY'

如果 CC Switch 提供“Apply”“Set Active”“Use This Profile”之类按钮，保存后还要显式启用当前配置。有些工具只是保存配置，并不会自动切换到当前项。

在项目目录下执行一次简单请求或 Codex 命令，确认实际使用的模型。不同 Codex 工具命令不一样，可以按你本机安装的命令为准：

# 示例：查看工具版本
codex --version

# 示例：执行一次简单任务
codex "请只输出 ok，用于测试当前模型是否可用"

如果返回内容正常，再进行真实代码任务。不要一上来就让它改大项目，配置还没确认时排查成本会很高。

四、代理配置怎么填

代理分两类：一类是 CC Switch 内部代理配置，一类是系统或终端环境变量。两边都配置时，可能出现重复代理或互相覆盖。

# 常见 HTTP 代理
HTTP_PROXY=http://127.0.0.1:7890
HTTPS_PROXY=http://127.0.0.1:7890

# 常见 SOCKS 代理
ALL_PROXY=socks5://127.0.0.1:7890

如果 CC Switch 已经有单独的 Proxy 输入框，通常优先在工具里填，终端环境变量先清掉，避免判断不清实际走哪条链路。

# 临时清理当前终端代理变量
unset HTTP_PROXY
unset HTTPS_PROXY
unset ALL_PROXY
unset http_proxy
unset https_proxy
unset all_proxy

清理后重新打开终端，再通过 CC Switch 启用配置。网络问题排查时，建议一次只改一个变量，不要同时改 Key、模型、base_url 和代理。

五、配置不生效的排查顺序

1. 先查当前启用的是不是目标配置

很多人改完配置忘了切换 Profile。进入 CC Switch，确认当前高亮或标记为 Active 的配置是不是刚才编辑的那一项。必要时切到别的配置再切回来，触发一次写入。

2. 查环境变量是否覆盖

如果终端里设置了 OPENAI_API_KEY、OPENAI_BASE_URL，部分 Codex 客户端会优先读取它们，而不是读取 CC Switch 写入的配置。

echo $OPENAI_API_KEY
echo $OPENAI_BASE_URL
echo $OPENAI_MODEL

发现是旧值时，可以临时取消：

unset OPENAI_API_KEY
unset OPENAI_BASE_URL
unset OPENAI_MODEL

如果这些变量写在 ~/.zshrc、~/.bashrc 或 ~/.profile，需要编辑文件删除或注释，然后重新加载。

source ~/.zshrc
# 或
source ~/.bashrc

3. 查 base_url 路径

404 通常和模型名或接口路径有关。比如服务商要求 /v1，你只填了域名；或者服务商已经在网关里包含了 /v1，你又重复加了一次。

# 正确示例之一
https://api.example.com/v1

# 可能错误：缺少版本路径
https://api.example.com

# 可能错误：重复路径
https://api.example.com/v1/v1

4. 查模型名是否存在

模型名不能凭感觉写。报错里如果出现 model_not_found、invalid_model，优先去服务商后台复制完整模型名。大小写、横线、后缀都要一致。

5. 查 Key 权限和额度

401 多半是 Key 错误或无权限，429 常见于额度、频率限制或并发限制。不要反复重试大请求，先用最小 prompt 测一下。

codex "ping"

六、常见错误对照

• 401 Unauthorized：Key 填错、Key 被禁用、复制时带了空格，或服务商不接受当前鉴权格式。
• 404 Not Found：base_url 路径不对，或模型名不存在。
• 429 Too Many Requests：额度不足、请求频率过高、并发限制触发。
• timeout：网络不通、代理未生效、代理端口写错。
• 配置保存了但没变化：没有启用 Profile，或被环境变量、项目级配置覆盖。

七、回滚到原来的配置

切换前最好保留一份旧配置。CC Switch 如果支持导出配置，可以先导出；不支持的话，至少手动记录旧的 base_url 和模型名。

旧配置名称：codex-stable
Base URL：https://old-api.example.com/v1
Model：old-codex-model
Proxy：http://127.0.0.1:7890

回滚时只做三步：切回旧 Profile、清理终端里临时设置的环境变量、重新打开终端测试。不要在旧配置上继续乱改，否则很难判断是哪一步恢复成功。

总结

CC Switch 切换 Codex 模型时，核心就是四个参数：API Key、模型名、base_url、代理。配置不生效时，按“当前 Profile、环境变量、base_url、模型名、Key 权限、代理网络”的顺序查，基本能定位大部分问题。实际使用中建议保留一个稳定配置，再单独建测试配置做切换，出问题也能快速回滚。