你在使用 Claude Code 编程时，有没遇到过：使用多家 AI 供应商需要来回手动修改配置文件；
如果你电脑上还有其他编程工具，例如 Codex、OpenCode 等，它们各自拥有自己的配置文件，管理起来很繁琐；
又或者有时候你想了解下 API 调用情况。

那么，你急需要一款能管理你的编程 CLI 配置的工具。
CC Switch 是一款跨平台桌面应用，专为开发者设计打造，可统一管理 Claude Code、Codex、OpenClaw 等 AI 编程工具配置。

• 统一管理六大 CLI：集中管理 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes Agent 的供应商配置
• 自动故障转移：内置熔断与健康监控，主供应商异常时自动切换备用
• 本地安全存储：所有配置与 API Key 安全存储于 SQLite，支持 Schema 迁移
• 用量与额度可视化：实时追踪请求、Token、缓存命中与成本，支持时间筛选与自定义单价
• 统一 MCP / Skills / 会话管理：集中管理 MCP、Skills、Prompts 与跨应用会话恢复
• 开源免费：MIT 协议开源，免费使用，社区驱动开发

快速开始

系统要求

• Windows 10 及以上
  • x64
• macOS 12 (Monterey) 及以上
  • Intel (x64)
  • Apple Silicon (arm64)
• Linux
  • x64
  • arm64

低版本的 macOS 打开软件可能会白屏，建议使用 cc-switch-cli

获取安装包

公 众 号 BugShare 发送 cc-switch 获取 CC Switch 安装包

• Windows：MSI 安装包
• macOS：DMG 安装包
• Linux
  • Fedora / RHEL / CentOS：sudo dnf install ./CC-Switch-*.rpm
  • Ubuntu / Debian / Linux Mint：sudo apt install ./CC-Switch-*.deb
  • 其他发行版：chmod +x CC-Switch-*.AppImage && ./CC-Switch-*.AppImage

Homebrew（macOS）

brew tap farion1231/ccswitch
brew install --cask cc-switch

供应商管理

添加供应商

1. 点击主界面右上角的 +
2. 在「预设」下拉选择你的供应商
   • 常用预设：智谱 GLM、MiniMax、DeepSeek、Kimi等
   • 或选择「自定义」手动配置
3. 填写 API Key
4. 点击「添加」完成配置

预设会自动填充端点地址，你只需要填写 API Key

切换供应商

添加完成后，供应商将显示在列表中。

方式一：主界面切换

点击供应商卡片的「启用」

方式二：托盘切换

右键系统托盘图标，直接选择供应商名称

生效方式

切换供应商后，各 CLI 工具的生效方式不同：

• 即时生效：Claude Code、Gemini
• 关闭并重新：Codex、OpenCode、OpenClaw

Claude Code 首次安装提示

若 Claude Code 首次启动提示登录或初始化引导，请在 CC Switch 中开启：

1. 进入「设置 → 通用」
2. 打开「跳过 Claude Code 初次安装确认」
3. 重启 Claude Code 即可

此选项会写入 ~/.claude/settings.json 的 skipIntroduction 字段，跳过官方的新手引导流程。

本地路由

代理服务会在本地启动 HTTP 代理，所有 API 请求统一经由代理转发。

• 记录请求日志
• 统计 API 用量
• 支持故障转移
• 统一管理多应用请求

启动代理

方式一：设置页面

打开「设置 → 路由 → 本地路由」

方式二：主界面开关

点击主界面顶部的 代理开关 按钮。

配置修改

启动代理并开启应用接管后，CC Switch 会修改应用配置

例如 Claude：

{
   
  "env": {
   
    "ANTHROPIC_BASE_URL": "http://127.0.0.1:15721"
  }
}

用量统计

用量统计功能用于记录并分析 API 请求数据，帮助你：

• 了解 API 使用情况
• 估算费用支出
• 分析使用模式
• 排查异常问题

个性化配置

轻量模式

「轻量模式」：仅保留托盘运行，用于降低空闲时的资源占用。

开启方式：右键托盘 → 点击「轻量模式」，主窗口将被销毁并释放内存与 UI 资源。
退出方式：托盘选择「打开主界面」，或通过深链接 / 重新启动 CC Switch，窗口会自动重建并保持状态。

如果你 CC Switch 长时间常驻后台，主要通过托盘菜单切换供应商，开启轻量模式能显著降低内存占用。