CC-Switch

CC-Switch 用于管理 Claude Code、Codex、OpenCode 等客户端的供应商配置和 API Key。

安装说明

1. 访问 Releases 页面，下载适用于 Windows 的安装包（推荐 .msi 格式）。

   

2. 下载完成后，双击安装包。

3. 按照安装向导的提示完成安装。

4. 安装完成后，可以在开始菜单中找到并启动 CC-Switch。

建议使用 Homebrew 进行安装：

brew install --cask cc-switch

安装完成后，可以从“应用程序”或启动台找到并运行 CC-Switch。

1. 前往 发布页面。

2. 选择与系统架构匹配的 AppImage 文件，x86_64 用于普通 Intel / AMD 设备，arm64 用于 ARM 设备。

   

3. 在下载目录中赋予文件可执行权限。将下方的 CC-Switch.AppImage 替换为实际下载的文件名：

   chmod +x ./CC-Switch.AppImage

4. 双击运行文件，或使用同一实际文件名在终端中启动：

   ./CC-Switch.AppImage

   图形界面环境下也可右键点击文件，在属性中启用“作为可执行程序”权限。

添加供应商

安装完成后，按下面的任一方式把 TokenFlux 接入 CC-Switch。

密钥列表里可以直接把 API Key 导入 CC-Switch，不需要手动填写字段。

1. 按 创建 API Key 教程 生成 API Key。

2. 在密钥列表中找到该 Key，点击右侧的“更多”，选择“导入到 CCS”。

   

3. 在“选择客户端”窗口中选择目标客户端和模型，点击“确认”。

4. 浏览器打开 CC-Switch 后，在“确认导入供应商配置”窗口核对供应商名称、API 端点和 API 密钥，点击“导入”。

5. 在侧栏选择对应客户端，找到刚导入的 TokenFlux 供应商并点击“切换”。

6. 向所选模型发送一条消息，并在 使用记录 中确认请求。

TIP

点击后浏览器没有拉起 CC-Switch，并提示“CC-Switch 未安装或协议处理程序未注册”时，先按上方安装说明装好 CC-Switch，再重新点击。

如果控制台的客户端列表中没有目标客户端，或需要自行填写配置，可以在 CC-Switch 中手动添加：

1. 在 CC-Switch 侧栏选择目标应用。
2. 点击右上角的“+”，选择自定义供应商。
3. 填写 名称、API 地址 和 API Key。API 地址按 API 端点 中对应协议的地址填写。
4. 保存后，在供应商卡片上启用或添加该配置，按钮名称以客户端界面为准。

需要让 Claude Code、Codex、Gemini 共用同一份配置时才使用统一供应商；单个客户端用“从控制台导入”标签页即可。

WARNING

统一供应商只覆盖 Claude Code、Codex 和 Gemini，其余客户端（含 OpenCode）不会出现“统一供应商”标签页。

1. 按照 创建 API Key 教程 ，获取一个新的 API Key。

2. 打开 CC-Switch，点击右上角的“+”，切换到“统一供应商”标签页，再点击“添加统一供应商”。

3. 填写字段：

   名称: tokenflux
   API 地址: https://tokenflux.dev
   API Key: TokenFlux API Key

   

4. 勾选要同步的应用（Claude Code / Codex / Gemini）并保存，再到各应用页面启用同步生成的 TokenFlux 供应商。

修改统一供应商会自动同步到所有勾选的应用，删除它也会一并删除这些应用下对应的供应商。

Claude Max 环境变量

若通过 CC-Switch 管理 Claude Code，可以把 ENABLE_PROMPT_CACHING_1H 写进 Claude 供应商的 JSON 配置。CC-Switch 在启用供应商时会把该配置写入 Claude Code 的 settings.json。

该变量用于开启 1 小时 prompt cache，适合重复携带较长上下文的 Claude Code 会话。其他 Claude 分组无需设置。

应用专属供应商

1. 在 CC-Switch 侧栏选择 Claude Code。
2. 找到 TokenFlux 对应的 Claude 供应商卡片，点击“编辑”。
3. 在“配置 JSON”里的 env 中追加：

{
  "env": {
    "ENABLE_PROMPT_CACHING_1H": "1"
  }
}

统一供应商

统一供应商的基础表单只填写 名称、API Key、API 地址 和模型配置，没有单独的环境变量字段。使用统一供应商时：

1. 先按上方“统一供应商”标签页创建并同步统一供应商。
2. 回到 Claude Code 应用下，编辑同步生成的 Claude 供应商。
3. 在该供应商的 JSON env 中追加 "ENABLE_PROMPT_CACHING_1H": "1"。
4. 保存后启用该 Claude 供应商。

相关指南

• Claude Code 使用指南
• Codex 使用指南
• OpenCode 使用指南