使用 CC Switch 切换多个 API Key

如果你需要在个人、工作或测试 API Key 之间频繁切换，可以让 CC Switch 管理多组供应商配置，避免反复修改环境变量和配置文件。

本文使用的工具

本文介绍的是开源桌面工具 CC Switch。截至 2026-07-15，最新正式版为 v3.17.0。PyPI 上另有一个名为 ccswitcher 的旧 CLI，它只切换 Claude Code 配置文件，不支持本文的 Codex 场景。

安装 CC Switch

• Windows：从 GitHub Releases 下载最新的 Windows MSI 安装包；也可以下载 Portable ZIP 解压后直接运行。
• macOS：使用 Homebrew 安装，或从 Releases 下载最新 DMG。CC Switch 同时支持 Intel 与 Apple Silicon。

macOS复制

brew install --cask cc-switch

已经通过 Homebrew 安装时，可使用以下命令更新：

macOS复制

brew upgrade --cask cc-switch

只从官方渠道下载

CC Switch 是免费开源软件。请只使用 CC Switch 官网 或 GitHub 官方仓库，不要向第三方站点提交悠然 AI API Key。

配置前准备

1. 在访问密钥页面为每个使用场景创建独立 API Key，例如“个人电脑”“工作电脑”或“临时测试”。
2. 使用其中一把 Key 查询当前可用的模型 ID：

Shell复制

curl -sS https://youran-ai.du-fu.com/api/models \
  -H "Authorization: Bearer <YOURAN_API_KEY>"

3. 从返回的 data[].id 中选择模型，不要照抄旧文档或其他供应商的模型名称。

模型需要手动填写

CC Switch 官方说明中的“获取模型”会按 OpenAI 兼容的 /v1/models 规则请求。悠然 AI 的模型列表固定为 /api/models；如果按钮返回 404，直接使用上面的命令查询并手动填写模型 ID，不要修改悠然 AI Base URL。

配置 Claude Code

1. 打开 CC Switch，切换到 Claude Code。
2. 点击右上角 +，选择“应用专属供应商”和 Custom。
3. 名称填写容易识别的用途，例如“悠然 AI · 工作 Key”。
4. 在高级 JSON 配置中写入以下内容，将 Key 与模型占位符替换为真实值：

JSON复制

{
"env": {
  "ANTHROPIC_BASE_URL": "https://youran-ai.du-fu.com/api",
  "ANTHROPIC_AUTH_TOKEN": "<YOURAN_API_KEY>",
  "ANTHROPIC_MODEL": "<MODEL_ID>",
  "ANTHROPIC_DEFAULT_OPUS_MODEL": "<MODEL_ID>",
  "ANTHROPIC_DEFAULT_SONNET_MODEL": "<MODEL_ID>",
  "ANTHROPIC_DEFAULT_HAIKU_MODEL": "<MODEL_ID>",
  "CLAUDE_CODE_SUBAGENT_MODEL": "<MODEL_ID>"
}
}

5. API 格式保持 Anthropic Messages，关闭“需要本地路由”和“完整 URL 模式”。悠然 AI 已原生提供 CC Switch 所需的 Messages 路径，不需要协议转换。
6. 保存后点击供应商卡片上的“启用”。为其他 API Key 复制一张卡片，只修改名称和 ANTHROPIC_AUTH_TOKEN。

使用 Bearer Token

悠然 AI 使用 Authorization: Bearer 鉴权，因此这里必须填写 ANTHROPIC_AUTH_TOKEN，不要同时保留 ANTHROPIC_API_KEY。两种认证变量同时存在时，Claude Code 可能报告认证冲突。

配置 Codex

1. 切换到 CC Switch 的 Codex 页面，点击右上角 +，选择“应用专属供应商”和 Custom。
2. 按下表填写供应商表单：

字段	填写内容
名称	悠然 AI · 工作 Key 等可识别名称
API Key	当前悠然 AI API Key
Endpoint URL	https://youran-ai.du-fu.com/api
Model	从 /api/models 获取的真实模型 ID
API / Wire Format	responses
Requires OpenAI Auth	开启
Needs Local Routing	关闭
Full URL Mode	关闭

CC Switch 写入的 Codex 配置应与下面的结构等价；供应商内部 ID 可能由 CC Switch 自动生成，无须手工修改文件：

TOML复制

model = "<MODEL_ID>"
model_provider = "youran"

[model_providers.youran]
name = "悠然 AI"
base_url = "https://youran-ai.du-fu.com/api"
wire_api = "responses"
requires_openai_auth = true

保存并启用后，为其他 API Key 复制供应商卡片并替换 Key。Codex 会在启动时读取配置，因此每次切换后应关闭当前 Codex 终端，再打开新终端启动 Codex。

需要保留官方 Codex 登录时

如果还要在悠然 AI 与 ChatGPT 官方登录之间切换，可在“设置 → Codex 应用增强”中启用保留官方认证。CC Switch 会把第三方 Key 放入供应商级配置，避免直接覆盖官方登录状态。

日常切换

1. 在 CC Switch 主界面找到目标供应商卡片，点击“启用”；也可以从系统托盘的 Claude 或 Codex 子菜单直接切换。
2. Claude Code 通常会热加载新配置；Codex 需要重新打开终端。
3. 发起一次简短请求，然后在请求记录中确认使用的模型、Key 和 Token 统计。
4. CC Switch v3.17.0 还支持“项目”快照。如果不同工作目录需要固定的供应商、MCP 和 Skills 组合，可以分别保存为“个人”和“工作”项目后整体切换。

避免配置冲突

• 使用 CC Switch 后，不要再同时手工编辑同一份 ~/.claude/settings.json、~/.codex/auth.json 或 ~/.codex/config.toml。
• 如果此前按照手动指南把 Claude 变量写入系统环境或 ~/.zshrc，请先移除这些固定值，再由 CC Switch 管理，否则旧环境变量可能覆盖刚切换的供应商。
• 第一次使用前建议备份现有 Claude Code 与 Codex 用户配置。
• API Key 只保存在个人设备的用户配置中，不要写入项目目录或提交到 Git。

完整的供应商添加与切换行为以 CC Switch 官方用户手册为准。