CC Switch 是一款跨平台的桌面应用，用于统一管理 Claude Code、Codex、Gemini CLI 等主流 AI 编程工具的供应商配置。以下是 Windows 系统上的完整安装和使用方案。

---

📋 一、系统要求

• 操作系统：Windows 10 及以上（64位）

• 前置条件：已安装 Claude Code 或其他支持的 CLI 工具

• 网络：需要访问 GitHub 下载安装包

---

📦 二、下载与安装

CC Switch 提供两种安装方式，可根据需求选择。

方式一：MSI 安装包（推荐）

适合长期稳定使用，支持自动更新。

1. 访问 GitHub Releases 下载最新版本的 CC-Switch-v{版本号}-Windows.msi

2. 双击运行 MSI 安装包，启动安装向导

3. 建议将安装路径修改至非系统盘（如 D:\Program Files\CC Switch），避免占用系统盘空间

4. 依次点击“下一步”完成安装

5. 安装完成后，桌面会生成快捷方式，双击即可启动

方式二：便携版（免安装）

适合临时使用或多设备迁移，无需写入注册表。

1. 下载 CC-Switch-v{版本号}-Windows-Portable.zip

2. 解压至纯英文路径（中文路径可能导致数据库初始化失败）

3. 直接运行 CC-Switch.exe

4. 如遇 Windows SmartScreen 拦截，点击“更多信息”→“仍要运行”即可

注意：Windows 版本已禁用“一键安装”功能，Claude Code 等工具需手动安装后再通过 CC Switch 管理。

---

🚀 三、快速使用

3.1 启动应用

双击桌面快捷方式或 CC-Switch.exe 启动 CC Switch。

3.2 添加配置

CC Switch 支持两种使用方式：

桌面端操作

在可视化界面中，点击“添加配置”，填写以下信息：

• 配置名称：自定义（如 dev、prod、deepseek）

• API URL：模型服务的 API 端点地址

• Token/API Key：对应的 API 密钥

命令行操作（CLI 模式）

如果偏好命令行操作，CC Switch 也提供了 CLI 工具：

# 1. 检查系统状态
ccs diagnostics

# 2. 添加配置
ccs add dev https://api.anthropic.com sk-ant-api03-your-token

# 3. 查看所有配置
ccs list

# 4. 切换配置
ccs switch dev

# 5. 查看当前配置
ccs current

3.3 支持的 CLI 工具

CC Switch 统一管理以下工具的配置：

• Claude Code

• Codex

• Gemini CLI

• OpenCode

• OpenClaw

---

⚙️ 四、配置示例

场景：接入 DeepSeek 代理服务

如果你需要通过 CC Switch 管理 Hermes 的代理配置（如 Hermes 文档中使用的 CCSwitch 代理），可以参考以下设置：

配置项	示例值
配置名称	deepseek-proxy
API URL	http://127.0.0.1:15721/v1
Token	你的 DeepSeek API Key

说明：这里的 15721 端口是 CCSwitch 代理服务的监听端口，用于将请求转发至 DeepSeek 等底层模型服务。

场景：切换官方和自定义端点

bash

# 添加官方 Claude API 配置
ccs add claude-official https://api.anthropic.com sk-ant-xxx

# 添加自定义代理配置
ccs add my-proxy http://127.0.0.1:15721/v1 sk-xxx

# 切换配置
ccs switch my-proxy

---

🛡️ 五、安全特性

CC Switch 内置了多项安全保护机制：

安全功能	说明
Token 遮蔽	根据 token 类型（sk-ant-、sk-、pk-）智能遮蔽显示
安全存储	配置文件权限设置为 600（仅所有者可读写）
自动备份	每次切换前自动备份，保留最近 5 个备份文件
原子操作	使用临时文件和原子重命名确保写入安全

---

🐛 六、常见问题

Q1: 启动时被 SmartScreen 拦截

点击“更多信息”→“仍要运行”即可正常启动。

Q2: 解压后启动失败

检查解压路径是否包含中文字符，确保使用纯英文路径。

Q3: 配置切换后不生效

# 检查当前状态
ccs current

# 重新切换配置
ccs switch <配置名称>

# 检查 Claude Code 配置文件
cat ~/.claude/settings.json

Q4: 配置文件不存在

# 运行诊断检查
ccs diagnostics

# 确保 Claude Code 已安装并至少运行过一次
# 手动创建目录（如需要）
mkdir -p ~/.claude

---

📁 七、配置文件位置

文件类型	路径
CC Switch 配置	~/.ccswitcher/configs.json
Claude Code 配置（用户级）	~/.claude/settings.json
Claude Code 配置（项目级）	.claude/settings.json

---

🔗 参考资源

• CC Switch GitHub Releases

• CC Switch NPM 包

• SiliconFlow CC Switch 文档