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这种格式。modelCodex 使用的模型名必须和服务商支持的名称完全一致。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_KEYsk-xxxxxxxxxxxxxxxx如果你的工具明确要求其他变量名比如CODEX_API_KEY或AI_API_KEY那就按工具文档来。不要同时乱填多个相似变量否则后续排查时很难判断到底读取了哪一个。2. 填写 base_urlOpenAI 兼容接口一般使用OPENAI_BASE_URLhttps://api.example.com/v1这里有几个容易踩坑的点末尾是否需要/v1看服务商文档不要自己猜。不要把网页控制台地址填进去要填 API 地址。不要把模型地址、聊天地址单独拼进去例如不要写成/v1/chat/completions。3. 填写模型名模型名可以放到环境变量里也可以在 Codex 工具自己的配置文件里指定。常见写法类似OPENAI_MODELcodex-mini-latest如果 CC Switch 支持备注建议把当前模型的用途写上例如“代码补全”“代码审查”“轻量任务”。后面切换模型时会清楚很多。三、切换配置后先验证环境变量很多人配置完以后直接跑 Codex报错后才回头查。更推荐先在当前终端里确认变量是否真的生效。macOS / Linuxecho $OPENAI_API_KEY echo $OPENAI_BASE_URL echo $OPENAI_MODELWindows PowerShellecho $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 配置之间有覆盖关系。这里的原则很简单谁启动 CodexCodex 就读取谁的环境变量。你在系统里改了变量但 Codex 是从老终端启动的它就不一定能读到新值。四、切换模型时怎么做更稳不要在一个配置项里频繁改来改去。更推荐在 CC Switch 里建立多个 Profile例如codex-default日常代码问答和生成。codex-fast轻量任务优先速度。codex-review代码审查使用上下文能力更强的模型。每个 Profile 单独配置模型名OPENAI_API_KEYsk-xxxxxxxxxxxxxxxx OPENAI_BASE_URLhttps://api.example.com/v1 OPENAI_MODELcodex-mini-latest切换后先执行一次环境变量检查再启动工具。这样即使出现异常也能快速判断是配置没生效还是模型本身不可用。五、代理配置怎么填如果你的网络环境访问 API 地址不稳定可以给当前终端加代理。常见变量是HTTP_PROXYhttp://127.0.0.1:7890 HTTPS_PROXYhttp://127.0.0.1:7890macOS / Linux 也可以临时测试export HTTPS_PROXYhttp://127.0.0.1:7890 curl -I https://api.example.com/v1Windows PowerShell 临时设置$env:HTTPS_PROXYhttp://127.0.0.1:7890注意代理不是越多越好。如果你使用的是国内可访问的中转接口反而可能因为代理绕路导致超时。排查时建议分两轮先不走代理测试再加代理测试不要同时改 Key、模型和代理。六、常见错误和排查顺序1. 401 Unauthorized优先检查 KeyKey 是否复制完整有没有多空格。当前终端读取到的 Key 是否是新 Key。服务商后台是否启用了该 Key。echo $OPENAI_API_KEY2. 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_KEYsk-xxxxxxxxxxxxxxxx OPENAI_BASE_URLhttps://api.example.com/v1 OPENAI_MODELcodex-mini-latest确认最小配置能跑通以后再逐步加代理、项目级配置、不同模型。不要一次性把所有变量都加上否则出了问题很难定位。总结CC Switch 配置 Codex 的关键不在于填多少变量而在于确认当前进程到底读到了什么。排查时按 Key、base_url、模型名、代理、进程重启这个顺序来基本可以覆盖大部分问题。建议把可用配置保存成独立 Profile后续切模型或换接口时先复制再修改出问题也方便快速回滚。
CC Switch 配置 Codex 环境变量教程
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这种格式。modelCodex 使用的模型名必须和服务商支持的名称完全一致。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_KEYsk-xxxxxxxxxxxxxxxx如果你的工具明确要求其他变量名比如CODEX_API_KEY或AI_API_KEY那就按工具文档来。不要同时乱填多个相似变量否则后续排查时很难判断到底读取了哪一个。2. 填写 base_urlOpenAI 兼容接口一般使用OPENAI_BASE_URLhttps://api.example.com/v1这里有几个容易踩坑的点末尾是否需要/v1看服务商文档不要自己猜。不要把网页控制台地址填进去要填 API 地址。不要把模型地址、聊天地址单独拼进去例如不要写成/v1/chat/completions。3. 填写模型名模型名可以放到环境变量里也可以在 Codex 工具自己的配置文件里指定。常见写法类似OPENAI_MODELcodex-mini-latest如果 CC Switch 支持备注建议把当前模型的用途写上例如“代码补全”“代码审查”“轻量任务”。后面切换模型时会清楚很多。三、切换配置后先验证环境变量很多人配置完以后直接跑 Codex报错后才回头查。更推荐先在当前终端里确认变量是否真的生效。macOS / Linuxecho $OPENAI_API_KEY echo $OPENAI_BASE_URL echo $OPENAI_MODELWindows PowerShellecho $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 配置之间有覆盖关系。这里的原则很简单谁启动 CodexCodex 就读取谁的环境变量。你在系统里改了变量但 Codex 是从老终端启动的它就不一定能读到新值。四、切换模型时怎么做更稳不要在一个配置项里频繁改来改去。更推荐在 CC Switch 里建立多个 Profile例如codex-default日常代码问答和生成。codex-fast轻量任务优先速度。codex-review代码审查使用上下文能力更强的模型。每个 Profile 单独配置模型名OPENAI_API_KEYsk-xxxxxxxxxxxxxxxx OPENAI_BASE_URLhttps://api.example.com/v1 OPENAI_MODELcodex-mini-latest切换后先执行一次环境变量检查再启动工具。这样即使出现异常也能快速判断是配置没生效还是模型本身不可用。五、代理配置怎么填如果你的网络环境访问 API 地址不稳定可以给当前终端加代理。常见变量是HTTP_PROXYhttp://127.0.0.1:7890 HTTPS_PROXYhttp://127.0.0.1:7890macOS / Linux 也可以临时测试export HTTPS_PROXYhttp://127.0.0.1:7890 curl -I https://api.example.com/v1Windows PowerShell 临时设置$env:HTTPS_PROXYhttp://127.0.0.1:7890注意代理不是越多越好。如果你使用的是国内可访问的中转接口反而可能因为代理绕路导致超时。排查时建议分两轮先不走代理测试再加代理测试不要同时改 Key、模型和代理。六、常见错误和排查顺序1. 401 Unauthorized优先检查 KeyKey 是否复制完整有没有多空格。当前终端读取到的 Key 是否是新 Key。服务商后台是否启用了该 Key。echo $OPENAI_API_KEY2. 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_KEYsk-xxxxxxxxxxxxxxxx OPENAI_BASE_URLhttps://api.example.com/v1 OPENAI_MODELcodex-mini-latest确认最小配置能跑通以后再逐步加代理、项目级配置、不同模型。不要一次性把所有变量都加上否则出了问题很难定位。总结CC Switch 配置 Codex 的关键不在于填多少变量而在于确认当前进程到底读到了什么。排查时按 Key、base_url、模型名、代理、进程重启这个顺序来基本可以覆盖大部分问题。建议把可用配置保存成独立 Profile后续切模型或换接口时先复制再修改出问题也方便快速回滚。
