CC Switch 统一配置

用一套统一入口完成 Claude Code、Codex 等客户端的模型提供商配置。

CC Switch 是一个用于统一管理多个模型提供商的配置工具。它可以帮助你在官方账户和第三方中转站之间切换，并让 Claude Code、Codex、Gemini、Hermes、OpenClaw 等客户端复用同一套模型提供商配置。

如果你同时使用多个 Agent 工具，建议先在 CC Switch 中完成统一配置，再进入具体客户端做验证。这样后续切换模型、切换中转站或回到官方账户时，不需要每个工具单独重新填写。

下载 CC Switch

开始配置前，请先安装 CC Switch：

如果你第一次使用 CC Switch，建议先按官方安装指南完成安装，并确认应用可以正常打开，再继续下面的 TokenNova 自定义配置。

CC Switch 当前没有内置 TokenNova 站点预设。配置 TokenNova 时，需要选择自定义配置，并手动填写 Base URL、API Key 和模型信息。本文档推荐统一走自定义配置流程，其它工具接入页面也可以引用这里作为公共配置入口。

打开 CC Switch，点击 添加配置，选择你要配置的框架或客户端类型。如果列表中没有 TokenNova 预设，请选择 自定义配置 或对应客户端的自定义提供商配置。

进入自定义配置后，填写下面几项：

根据你使用的客户端选择对应模型分组：

实际模型 ID 以 TokenNova 控制台和 CC Switch 当前显示为准。

确认配置无误后，点击 添加 或 保存。然后重启终端或对应客户端，让新配置生效。

如果客户端仍然读取旧配置，优先检查：

如果你使用 Codex，并且希望保留官方账户能力，同时接入第三方中转站，需要在 CC Switch 中开启 Codex 增强。

开启后可以在官方账户和中转站之间切换，适合需要同时保留官方能力和自定义模型提供商的场景。

如果你还需要同步官方账户登录和 API 登录产生的历史记录，请同时开启 统一 Codex 会话历史。开启后，官方会话和第三方会话会出现在同一个历史列表中，也可以把现有官方会话迁入统一历史。

开启前建议先备份现有会话。跨供应商继续旧会话时，如果对方后端无法解析会话中的加密内容，可能会导致继续失败。