一、前置条件
在开始配置前,确保你已完成以下准备工作:
1. 订阅 Token Plan 企业版套餐。
2. 获取模型配置:
2.1 专业套餐模型配置。
2.2 轻享套餐模型配置。
3. 获取 API Key。
4. 下载并安装 CC Switch,请参见 CC Switch。
二、配置 Token Plan 企业版
CC Switch 通过自定义供应商方式接入腾讯云 Token Plan。Token Plan 企业版同时提供 OpenAI 兼容和 Anthropic 兼容两种 API 协议,可根据目标工具选择对应协议配置。
三、方式一:Claude Code / Claude Desktop
1. 打开 CC Switch,在顶部工具栏选择 Claude Code 或 Claude Desktop 应用标签。
2. 单击右上角 + 按钮,打开添加新供应商面板。
3. 在预设供应商下拉框中选择自定义。
4. 填写以下信息:
| 配置项 | 填写说明 |
| 供应商名称 | 自定义设置,后续如需重命名则需要添加新的提供方,并删除旧的提供方。 |
| API Key | 填写你在腾讯云控制台获取的 API Key。 |
| API 格式、请求地址 | Anthropic messages(原生):https://tokenhub.tencentmaas.com/plan/anthropic |
| 模型映射 | 展开高级选项,在模型映射中按需手动添加套餐支持的模型 (暂不支持获取模型列表功能),并配置默认兜底模型,支持模型请参见:专业套餐模型配置轻享套餐模型配置 |
5. 请配置完成以上内容后,单击右下角+ 添加保存。
四、方式二:Codex
1. 打开 CC Switch,在顶部工具栏选择 Codex 应用标签。
2. 点击右上角 + 按钮,打开添加新供应商面板。
3. 在预设供应商下拉框中选择自定义。
4. 填写以下信息:
| 配置项 | 填写说明 |
| 供应商名称 | 自定义设置,后续如需重命名则需要添加新的提供方,并删除旧的提供方。 |
| API Key | 填写你在腾讯云控制台获取的 API Key。 |
| API 格式、请求地址 | OpenAI Response:https://tokenhub.tencentmaas.com/plan/v3 |
| 模型映射 | 展开高级选项,在模型映射中按需手动添加套餐支持的模型 (暂不支持获取模型列表功能),并配置默认模型,支持模型请参见:专业套餐模型配置轻享套餐模型配置 |
5. 请配置完成以上内容后,单击右下角+ 添加保存。
五、方式三:OpenCode / OpenClaw / Hermes
1. 打开 CC Switch,在顶部工具栏选择 OpenCode、OpenClaw 或 Hermes 应用标签。
2. 点击右上角 + 按钮,打开添加新供应商面板。
3. 在预设供应商下拉框中选择自定义。
4. 填写以下信息:
| 配置项 | 填写说明 |
| 供应商名称 | 自定义设置,后续如需重命名则需要添加新的提供方,并删除旧的提供方。 |
| API 协议、API 端点 | OpenAI Completions:https://tokenhub.tencentmaas.com/plan/v3Anthropic Messages:https://tokenhub.tencentmaas.com/plan/anthropic |
| API Key | 填写你在腾讯云控制台获取的 API Key。 |
| 模型列表 | 在模型列表中按需手动添加套餐支持的模型 (暂不支持获取模型列表功能),支持模型请参见:专业套餐模型配置轻享套餐模型配置 |
5. 请配置完成以上内容后,单击右下角+ 添加保存。
六、切换与生效
1. 在主界面或系统托盘中选择刚添加的供应商。
2. 单击启用或直接点击托盘菜单中的供应商名称。
3. 生效方式:
·Claude Code:支持热切换,无需重启终端。
·Codex / Gemini CLI / OpenCode / OpenClaw / Hermes:需重启对应的终端或 CLI 工具。
4. 切换后,在对应工具中即可使用腾讯云 Token Plan 的模型。
七、使用 CC Switch
1. 启动 CC Switch:安装后从应用列表启动,首次运行可导入现有 CLI 工具配置作为默认供应商。
2. 切换供应商:在应用界面或系统托盘菜单中一键切换供应商,当前激活的供应商会高亮显示。
3. 管理 MCP 与 Skills:通过左侧导航栏的 MCP、Prompts、Skills 面板统一管理所有工具的扩展配置。
4. 用量追踪:在用量面板中查看跨供应商的 Token 消耗和费用趋势。
5. 代理与故障转移:在代理面板中配置本地代理,实现格式转换、自动故障转移和健康监控。