Kitcoding

简体中文

English

简体中文

English

外观

cc-switch ​

Claude Code / Codex / Gemini CLI 全方位辅助工具 —— 在多个供应商配置之间一键切换。

cc-switch 是一个完全免费、开源的图形界面工具，统一管理 Claude Code、Codex、Gemini CLI 等的供应商配置、MCP 服务器与系统提示词。同时挂着多个中转站 / 多个账号时尤其好用。

它能做什么：

  • ✅ 一键切换 API 配置 —— 在多个供应商之间快速切换
  • ✅ 可视化配置管理 —— 图形界面管理所有配置，无需手改配置文件
  • ✅ 应用内安装 / 升级 CLI 工具（v3.16.0+）
  • ✅ 搜索并安装 Skill（通过 skills.sh 市场，适合科研用户挂载 科研技能包）
  • ✅ MCP 服务器管理、系统托盘快捷操作

谨防山寨

cc-switch 永久免费，绝不向用户收费、也不会索取登录凭据。任何要你付费 / 充值 / 登录的「CC Switch」网站或客户端都是假冒。请仅通过上方官方渠道获取。

一、下载与安装 ​

text
从官网 ccswitch.io 或 Releases 页下载 .msi 安装包双击安装。
推荐这种方式——它支持下方的「一键导入」深链唤起。
powershell
# 已收录于 extras bucket，安装/升级方便
scoop bucket add extras
scoop install extras/cc-switch
# 注意：便携版可能无法响应「一键导入」深链，需手动添加配置
bash
# 已进入 Homebrew 官方仓库，无需再加 tap
brew install --cask cc-switch
# 安装后在「启动台」或「应用程序」中启动 CC-Switch
bash
# 下载 .deb 包（把 x.x.x 换成实际版本号）
wget https://github.com/farion1231/cc-switch/releases/latest/download/cc-switch_x.x.x_amd64.deb
sudo dpkg -i cc-switch_x.x.x_amd64.deb

用它直接装 CLI（v3.16.0+）

cc-switch 的「设置 → 关于」页现在内置受管 CLI 工具管理，可一站式安装 / 升级 Claude Code、Codex、Gemini 等，优先用官方原生安装器并自动诊断多来源冲突。还没装 CLI 的话，装好 cc-switch 后从这里一键安装即可，无需单独跑命令。

先做环境检查

配置前请确保 Node.js 环境以及 claude / codex / gemini CLI 已安装、配置目录存在。参考 环境检查。

二、最快方式：从 Kitcoding 控制台一键导入 ​

Kitcoding 控制台已内置 CC Switch 快捷导入，不用手动填 Base URL 和 Key：

  1. 在 令牌管理 创建好令牌后，点击该令牌最右侧的 ··· 菜单。
  2. 选择 「CC 切换」，浏览器会唤起 cc-switch 并自动导入这条配置。
  3. 回到 cc-switch 点「启用」即可。

一键导入需要原生安装版

这个「CC 切换」走的是 URL 协议深链唤起，仅 ccswitch.io 的原生安装版（msi / dmg 等）支持。Scoop 便携版等不注册 URL 协议的安装方式可能无法响应——这种情况请按下方手动添加配置。

三、手动配置 Claude Code ​

  1. 打开 cc-switch，在分组条切换到 Claude。
  2. 点击「添加供应商」，填写：
    • 名称：自定义，例如 Kitcoding
    • Base URL：https://kitcoding.com
    • API Key：你的 Kitcoding 令牌（在 创建 API 令牌 里创建含 Claude 模型分组的令牌并复制）
  3. 点击「添加」，回到主界面点击该配置右侧的「启用」，显示「使用中」即配置完成。
  4. 打开左上角「设置」→ 通用，勾选 「跳过 Claude Code 初次安装确认」（重要）。
  5. 终端运行 claude，能正常对话即成功。

四、手动配置 Codex ​

  1. 分组条切换到 Codex。
  2. 「添加供应商」，填写：
    • Base URL：https://kitcoding.com/v1 ← Codex 是 OpenAI 兼容，必须加 /v1
    • API Key：含 Codex 可用模型分组的令牌
  3. 点击「添加」→「启用」。
  4. 终端运行 codex，能正常对话即成功。

五、手动配置 Gemini CLI ​

  1. 分组条切换到 Gemini。
  2. 「添加供应商」，填写 Base URL https://kitcoding.com 与对应令牌。
  3. 「添加」→「启用」。
  4. 终端运行 gemini 验证。

CLI / TUI 版本 ​

cc-switch 还提供命令行与 TUI 界面，适合服务器、SSH、自动化场景，甚至可以让 Claude Code / Codex 直接调用 cc-switch 命令检查、切换、修复配置。详见其 官方文档。

经验补充

你用 cc-switch 配 Kitcoding 的实战经验（截图、踩坑）欢迎 投稿。