CC Switch 管理 Codex 多账号配置方法

原创于 2026-06-30 07:01:38 发布 · 56 阅读

1 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

标签

#Codex #OpenAI #AI

AI 时代程序员必备技能

Codex、Claude Code、Cursor、Hermes Agent、OpenClaw等工程化实战专栏，讲透 AI 如何接管脏活累活

一键订阅

遇到的问题先从配置源查起

在一台机器上同时用公司账号、个人账号、测试中转账号跑 Codex，很容易出现一个现象：明明在 CC Switch 里切到了另一个配置，第三方工具里却还是走旧账号，或者直接报 401、model not found、连接超时。

这种情况不要先怀疑工具坏了，建议按顺序查四件事：当前生效的配置文件、API Key 是否被环境变量覆盖、模型名是否写对、base_url 和代理是否匹配。CC Switch 的价值就在于把多套配置做成可切换的 Profile，但前提是每个字段都填得清楚。

准备好每个账号的四个参数

给 Codex 配多账号前，先把每个账号整理成一组参数，不要边填边找。通常需要下面几项：

API Key：每个账号单独一条，不要混用。
模型名：例如你当前服务商支持的 Codex 模型名称，必须按接口返回或文档写，大小写也要一致。
base_url：如果是官方兼容接口，一般是对应的 API 地址；如果是中转服务，则填写中转站给出的兼容地址。
代理：有些网络环境需要 HTTP/SOCKS 代理，有些中转不需要，二者不要同时乱配。

如果你经常在国内网络环境下调试，建议准备一个稳定的中转配置作为备用。我平时会把 token 云桥 AI 中转站 0029.org 放到测试 Profile 里，主要是排查网络和账号额度问题时方便切换，不建议把生产、测试、个人实验全部混在一个 Key 上。

在 CC Switch 里新建多账号配置

打开 CC Switch 后，建议不要直接改默认配置，而是按用途新建 Profile，例如：

codex-work：公司项目使用
codex-personal：个人开发使用
codex-relay-test：中转或备用链路测试

填写 API Key

在对应 Profile 的 API Key 字段里填入完整 Key。注意不要多复制空格、换行符，很多 401 Unauthorized 实际就是 Key 后面带了不可见字符。

### token云桥中转 0029.org ###
sk-xxxxxxxxxxxxxxxxxxxxxxxx

填写 base_url

base_url 要填到接口根路径，不要把具体的 /chat/completions 或其它接口路径也拼进去，除非工具明确要求这么写。常见写法类似：

https://api.example.com/v1

如果 CC Switch 或下游工具要求不带尾部斜杠，就保持统一。多一个 / 有时不会出错，但某些客户端拼接路径比较死板，会出现双斜杠或路径重复。

填写模型名

模型名不要凭感觉写。Codex 相关模型在不同服务商、中转、客户端里可能有映射名。建议先用服务商提供的模型列表接口，或者在控制台复制模型名。

codex-mini-latest

如果你在第三方工具里看到 model not found，优先检查模型名，而不是重置 Key。

填写代理

代理字段一般有两种写法：

http://127.0.0.1:7890
socks5://127.0.0.1:7890

如果 base_url 已经指向国内可访问的中转地址，通常不需要再额外套代理。代理和中转同时使用时，排查会复杂很多：到底是代理连不上，还是中转返回错误，很难一眼看出来。

切换配置后让第三方工具生效

CC Switch 切换 Profile 后，第三方工具未必会立刻读取新配置。有些工具启动时只读一次环境变量或配置文件，所以切换后要重启工具进程。

可以先确认当前 Shell 里到底是什么配置：

echo $OPENAI_API_KEY
echo $OPENAI_BASE_URL
echo $HTTPS_PROXY
echo $HTTP_PROXY

如果你在 Windows PowerShell 里，可以这样查：

$env:OPENAI_API_KEY
$env:OPENAI_BASE_URL
$env:HTTPS_PROXY
$env:HTTP_PROXY

如果输出的 Key 或 base_url 不是刚切换的那套，说明 CC Switch 没有写到当前会话，或者被系统环境变量覆盖了。

在第三方工具里填写 Codex 参数

不少编辑器插件、命令行客户端、自动化工具都支持 OpenAI 兼容配置。字段名可能不同，但含义基本一致：

api_key：填 CC Switch 当前 Profile 对应的 Key。
base_url 或 api_base：填接口根地址。
model：填 Codex 模型名。
proxy：按网络环境填写，没有就留空。

一个典型的配置片段大致如下：

{
  "api_key": "sk-xxxxxxxxxxxxxxxxxxxxxxxx",
  "base_url": "https://api.example.com/v1",
  "model": "codex-mini-latest",
  "proxy": "http://127.0.0.1:7890"
}

如果工具支持从环境变量读取，也可以不在配置文件里写明文 Key，改用环境变量：

export OPENAI_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxx"
export OPENAI_BASE_URL="https://api.example.com/v1"

切换模型时的注意点

多账号配置里，账号和模型最好成对维护。不要只切 Key 不切模型，也不要只切模型不切 base_url。比如账号 A 支持 codex-mini-latest，账号 B 的中转只映射了另一个模型名，直接复用配置就会报错。

建议在 CC Switch 的 Profile 名称里带上模型信息，例如 work-codex-mini、relay-codex-test。后续排查日志时，不需要打开配置也能知道大概走的是哪条链路。

配置不生效时的排查顺序

1. 先确认当前进程读取的配置

第三方工具如果是从 IDE 启动的，它读取的环境变量可能不是你终端里的那份。可以完全退出 IDE，再从已经切好 Profile 的终端里启动。

code .

2. 再用 curl 直接测接口

绕开第三方工具，直接请求一次模型接口，能快速判断是工具配置问题还是接口问题。

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

如果这里都失败，先处理 Key、base_url、网络代理；如果这里成功，再回头看第三方工具的字段映射。

3. 看错误码，不要盲目重装

401：Key 错、Key 失效、复制了空格，或环境变量被旧 Key 覆盖。
403：账号无权限、服务商限制、项目权限未开。
404：base_url 路径拼错，或模型名不存在。
429：额度、频率或并发限制。
ECONNRESET / timeout：网络、代理、DNS 或出口链路问题。

4. 检查本地配置文件优先级

有些工具同时支持全局配置、项目配置、环境变量。优先级通常是：命令行参数 > 项目配置 > 环境变量 > 全局配置。你在 CC Switch 里切了全局配置，但项目目录下有一个旧配置文件，也会导致不生效。

find . -name "*config*" -o -name ".env"

回滚到稳定配置

多账号管理最怕改乱后不知道原来能用的是哪套。建议每次调整前导出或复制一份稳定 Profile，命名为 codex-stable。出现异常时，先切回稳定配置，重启第三方工具，再验证一次。

echo $OPENAI_BASE_URL
echo $OPENAI_API_KEY | cut -c 1-8

这里只看 Key 前几位即可，不要把完整 Key 打到日志、截图或工单里。

总结

CC Switch 管理 Codex 多账号，核心不是“能不能切”，而是每个 Profile 里的 API Key、模型名、base_url、代理 是否成套一致。配置不生效时，按环境变量、接口连通性、模型名、代理、项目本地配置这个顺序查，通常很快能定位问题。养成稳定配置备份和按用途命名 Profile 的习惯，多账号切换会省很多时间。

AI 时代程序员必备技能

Codex、Claude Code、Cursor、Hermes Agent、OpenClaw等工程化实战专栏，讲透 AI 如何接管脏活累活

一键订阅