你的 AI 编程 CLI 配置管理工具来了

你在使用 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）

shell 复制代码

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

供应商管理

添加供应商

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

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

切换供应商

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

方式一：主界面切换

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

方式二：托盘切换

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

生效方式

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

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

Claude Code 首次安装提示

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

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

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

本地路由

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

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

启动代理

方式一：设置页面

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

方式二：主界面开关

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

配置修改

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

例如 Claude：

json 复制代码

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

用量统计

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

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

个性化配置

轻量模式

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

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

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