2026最新CC‑Switch全指南：一键管理五大AI编程工具
选「Custom」填：名称：自定义（如「我的中转」）（Anthropic 兼容）或（OpenAI 兼容）sk-xxx模型：手动输入。
·
CC‑Switch 全指南（2026 最新）
CC‑Switch 是跨平台桌面+CLI 双模式工具，用来统一管理 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 五大 AI 编程工具的供应商/API Key、提示词、MCP、技能与会话，实现一键切换供应商、统一配置、用量统计、会话恢复。
一、核心概念与价值
1）解决什么痛点
- 多工具/多账号：每个工具手动改
~/.anthropic、~/.openai、.env，易改错、难切换。 - 提示词不统一：Claude 读
claude.md、Codex 读agent.md，一套提示词要复制多份。 - 密钥分散、泄露风险高、切换慢、无法统一看用量。
2）核心能力
- ✅ 50+ 主流供应商预设（Anthropic、OpenAI、智谱、Kimi、DeepSeek、SiliconFlow、ZenMux 等）
- ✅ 一键切换：桌面点选 / 托盘菜单 / CLI 命令，终端热生效，无需重启
- ✅ 统一提示词：一套模板自动映射到各工具配置文件
- ✅ MCP 与 Skills 统一管理、跨工具同步
- ✅ 用量/Token 统计、请求日志、会话历史回溯与恢复
- ✅ 本地优先+云备份（iCloud/Dropbox/WebDAV）
3）架构与数据存储
- 本地目录：
~/.cc-switch/cc-switch.db：SQLite，存供应商、提示词、MCP、Skills、会话settings.json：UI/行为偏好backups/：自动备份（保留最近 10 个）skills/：技能软链接到对应 CLI
二、安装（Windows/macOS/Linux）
方式 A：桌面版（推荐，新手首选）
- 下载： https://pan.quark.cn/s/d6152047213b
- 按系统选择：
- Windows：
.exe安装包（可跳过管理员） - macOS：
.dmg（首次拦截去「隐私与安全」允许）；或 Homebrew：brew tap farion1231/ccswitch brew install --cask cc-switch - Linux：
.deb（Debian/Ubuntu）、.rpm（Fedora）、AppImage
- Windows：
- 启动：首次会自动扫描本地已安装的 Claude/Codex 等，可导入现有配置作为默认供应商。
方式 B：CLI 版（轻量，无GUI）
# 安装（需 Rust 环境）
cargo install cc-switch
# 版本
cc-switch --version
三、界面总览（桌面版）
- 顶部：工具标签（Claude / Codex / Gemini / OpenCode / OpenClaw）
- 主区：供应商列表（启用/切换/编辑/删除）
- 右上角图标：
Prompts：系统提示词管理MCP：MCP 服务配置Skills：技能脚本管理History：会话历史与恢复
- 左上角：设置（通用/高级/备份/云同步）
四、快速上手（5 分钟跑通）
步骤 1：添加供应商（以智谱 GLM 为例）
- 选「Claude Code」标签
- 点右上角「+」→ 预设列表选「Zhipu GLM」
- 填：
- API Key：
sk-xxxxxx.xxxxxx（智谱控制台生成） - 模型：默认
glm-4.7（可改） - Base URL：自动填充（无需改）
- API Key：
- 点「添加并保存」→ 列表出现新供应商。
步骤 2：一键切换（3 种方式）
- 桌面：列表点「使用」→ 提示「切换成功」
- 托盘：右键 CC‑Switch 图标 → 直接选供应商
- CLI：
cc-switch use zhipu # 切换到名为 zhipu 的供应商
步骤 3：验证生效
终端打开 Claude Code：
claude
# 发一句测试：“你好，我用的是智谱 GLM”
# 正常回复即生效
五、核心功能详解
1）多供应商管理（重点）
添加官方 Anthropic
- 预设选「Claude Official」
- API Key：
sk-ant-xxxx（Anthropic 官网） - 模型：
claude-3-5-sonnet-20240620等
添加自定义供应商（无预设时）
- 选「Custom」
- 填：
- 名称：自定义（如「我的中转」）
- Base URL：
https://xxx.xxx.com/api/anthropic（Anthropic 兼容）或https://xxx.xxx.com/v1（OpenAI 兼容） - API Key：
sk-xxx - 模型：手动输入
排序/默认/禁用
- 拖拽排序；设为默认（启动自动切到）；临时禁用不删除。
2）统一提示词（Prompts）
作用
写一份系统提示词，自动同步到：
- Claude：
~/.claude/claude.md - Codex：
~/.codex/agent.md - Gemini：
~/.gemini/GEMINI.md - OpenCode：对应配置文件
使用
- 右上角点「Prompts」→「+」
- 填名称（如「前端规范」）、粘贴提示词、保存
- 切换到该提示词 → 所有工具自动更新配置文件。
3）MCP 管理（Model Context Protocol）
- 统一添加/启用/禁用 MCP 服务（如文件系统、数据库、API 工具）
- 一次配置，所有工具共享
- 支持本地 MCP 与远程 MCP 端点。
4）会话历史与恢复
- 记录所有对话：工具、供应商、时间、模型、内容预览
- 搜索/过滤/删除/导出
- 恢复会话：
cc-switch use zhipu --resume <会话ID> # 或恢复最近会话 cc-switch use zhipu --continue
5）用量统计与日志
- 仪表盘：请求数、Token 消耗、成功率、响应时间
- 按供应商/工具/时间筛选
- 导出 CSV 报表。
六、CLI 命令全览（桌面用户也常用）
# 交互模式（选供应商）
cc-switch # Claude 模式
cc-switch codex # Codex 模式
# 快速切换
cc-switch use <名称> # 切换并启动默认工具
cc-switch use <名称> "你的提示词" # 切换并直接发提示词
cc-switch use <名称> --resume <会话ID> # 切换并恢复会话
cc-switch use <名称> --continue # 切换并恢复最近会话
# 配置管理
cc-switch list # 列出所有供应商
cc-switch add <名称> # 交互式添加
cc-switch remove <名称> # 删除
cc-switch default <名称> # 设为默认
# 补全
cc-switch completion bash # 生成 bash 补全脚本
七、常见问题（避坑）
Q1：切换后 Claude 仍用旧 Key
- 原因：Claude 缓存环境变量
- 解决：重启终端；或在 CC‑Switch 设置开启「热切换」（v0.1.30+ 支持）
Q2：macOS 提示“无法验证开发者”
- 解决：系统设置 → 隐私与安全 → 拉到最下 → 「仍要打开」
Q3：Linux 启动无反应
- 检查：是否装了
libxcb、libxkbcommon - 依赖安装（Ubuntu）：
sudo apt install libxcb-randr0-dev libxkbcommon-dev
Q4：提示词不生效
- 确认：在「Prompts」里切换到该提示词（仅保存不切换无效）
- 权限：检查
~/.claude/目录读写权限
八、最佳实践
- 建 2–3 个核心供应商：官方（兜底）+ 国内中转（稳定）+ 备用（防限流）
- 提示词分项目：前端/后端/全栈/算法各一套，一键切换
- 开启自动备份：每周备份一次，防止配置丢失
- 用量监控：设月度阈值，超量告警，避免账单爆炸
九、升级与卸载
升级
- 桌面：启动自动检测更新 → 一键升级
- CLI：
cargo install cc-switch --force
卸载
- 桌面：正常卸载（Windows 控制面板/macOS 拖到废纸篓）
- 清理残留（关键）：
rm -rf ~/.cc-switch/
汇聚全球AI编程工具，助力开发者即刻编程。
更多推荐
20
0- 0
已为社区贡献1条内容
所有评论(0)