cc-switch
AI 编程工具的全能配置管理器 —— 在多个供应商配置之间一键切换。
cc-switch 是一个完全免费、开源的图形界面工具，统一管理各类 AI 编程工具的供应商配置、MCP 服务器与系统提示词。
它能做什么：
- ✅ 支持 8 个工具、50+ 预设：Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw、Hermes——复制 Key 一键导入
- ✅ 通用供应商：一份配置同步到 Claude Code / Codex / Gemini CLI
- ✅ 一键切换 API 配置，系统托盘快捷操作、拖拽排序、导入导出
- ✅ 应用内安装 / 升级 CLI 工具
- ✅ 本地代理 + 故障转移：格式转换、自动故障切换、熔断器、供应商健康监控与请求整流器；还可按应用（Claude / Codex / Gemini / Grok Build）甚至按单个供应商独立接管
- ✅ MCP / 提示词 / Skill 统一管理（Skill 可一键从 GitHub 仓库安装，适合科研用户挂载 科研技能包）
- ✅ 用量看板：跨供应商追踪花费、请求数与 token，趋势图表、请求明细、自定义模型定价
- ✅ 配置存本地 SQLite，支持完整 schema 迁移；原子写入 + 自动备份
- ✅ 云同步（自定义目录支持 Dropbox / OneDrive / iCloud / 坚果云 / NAS，另支持 WebDAV）、
ccswitch://深链导入 - ✅ 简中 / 繁中 / 英 / 日四语界面，深色浅色跟随系统
当前版本
本文基于 v3.20.1（2026-08-28 发布）。项目基于 Tauri 2.x（Rust 后端 + React 前端），MIT 协议开源。
谨防山寨
cc-switch 永久免费，绝不向用户收费、也不会索取登录凭据。任何要你付费 / 充值 / 登录的「CC Switch」网站或客户端都是假冒。请仅通过上方官方渠道获取。
一、下载与安装
系统要求：Windows 10+ ｜ macOS 12 (Monterey)+ ｜ Linux（Ubuntu 22.04+ / Debian 11+ / Fedora 34+ 等主流发行版）
brew install --cask cc-switch
# 更新
brew upgrade --cask cc-switch从 Releases 页下载：
CC-Switch-v{版本号}-Windows.msi ← 推荐，支持「一键导入」深链唤起
CC-Switch-v{版本号}-Windows-Portable.zip ← 绿色版，不注册 URL 协议
注意：绿色版/便携版无法响应下方的「一键导入」深链，需手动添加配置。paru -S cc-switch-bin从 Releases 页下载对应格式：
CC-Switch-v{版本号}-Linux.deb （Debian / Ubuntu）
CC-Switch-v{版本号}-Linux.rpm （Fedora / RHEL / openSUSE）
CC-Switch-v{版本号}-Linux.AppImage （通用）
官方 Release 不提供 Flatpak 包。macOS 不会弹「无法验证开发者」
cc-switch 的 macOS 版已通过 Apple 代码签名与公证，下载后可直接安装打开，不需要右键打开或改安全设置。
Linux AppImage：Wayland 下点不动？
AppImage 默认强制走 XWayland（GDK_BACKEND=x11）以规避历史崩溃问题。但在较新的 Wayland + NVIDIA 环境下，可能出现网页内容区点不动（标题栏按钮却能点）、窗口缩放后黑屏。用内置逃生开关切回原生 Wayland：
CC_SWITCH_GDK_BACKEND=wayland ./CC-Switch-*.AppImage从桌面图标启动的话，写进 .desktop 的 Exec= 行。反过来，在 sway / Hyprland 等 tiling 合成器下若点击失效，可设 CC_SWITCH_GDK_BACKEND=x11。
用它直接装 CLI
cc-switch 的「设置 → 关于」页现在内置受管 CLI 工具管理，可一站式安装 / 升级 Claude Code、Codex、Gemini 等，优先用官方原生安装器并自动诊断多来源冲突。还没装 CLI 的话，装好 cc-switch 后从这里一键安装即可，无需单独跑命令。
先做环境检查
配置前请确保 Node.js 环境以及 claude / codex / gemini CLI 已安装、配置目录存在。参考 环境检查。
二、最快方式：从 Kitcoding 控制台一键导入
Kitcoding 控制台已内置 CC Switch 快捷导入，不用手动填 Base URL 和 Key：
- 在 令牌管理 创建好令牌后，点击该令牌最右侧的
···菜单。 - 选择 「填入 CC Switch」，浏览器会唤起 cc-switch 并自动导入这条配置。
- 回到 cc-switch 点「启用」即可。
⚠️ Codex 分组导入后必须手动补 /v1
导入 Codex 类型的配置时，Base URL 不会自动带上 /v1。
启用前请检查并改成 https://kitcoding.com/v1，否则请求会发往 OpenAI 官方而不是 Kitcoding。
一键导入需要原生安装版
这个「填入 CC Switch」走的是 URL 协议深链唤起，仅 ccswitch.io 的原生安装版（msi / dmg 等）支持。Scoop 便携版等不注册 URL 协议的安装方式可能无法响应——这种情况请按下方手动添加配置。
三、手动配置：通用步骤
三个 CLI 的操作流程完全一致，只有 Base URL 和令牌分组不同：
- 打开 cc-switch，在顶部应用切换栏选择目标应用（Claude Code / Codex / Gemini）。
- 点击右上角
+「添加供应商」，填写：- 名称：自定义，例如
Kitcoding - Base URL：见下表
- API Key：在 创建 API 令牌 里创建对应分组的令牌并复制
- 名称：自定义，例如
- 点击右下角「添加」。
- 回到主界面，点击该配置右侧的「启用」，显示「使用中」即切换成功。
- 在终端运行对应命令，能正常对话即配置完成。
各应用的填写差异
| 应用 | Base URL | 推荐令牌分组 | 验证命令 |
|---|---|---|---|
| Claude Code | https://kitcoding.com | Claude特价-缓存优化 / ClaudeCode特价 | claude |
| Codex | https://kitcoding.com/v1 ← 必须带 /v1 | Codex专用 / Codex特价 | codex |
| Gemini CLI | https://kitcoding.com | default | gemini |
分组差异与可用模型见 模型分组介绍。
Claude Code 额外一步
配置完成后打开左上角「设置」→ 通用，勾选 「跳过 Claude Code 初次安装确认」（重要，否则每次启动都会卡在确认页）。
⚠️ New-API 内置导入的 Codex 端点错误
用控制台的「填入 CC Switch」导入 Codex 配置时，端点 URL 可能缺少 /v1（显示为 https://kitcoding.com 而非 https://kitcoding.com/v1）。
修复：导入后检查 Codex 供应商的 Base URL，确认以 /v1 结尾。若缺少则手动补全后再启用。
多分组就建多个供应商
同一个中转站可以按分组建多条配置（如 Kitcoding-特价、Kitcoding-缓存、Kitcoding-官方），按任务阶段一键切换。
四、查看用量（可选）
cc-switch 内置用量看板，可统计花费、请求数与 token 趋势，并查看请求明细、自定义按模型计价。想核对账单时比翻控制台方便。
以控制台为准
用量看板统计的是本机通过 cc-switch 代理的请求。账户余额与实际扣费请以 Kitcoding 控制台 为准。
五、常见问题
切换供应商后要重启终端吗？
大多数工具要重启终端或 CLI。例外是 Claude Code——它支持供应商数据热切换，切完直接就生效。
切换后我的 MCP / 插件配置怎么不见了？
用 「通用配置片段」 把这些跨供应商的数据带过去：
- 「编辑供应商」→ 「通用配置面板」→ 点 「从当前供应商提取」，把 Key 和地址之外的通用数据（插件、MCP 等）提取出来。
- 之后新建供应商时勾选 「应用通用配置」（默认就勾着），这些数据会自动写进新配置。
原有配置不会丢——它们都保存在首次导入时的默认供应商里。
用完中转站，怎么切回官方登录？
- 在预设供应商里添加一个「官方」供应商。
- 切换过去，然后完整走一遍 Log out / Log in 流程。
- 之后就能在官方和第三方供应商之间随意来回切了。
Codex 多账号
Codex 还支持在多个官方供应商之间切换，方便管理多个 Plus / Team 账号。
用 cc-switch 配 Kitcoding 时遇到问题，或有实战经验想分享，欢迎 投稿。