首页TokenhotAPI文档工具集成
语言
语言
  • English
  • 中文
首页TokenhotAPI文档工具集成
语言
语言
  • English
  • 中文
  1. 工具集成
  • 导航
  • OpenClaw
  • hermes
  • Gemini CLI
  • OpenCode
  • Cherry Studio
  • CC-Switch
  • Workbuddy
  • Claude
    • 概述
    • 安装Claude Code
    • 配置模型供应商
    • CCometixLine 状态栏插件
    • Skills配置
  • Codex
    • 配置模型供应商
    • Codex CLI安装
    • 配置skill
  1. 工具集成

CC-Switch

CC-Switch 配置#

CC-Switch 是多模型与多工具配置管理工具，可用于管理 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes 等工具的服务商配置。
不同应用使用的协议和配置文件不同。新增服务商前，请先在 CC-Switch 中选择要配置的目标应用；不要将一个应用的配置直接用于另一个应用。

准备工作#

在 Tokenhot 控制台 创建 API Key。
安装 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 页面。
选择 OpenAI 配置

第 2 步：添加 Tokenhot 服务商#

点击右上角 + 新增服务商；优先选择 Custom 或与目标工具匹配的 Provider 类型。
填写以下内容：
配置项值
服务商名称tokenhot（可自定义）
API Key你的 Tokenhot API Key
模型从 Tokenhot 模型列表复制完整模型 ID
写入通用配置按需开启；仅在希望所有项目共享配置时开启
API 地址和协议必须按目标应用填写：
使用场景API Base URL协议说明
OpenAI Chat Completionshttps://api.tokenhot.ai/v1用于支持 Chat Completions 的模型
OpenAI Responseshttps://api.tokenhot.ai/v1用于支持 Responses 的模型
Anthropic Messageshttps://api.tokenhot.ai用于 Claude / Anthropic 协议模型
Geminihttps://api.tokenhot.ai用于 Gemini 协议模型
填写服务商信息
不要在同一个服务商配置中混用不同协议的模型。建议分别创建 Tokenhot OpenAI、Tokenhot Anthropic 和 Tokenhot Gemini。

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

点击 添加 或 保存 后，在服务商列表中选择 Tokenhot 并点击 使用 / 启用。
随后：
1.
关闭并重新打开目标工具或终端。
2.
选择刚添加的模型。
3.
发送一条简单消息验证是否收到正常回复。
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 测试账户

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

请检查：
1.
是否已在 CC-Switch 中点击 使用 / 启用。
2.
是否重启了目标工具或终端。
3.
当前工具是否选择了正确的服务商和模型。
4.
API 地址、协议和模型是否匹配。

提示认证失败#

请检查 API Key 是否有效、是否完整粘贴，以及 API 地址末尾没有多余的 /。
Previous
Cherry Studio
Next
Workbuddy
Built with