CC Switch 配置 Codex 环境变量教程

在第三方工具里接 Codex，最常见的问题不是代码写错，而是环境变量没被当前进程读到。比如在 CC Switch 里切了配置，但终端里运行 Codex 仍然提示 401、model not found、connection error，这时不要急着重装，先查三个东西：API Key 是否生效、模型名是否填对、base_url 是否被工具实际使用。

下面按实际排查顺序整理一遍，适合用 CC Switch 管理 Codex、OpenAI 兼容接口、中转接口，以及本地多套环境切换的场景。

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

Codex 相关配置通常不止一个 Key。比较稳妥的做法是先把参数列出来，再往 CC Switch 里填，避免一边复制一边改错。

• API Key：接口密钥，一般以服务商后台生成的 Key 为准。
• base_url：接口地址，如果是 OpenAI 兼容接口，通常是类似 https://xxx/v1 这种格式。
• model：Codex 使用的模型名，必须和服务商支持的名称完全一致。
• proxy：网络代理，只有在本机网络访问不通时才需要配置。

如果你是团队或多设备使用，建议把这些参数单独记录在密码管理器里，不要直接写进项目仓库。尤其是 .env、config.json 这类文件，很容易被误提交。

如果直连不稳定，或者本来就在用 OpenAI 兼容接口，可以考虑用 token云桥AI中转站 0029.org 这类中转服务。经验上看，配置时重点确认两点：后台给出的 base_url 是否带 /v1，以及模型名是否和后台文档一致，不要凭印象填写。

二、在 CC Switch 里填写 Codex 配置

不同版本的 CC Switch 界面可能略有差异，但核心都是新建一个配置项，然后填入环境变量。可以按下面这个思路来建一个名为 codex 的 Profile。

1. 填写 API Key

常见变量名如下，具体以你使用的 Codex 工具要求为准：

### token云桥中转 0029.org ###
OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxx

如果你的工具明确要求其他变量名，比如 CODEX_API_KEY 或 AI_API_KEY，那就按工具文档来。不要同时乱填多个相似变量，否则后续排查时很难判断到底读取了哪一个。

2. 填写 base_url

OpenAI 兼容接口一般使用：

OPENAI_BASE_URL=https://api.example.com/v1

这里有几个容易踩坑的点：

• 末尾是否需要 /v1，看服务商文档，不要自己猜。
• 不要把网页控制台地址填进去，要填 API 地址。
• 不要把模型地址、聊天地址单独拼进去，例如不要写成 /v1/chat/completions。

3. 填写模型名

模型名可以放到环境变量里，也可以在 Codex 工具自己的配置文件里指定。常见写法类似：

OPENAI_MODEL=codex-mini-latest

如果 CC Switch 支持备注，建议把当前模型的用途写上，例如“代码补全”“代码审查”“轻量任务”。后面切换模型时会清楚很多。

三、切换配置后先验证环境变量

很多人配置完以后直接跑 Codex，报错后才回头查。更推荐先在当前终端里确认变量是否真的生效。

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 的配置没有注入到当前终端。常见原因有：

• 切换 Profile 后没有重新打开终端。
• 只在 GUI 程序里切换了，但命令行进程没有继承到。
• VS Code、Cursor、JetBrains 这类 IDE 是切换前启动的，需要重启。
• 系统变量、Shell 配置、CC Switch 配置之间有覆盖关系。

这里的原则很简单：谁启动 Codex，Codex 就读取谁的环境变量。你在系统里改了变量，但 Codex 是从老终端启动的，它就不一定能读到新值。

四、切换模型时怎么做更稳

不要在一个配置项里频繁改来改去。更推荐在 CC Switch 里建立多个 Profile，例如：

• codex-default：日常代码问答和生成。
• codex-fast：轻量任务，优先速度。
• codex-review：代码审查，使用上下文能力更强的模型。

每个 Profile 单独配置模型名：

OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxx
OPENAI_BASE_URL=https://api.example.com/v1
OPENAI_MODEL=codex-mini-latest

切换后先执行一次环境变量检查，再启动工具。这样即使出现异常，也能快速判断是配置没生效，还是模型本身不可用。

五、代理配置怎么填

如果你的网络环境访问 API 地址不稳定，可以给当前终端加代理。常见变量是：

HTTP_PROXY=http://127.0.0.1:7890
HTTPS_PROXY=http://127.0.0.1:7890

macOS / Linux 也可以临时测试：

export HTTPS_PROXY=http://127.0.0.1:7890
curl -I https://api.example.com/v1

Windows PowerShell 临时设置：

$env:HTTPS_PROXY="http://127.0.0.1:7890"

注意，代理不是越多越好。如果你使用的是国内可访问的中转接口，反而可能因为代理绕路导致超时。排查时建议分两轮：先不走代理测试，再加代理测试，不要同时改 Key、模型和代理。

六、常见错误和排查顺序

1. 401 Unauthorized

优先检查 Key：

• Key 是否复制完整，有没有多空格。
• 当前终端读取到的 Key 是否是新 Key。
• 服务商后台是否启用了该 Key。

echo $OPENAI_API_KEY

2. 404 或 model not found

这种多数是模型名或 base_url 不匹配。检查模型名是否和后台完全一致，包括大小写、横线、后缀。

echo $OPENAI_MODEL
echo $OPENAI_BASE_URL

如果 base_url 写错，把 /v1 漏了或多拼了接口路径，也可能出现类似错误。

3. timeout / connection refused

先测网络，不要直接怀疑 Codex。

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

如果连这个都不通，再检查代理、DNS、防火墙、公司网络限制。Windows 用户还要注意代理软件是否只代理浏览器，不代理命令行。

4. 配置明明改了但不生效

按这个顺序查：

• 关闭并重新打开终端。
• 重启 VS Code、Cursor 或其他调用 Codex 的工具。
• 检查系统环境变量和 CC Switch 是否存在同名变量。
• 检查项目目录下是否有 .env 覆盖了全局配置。
• 确认 Codex 工具是否读取的是配置文件，而不是环境变量。

如果怀疑变量被覆盖，可以在启动 Codex 前打印一次：

echo $OPENAI_BASE_URL
echo $OPENAI_MODEL
codex

七、回滚方法

配置工具最怕越改越乱，所以建议每次修改前保留一份可用配置。CC Switch 里可以复制当前 Profile，命名为 codex-backup 或 codex-stable。

如果已经改乱，可以按下面方式回滚：

• 切回之前能正常使用的 Profile。
• 删除新增的代理变量，只保留 Key、base_url、model。
• 重启终端和 IDE。
• 用最小配置重新测试一次。

OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxx
OPENAI_BASE_URL=https://api.example.com/v1
OPENAI_MODEL=codex-mini-latest

确认最小配置能跑通以后，再逐步加代理、项目级配置、不同模型。不要一次性把所有变量都加上，否则出了问题很难定位。

总结

CC Switch 配置 Codex 的关键不在于填多少变量，而在于确认当前进程到底读到了什么。排查时按 Key、base_url、模型名、代理、进程重启这个顺序来，基本可以覆盖大部分问题。建议把可用配置保存成独立 Profile，后续切模型或换接口时，先复制再修改，出问题也方便快速回滚。