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

# 供应商管理

## 添加供应商

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

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

![PixPin_2026-05-14_21-03-31.png](https://developer.qcloudimg.com/http-save/yehe-8423593/4a7a7299e84326ac9c3500c41225bb2c.png)

## 切换供应商

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

### 方式一：主界面切换

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

![PixPin_2026-05-14_21-09-13.png](https://developer.qcloudimg.com/http-save/yehe-8423593/acf654487800ce5f842e255a48af9260.png)

### 方式二：托盘切换

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

![PixPin_2026-05-14_21-10-59.png](https://developer.qcloudimg.com/http-save/yehe-8423593/89ff4e2798f409d94a91f4da8f36654a.png)

## 生效方式

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

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

### Claude Code 首次安装提示

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

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

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

![PixPin_2026-05-14_21-15-27.png](https://developer.qcloudimg.com/http-save/yehe-8423593/3b3c0e834f5adeb54813072e86ccada1.png)

# 本地路由

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

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

## 启动代理

### 方式一：设置页面

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

![PixPin_2026-05-14_21-27-33.png](https://developer.qcloudimg.com/http-save/yehe-8423593/4d304344a896f3398a426495717798aa.png)

### 方式二：主界面开关

点击主界面顶部的 **代理开关** 按钮。
![PixPin_2026-05-14_21-27-54.png](https://developer.qcloudimg.com/http-save/yehe-8423593/112ec4a0abc2ee53728311f8b365c8b7.png)

## 配置修改

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

例如 Claude：

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

## 用量统计

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

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

![PixPin_2026-05-14_21-32-29.png](https://developer.qcloudimg.com/http-save/yehe-8423593/632ba8ef27d691f2943e30bee962a177.png)

# 个性化配置

## 轻量模式

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

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

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


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

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

人工智能

编程语言

开发工具

CCSwitch是一款专为开发者设计的跨平台工具，统一管理ClaudeCode、Codex、GeminiCLI等AI编程工具的配置。支持自动故障转移、本地安全存储、API用量可视化及多供应商切换，开源免费，兼容Windows、macOS和Linux系统。

Windows

路由

SQLite

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

你的 AI 编程 CLI 配置管理工具来了-腾讯云开发者社区-腾讯云

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

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

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐