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 Files\CC 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、deepseekAPI 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 current3.3 支持的 CLI 工具CC Switch 统一管理以下工具的配置Claude CodeCodexGemini CLIOpenCodeOpenClaw⚙️ 四、配置示例场景接入 DeepSeek 代理服务如果你需要通过 CC Switch 管理 Hermes 的代理配置如 Hermes 文档中使用的 CCSwitch 代理可以参考以下设置配置项示例值配置名称deepseek-proxyAPI URLhttp://127.0.0.1:15721/v1Token你的 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.jsonQ4: 配置文件不存在# 运行诊断检查 ccs diagnostics # 确保 Claude Code 已安装并至少运行过一次 # 手动创建目录如需要 mkdir -p ~/.claude 七、配置文件位置文件类型路径CC Switch 配置~/.ccswitcher/configs.jsonClaude Code 配置用户级~/.claude/settings.jsonClaude Code 配置项目级.claude/settings.json 参考资源CC Switch GitHub ReleasesCC Switch NPM 包SiliconFlow CC Switch 文档