配置工具
CC Switch
一键配置所有 AI 工具连接 hahacode
CC Switch 提供图形化界面，可以一键配置和切换 Claude Code、Codex、OpenCode、OpenClaw 的 API 连接。
打开 CC Switch#
访问 ccswitch.lovable.app 即可使用。顶部标签栏可以切换不同的工具。
导入到 CCS#
最推荐从 hahacode 控制台直接导入，这样不需要手动复制 API Key 和请求地址。
- 登录 hahacode.com，进入「API 密钥管理」页面
- 找到要使用的密钥，点击右侧「导入到 CCS」
- 在打开的 CC Switch 页面里确认配置并保存
- 回到对应工具标签，选择刚导入的 Provider 使用
这是日常最省事的方式。只有需要自定义请求地址、模型映射或本地路由时，再进入 CC Switch 编辑 Provider。
手动添加#
- 点击右上角「+」添加新配置
- 填写供应商信息：
| 字段 | 填写内容 |
|---|---|
| 供应商名称 | 自定义，如 hahacode_claude |
| API Key | 你的 Key（在 hahacode.com 控制台的「API 密钥管理」页面获取） |
| 请求地址 | https://hahacode.com |
| API 加速请求地址 | https://cn.hahacode.com |
Claude Code 场景不带 /v1。如果 API 请求需要加速，可以把请求地址改为加速请求地址。
- 点击「保存」
Gemini 配置#
Gemini 要看你当前配置的是哪个工具标签：
| 工具标签 | 接口格式 | 请求地址 | 实际请求 |
|---|---|---|---|
| Gemini CLI | Google (Gemini) | https://hahacode.com/v1beta | POST /v1beta/models/模型名:generateContent |
| Codex / OpenCode / OpenClaw | OpenAI 兼容 | https://hahacode.com/v1 | POST /v1/chat/completions |
例如 Gemini CLI 里使用 gemini-3.5-flash-high 时，Base URL 填 https://hahacode.com/v1beta，不要填 https://hahacode.com/v1。
配置模型映射#
向下滚动可以配置模型映射，将 Claude Code 的模型别名映射到你想用的模型：
| 字段 | 说明 |
|---|---|
| 主模型 | Claude Code 默认使用的模型 |
| 推理模型 (Thinking) | 用于深度推理的模型 |
| Haiku 默认模型 | /model haiku 时使用的模型 |
| Sonnet 默认模型 | /model sonnet 时使用的模型 |
| Opus 默认模型 | /model opus 时使用的模型 |
勾选「写入通用配置」可以将配置应用到所有工具。
切换 Provider#
在主界面中，选中你要使用的配置即可切换。支持自动故障转移 —— 当一个 Provider 不可用时自动切换到下一个。
支持的工具#
| 工具 | 支持 |
|---|---|
| Claude Code | 支持 |
| Codex | 支持 |
| OpenCode | 支持 |
| OpenClaw | 支持 |
Cherry Studio 不支持 CC Switch，请查看 Cherry Studio 配置页面 手动配置。
官方网站：ccswitch.lovable.app · GitHub：github.com/farion1231/cc-switch