TokenDocs

简体中文

English

简体中文

English

Appearance

CC-Switch ​

CC-Switch 是一款专为管理 AI 接口配置而设计的图形化工具，可统一管理多个 Agent 客户端的供应商配置与 API Key，支持 Claude Code、Codex、OpenCode 等主流 AI 编程助手，降低配置错误风险。

适用场景包括：

  • 统一管理多个 Agent 客户端（如 Claude Code、Codex、OpenCode）的供应商配置与 API Key。
  • 快速切换不同 AI 模型接口，无需手动修改环境变量或本地配置文件。
  • 减少重复配置，提升多客户端场景下的效率与可维护性。

本文将重点介绍安装流程，更多配置详情可参阅相关客户端页面。

安装说明 ​

请根据您所使用的操作系统，参考以下步骤完成安装。

  1. 访问 此处，进入 Releases 页面。 在页面中找到适用于 Windows 的安装包（推荐 .msi 格式），如图所示：

    如何在 Releases 页面选择适合 Windows 的安装包

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

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

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

安装后怎么开始？ ​

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

  2. 打开 CC-Switch，点击右上角的“添加”按钮，选择“添加统一供应商”。

  3. 在弹出的配置窗口中，准确填写以下字段：

    text
    供应商名: tokenflux
API 地址: https://tokenflux.dev
API Key: 你的 TokenFlux API Key

    示例界面如下图所示：

    CC-Switch 手动填写统一供应商字段示意图

  4. 保存配置，CC-Switch 会自动为所有相关的 Agent 启用该供应商。

DOYO Claude 渠道环境变量 ​

WARNING

DOYO 的 Claude 渠道暂时无法在 Claude 应用（Claude app）中使用，只能通过 Claude Code CLI 使用。

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

该变量用于开启 1 小时 prompt cache，适合重复携带较长上下文的 Claude Code 会话。它只对 DOYO 的 Claude 渠道有效，其他 Claude 渠道无需设置。

应用专属供应商 ​

  1. 在 CC-Switch 顶部切换到 Claude Code。
  2. 找到 TokenFlux 对应的 Claude 供应商卡片，点击“编辑”。
  3. 在“配置 JSON”里的 env 中追加：
json
{
  "env": {
    "ENABLE_PROMPT_CACHING_1H": "1"
  }
}

统一供应商 ​

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

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

下一步该怎么做？ ​

恭喜你成功安装并配置了 CC-Switch！接下来，只需重启你的客户端，即可开始使用。

更多详情，请参阅：