Windows 安装和使用CC Switch超详细攻略实用指南

作者：袖梨 2026-08-21

平时做技术实践时，很多问题不是概念不会，而是细节没串起来。拿“Windows 安装和采用CC Switch超详细攻略”来说，它看着像小点，放到项目里常会牵出环境、配置、兼容性和维护成本。下面按实际采用顺序，把思路、关键写法和容易踩坑的地方讲清楚，便于大家直接对照操作。

一、系统要求
二、下载与安装
- 方式一：MSI 安装包（建议）
- 方式二：便携版（免安装）
三、更快采用
- 3.1 启动应用
- 3.2 添加设置
  - 桌面端操作
  - 命令行操作（CLI 模式）
- 3.3 兼容的 CLI 工具
四、设置示例
- 场景：接入 DeepSeek 代理服务
- 场景：切换官方和自定义端点
五、安全特性
六、常用问题
- Q1: 启动时被 SmartScreen 拦截
- Q2: 解压后启动失败
- Q3: 设置切换后不生效
- Q4: 设置文件不存在
七、设置文件位置
参考资源

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

一、系统要求

操作系统：Windows 10 及以上（64位）
前置条件：已安装 Claude Code 或其他兼容的 CLI 工具
网络：需访问 GitHub 下载安装包

二、下载与安装

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

方式一：MSI 安装包（建议）

适合长期稳定采用，兼容自动更新。

访问 GitHub Releases 下载最新版本的 CC-Switch-v{版本号}-Windows.msi
双击运行 MSI 安装包，启动安装向导
在这个场景下，建议将安装路径修改至非系统盘（如 D:Program FilesCC Switch），避免占用系统盘空间
依次点击“下一步”完成安装
安装完成后，桌面会生成快捷方式，双击即可启动

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

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

下载 CC-Switch-v{版本号}-Windows-Portable.zip
解压至纯英文路径（中文路径可能导致数据库初始化失败）
直接运行 CC-Switch.exe
从实现思路看，如遇 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	`（链接已移除）`
Token	你的 DeepSeek API Key

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

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

# 添加官方 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`