CC-Switch 配置

CC-Switch 是多模型与多工具配置管理工具，可用于管理 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes 等工具的服务商配置。

不同应用使用的协议和配置文件不同。新增服务商前，请先在 CC-Switch 中选择要配置的目标应用；不要将一个应用的配置直接用于另一个应用。

准备工作

安装 CC-Switch。

确认要配置的工具已安装，例如 Codex、Gemini CLI 或 OpenCode。

CC-Switch 可能修改本地工具的服务商配置、认证信息或模型设置。切换前建议备份现有配置，尤其是 ~/.codex/config.toml、~/.codex/auth.json 和 ~/.claude/settings.json。

安装 CC-Switch

macOS

也可以前往 CC-Switch Releases 下载 .dmg 安装包。

Windows

前往 CC-Switch Releases 下载 .msi 安装程序并完成安装。

Linux

请前往 CC-Switch Releases，根据发行版下载对应的 .deb、.rpm 或 AppImage 安装包。

配置步骤

第 1 步：选择目标应用

打开 CC-Switch，在应用列表中选择需要配置的工具。

例如，配置 OpenAI 兼容模型时，可选择对应的应用页面；如果目标是 Codex，请进入 Codex 页面，而不是通用 OpenAI 页面。

第 2 步：添加 Tokenhot 服务商

点击右上角 + 新增服务商；优先选择 Custom 或与目标工具匹配的 Provider 类型。

填写以下内容：

配置项	值
服务商名称	`tokenhot`（可自定义）
API Key	你的 Tokenhot API Key
模型	从 Tokenhot 模型列表复制完整模型 ID
写入通用配置	按需开启；仅在希望所有项目共享配置时开启

API 地址和协议必须按目标应用填写：

使用场景	API Base URL	协议说明
OpenAI Chat Completions	`https://api.tokenhot.cn/v1`	用于支持 Chat Completions 的模型
OpenAI Responses	`https://api.tokenhot.cn/v1`	用于支持 Responses 的模型
Anthropic Messages	`https://api.tokenhot.cn`	用于 Claude / Anthropic 协议模型
Gemini	`https://api.tokenhot.cn`	用于 Gemini 协议模型

不要在同一个服务商配置中混用不同协议的模型。建议分别创建 Tokenhot OpenAI、Tokenhot Anthropic 和 Tokenhot Gemini。

第 3 步：保存、启用并验证

点击添加或保存后，在服务商列表中选择 Tokenhot 并点击 使用 / 启用。

随后：

关闭并重新打开目标工具或终端。

选择刚添加的模型。

发送一条简单消息验证是否收到正常回复。

Codex、OpenCode、Gemini CLI 等工具通常需要重启终端后才能读取新配置。具体是否支持热切换，以当前 CC-Switch 和目标工具版本为准。

Codex 特别说明

Codex 默认使用 OpenAI Responses 协议。

如果所选 Tokenhot 模型支持 Responses，可直接配置。

如果上游仅支持 Chat Completions，需要在 CC-Switch 中启用 本地路由 / Local Routing，由 CC-Switch 进行协议转换。

切换前请备份 ~/.codex/config.toml 和 ~/.codex/auth.json。

Codex 的详细配置请查看 Codex 配置模型供应商。

可用模型

请以 Tokenhot 模型列表中当前显示的模型、协议和能力为准。

不同模型支持的上下文长度、图片输入、工具调用、推理能力和价格不同。添加前请确认模型与目标工具、目标协议兼容。

常见问题

能否配置多个 Tokenhot 账户？

可以。你可以添加多个 Tokenhot 服务商，并为每个服务商设置不同的 API Key。

建议使用容易识别的名称，例如：

Tokenhot 个人账户
Tokenhot 团队账户
Tokenhot 测试账户

切换后工具仍然使用旧模型

请检查：

是否已在 CC-Switch 中点击 使用 / 启用。

是否重启了目标工具或终端。

当前工具是否选择了正确的服务商和模型。

API 地址、协议和模型是否匹配。

提示认证失败

请检查 API Key 是否有效、是否完整粘贴，以及 API 地址末尾没有多余的 /。

CC-Switch

CC-Switch 配置#

准备工作#

安装 CC-Switch#

macOS#

Windows#

Linux#

配置步骤#

第 1 步：选择目标应用#

第 2 步：添加 Tokenhot 服务商#

第 3 步：保存、启用并验证#

Codex 特别说明#

可用模型#

常见问题#

能否配置多个 Tokenhot 账户？#

切换后工具仍然使用旧模型#

提示认证失败#