配置 Claude Code 模型供应商

推荐使用 CC-Switch 配置 Tokenhot。CC-Switch 可视化管理服务商配置，避免手动修改 Claude Code 的环境变量和配置文件。

CC-Switch 可能修改 Claude Code 的本地配置。切换前建议备份 ~/.claude/settings.json；如果你同时使用官方 Claude 登录，也请确认当前 CC-Switch 版本对认证信息的处理方式。

1. 安装 CC-Switch

macOS

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

Windows

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

Linux

请从 CC-Switch Releases 下载对应发行版的安装包。

Debian / Ubuntu：

Fedora / RHEL：

AppImage：

2. 添加 Tokenhot 服务商

步骤一：新增供应商

打开 CC-Switch，进入 Claude Code 页面，点击右上角 + 新增服务商。

步骤二：填写配置

选择自定义服务商或 Anthropic Messages 兼容配置，按下图填写后点击添加。

配置项	值	说明
供应商名称	`Tokenhot Claude`	可自定义，建议使用易识别的名称
官网链接	`https://api.tokenhot.ai`	Tokenhot 控制台地址
API Key	你的 Tokenhot API Key	在 Tokenhot 控制台获取
请求地址	`https://api.tokenhot.ai`	末尾不要添加 `/`
API 格式	`Anthropic Messages`	必须与 Claude Code 使用的协议一致
认证字段	`ANTHROPIC_AUTH_TOKEN`	保持默认，除非 Tokenhot 后续另有说明
模型配置	默认可留空	使用非 Claude 模型时，需按下方说明配置映射
写入通用配置	按需勾选	勾选后对所有项目生效

不要默认勾选“隐藏 AI 署名”等与模型连接无关的选项，应按团队规范和实际需求自行决定。

CC-Switch 会将配置写入 Claude Code 的本地配置文件，通常无需手动编辑 ~/.claude/settings.json。

步骤三：启用服务商

添加完成后回到服务商列表，选择 Tokenhot Claude，点击使用。看到“切换成功”提示后，即表示服务商已启用。

3. 验证配置

进入任意项目目录并启动 Claude Code：

启动后运行：

/status

确认当前显示的服务商、模型和 Anthropic Base URL 与 Tokenhot 配置一致。

Base URL 应以 https://api.tokenhot.ai 开头，不能出现 api.api.tokenhot.ai。
不同 CC-Switch 版本可能在状态页显示不同的完整路径；以当前启用服务商的配置为准。

如果 Claude Code 可以正常回复，即表示配置成功。

4. 使用其他兼容模型

通过 Tokenhot，你可以在 Claude Code 中使用支持 Anthropic Messages 协议 的兼容模型。

非 Claude 模型的工具调用、图片输入、上下文长度、推理能力和输出格式可能与 Claude 原生模型不同。请先使用简单任务验证，再用于正式项目。

步骤一：筛选兼容模型

前往 Tokenhot 模型列表，筛选支持 Anthropic 协议的模型。

步骤二：复制模型 ID

在模型详情或模型卡片中复制完整模型 ID。

步骤三：配置模型映射

回到 CC-Switch，在当前 Tokenhot 服务商的 模型映射 区域填写模型 ID。

映射槽位	用途
主模型	Claude Code 默认使用的模型
推理模型（Thinking）	用于需要更强推理的任务
Haiku 默认模型	用于轻量、低成本任务
Sonnet 默认模型	用于日常编码和通用任务
Opus 默认模型	用于复杂分析、代码重构等任务

如果你使用 Tokenhot 提供的 Claude 原生模型，通常无需额外配置模型映射。
仅在需要将 Claude Code 的模型请求映射到其他兼容模型时填写，并确保目标模型支持 Anthropic Messages 协议。

故障排除

提示 `Authentication error`

请检查：

API Key 是否有效。

请求地址是否为 https://api.tokenhot.ai。

认证字段是否为 ANTHROPIC_AUTH_TOKEN。

当前服务商是否已在 CC-Switch 中启用。

连接超时或请求失败

请检查：

请求地址末尾没有多余的 /。

当前网络可以访问 Tokenhot API。

模型 ID 存在且支持 Anthropic Messages 协议。

关闭并重新打开 Claude Code 后再次测试。

流式输出卡顿

请先确认普通非流式请求是否正常，再检查：

本地网络状态。

当前模型是否支持流式输出。

Tokenhot 控制台中的调用记录和错误信息。

配置模型供应商

配置 Claude Code 模型供应商#

1. 安装 CC-Switch#

macOS#

Windows#

Linux#

2. 添加 Tokenhot 服务商#

步骤一：新增供应商#

步骤二：填写配置#

步骤三：启用服务商#

3. 验证配置#

4. 使用其他兼容模型#

步骤一：筛选兼容模型#

步骤二：复制模型 ID#

步骤三：配置模型映射#

故障排除#

提示 Authentication error#

连接超时或请求失败#

流式输出卡顿#