Windows CC Switch教程

Kali Linux安装CC Switch
https://wiki.bafangwy.com/doc/936/

# 一、CC Switch 基本介绍与工作原理
## 介绍
CC Switch 是一款免费开源、跨平台的 AI 编程 CLI 配置管理工具，主打一键切换多服务商 API 配置，专为 Claude Code、Codex、Gemini CLI 等主流 AI 编程命令行工具打造，解决原生工具配置繁琐、多账号切换麻烦的痛点。
它摒弃了手动修改 JSON、TOML、.env 等配置文件的传统方式，提供可视化图形界面，统一管理多套 API 密钥、服务商参数、系统提示词、模型参数等配置，是 AI 编程工具的轻量化配置控制台。

## 工作原理
CC Switch 的核心逻辑是配置接管+动态替换+全局同步，具体运行流程如下：
1. **配置接管**：自动扫描 Windows 系统中已安装的 Claude Code、Codex 等 AI 编程工具的默认配置路径，接管原生配置文件的读写权限；
2. **多配置缓存**：在软件内保存多套不同服务商、不同账号的 API 配置（如 OpenAI、各类中转服务商、Gemini 等），独立存储、互不冲突；
3. **一键动态替换**：用户选择指定配置后，软件自动覆盖对应 AI 工具的系统配置文件，无需手动修改代码或文件。

# 二、CCSwitch 核心作用
1. **一键切换多 API 服务商**：无需手动改配置文件，秒级切换官方 API、第三方中转 API、不同模型版本，适配不同编程场景需求；
2. **统一管理多套账号配置**：支持保存数十套独立配置，区分工作、个人、测试环境账号，避免密钥混淆、配置丢失；
3. **简化参数自定义**：可视化修改系统提示词、上下文长度、温度系数、超时时间等进阶参数，无需熟悉配置文件语法；
4. **数据监控与轻量化运维**：自带简易仪表盘，可查看接口请求记录、Token 消耗、对话统计，同时规避原生工具配置报错、文件损坏等问题，大幅提升 AI 编程效率。

# 三、适用人群与不适用人群
1. **适合使用的人群**
- 高频使用 AI 编程 CLI 工具的开发者：日常使用 Claude Code、Codex、Gemini CLI 写代码、调试、重构的程序员、测试工程师；
- 多 API 服务商/多账号使用者：需要频繁切换官方 API、中转 API，或区分个人、公司、测试账号的用户；
- 新手开发者：不熟悉配置文件语法、不会手动修改 AI 工具配置，想要零门槛上手 AI 编程工具的用户；
- 追求高效运维的使用者：需要统一管理配置、统计 Token 消耗、简化多环境部署的技术人员。
2. **不适合使用的人群**
- 仅使用 AI 网页版/客户端的用户：只打开浏览器、桌面客户端使用 AI，不使用命令行 AI 编程工具的人群，无需配置管理；
- 固定单配置、无切换需求的用户：长期只用一套固定 API 配置，无需切换服务商和账号，无需额外工具；

# 四、Windows 端 CC Switch 下载与安装
1. 前置环境准备
CC Switch 运行依赖 Node.js 20.0 及以上版本
B74-Windows安装NodeJS教程
https://wiki.bafangwy.com/doc/904/

2. 软件下载
官方下载地址（支持各种平台）：
https://github.com/farion1231/cc-switch/releases

![](/media/202607/2026-07-12_142524_4141250.09296223719580232.png)

第一个是便携版，第二个是安装包：

![](/media/202607/2026-07-12_142609_4002960.48395743891387755.png)

例如（连不上的可以用迅雷下载）：
https://github.com/farion1231/cc-switch/releases/download/v3.16.5/CC-Switch-v3.16.5-Windows-Portable.zip
https://github.com/farion1231/cc-switch/releases/download/v3.16.5/CC-Switch-v3.16.5-Windows.msi

# 五、CCSwitch 全局设置
![](/media/202607/2026-07-12_143458_9651050.3351943318429166.png)

## 通用设置
你电脑上安装了什么，就勾选什么：

![](/media/202607/2026-07-12_143542_3826090.7151383057695647.png)

## 路由设置
作用是让客户端先连接到本地的一个代理端口，再转发，可以根据个人需求使用，可以实现自动故障专业
![](/media/202607/2026-07-12_143643_1214970.9299778526315051.png)

## 使用统计
可以看到所有的服务商的Token消耗

![](/media/202607/2026-07-12_143945_6423330.6648929377458314.png)

## 关于
可以更新cc switch客户端；可以安装、更新AI客户端

![](/media/202607/2026-07-12_144021_9816780.7065768694168567.png)

## 六、配置
**首先需要选中一个工具，然后才能做右边的操作。**
![](/media/202607/2026-07-12_144342_7266640.9438092617505961.png)

**配置和切换供应商**
![](/media/202607/2026-07-12_144605_7006200.2691307367081358.png)

下载Skill技能可以看这个：
https://wiki.bafangwy.com/doc/926/

下载MCP可以看这个：
https://wiki.bafangwy.com/doc/881/

# 附录 CC Switch 与 9route 完整区别对比表
省Token的AI编程路由代理：9Router
https://wiki.bafangwy.com/doc/932/

| 对比维度         | CC Switch（主要功能是切换）   | 9route（主要功能是自动路由） |
| ---------------- | ---------------------------- | ------------------------------------------------------------ |
| 核心产品定位     | AI CLI 工具配置管理软件   | 轻量可编程网络路由转发框架  |
| 核心用途 | 统一管理 OpenAI/Claude/Gemini 等多套 API 密钥、接口地址，一键切换 AI 工具配置 | 实现网络 NAT、流量转发、防火墙、虚拟网卡、自定义路由策略 |
| 工作原理         | 本地读写 AI 工具配置文件，保存多套配置模板，点击启用直接覆盖本地配置文件 | 基于网络栈做流量拦截转发，脚本驱动网络流量调度，属于网络层工具 |
| 运行形态         | Windows/macOS/Linux 桌面 GUI 程序，带托盘可视化操作     | 后台网络服务 / 嵌入式库，无图形界面，依靠 Lua 脚本配置    |
| 目标用户         | 使用 Claude Code、Codex 等 AI 命令行工具的开发人员           | 网络开发、嵌入式、边缘设备、运维工程师   |
| 典型使用场景     | 频繁切换多 AI 服务商、多账号，不想手动修改 json/env 配置文件 | 搭建旁路由、设备网络隔离、自定义流量分流、NFV 网络原型测试   |
| 依赖环境         | 需 Node\.js 运行环境   | 无重型依赖，可部署在低资源嵌入式设备  |
| 是否处理网络流量 | 不处理流量转发，仅修改本地配置文本文件    | 核心功能就是拦截、转发、调度全部网络流量   |
| 关闭程序后效果   | 已切换的 API 配置永久保留，不会自动恢复   | 停止进程后自定义路由 / 转发规则立即失效，网络恢复原生状态   |
| 核心功能清单     | 多配置存储、一键切换、配置备份、Token 用量统计  | 流量分流、NAT、防火墙规则、虚拟接口、脚本化路由策略   |