| name | cc-switch |
| description | 一站式 AI 编码 CLI 工具管理器，可视化管理 Claude Code、Codex、Gemini CLI、OpenCode 和 OpenClaw 的 Provider 切换、MCP 服务器、Skills 和 Prompts，告别手动编辑配置文件 |
| version | 0.1.1 |
| metadata | {"openclaw":{"requires":{"bins":["node","npx"]},"emoji":"🔀","homepage":"https://github.com/farion1231/cc-switch"}} |
CC Switch — AI CLI 工具全家桶管理器
CC Switch 是一款基于 Tauri 2 + Rust 构建的跨平台桌面应用，为 Claude Code、Codex、Gemini CLI、OpenCode 和 OpenClaw 五款 AI 编码工具提供统一的可视化管理界面。内置 50+ 主流 Provider 预设，一键切换 API 服务商，无需手动编辑 JSON/TOML/.env 文件；同时统一管理跨工具的 MCP 服务器、Skills 和 Prompts，配合系统托盘快速切换，大幅提升多工具、多账号的使用效率。
核心使用场景
- 多 Provider 快速切换：在官方 API、中转服务商和自建代理之间一键切换，Claude Code 无需重启终端即生效
- 统一 MCP 管理：一个面板管理 4 个 AI 工具的 MCP 服务器，双向同步，无需逐个应用配置
- Skills 一键安装：从 GitHub 仓库或 ZIP 文件一键安装 Skills 到所有支持的应用
- 使用量与成本追踪：实时查看各 Provider 的 Token 用量、费用趋势和请求日志
- 多设备配置同步：通过 Dropbox/OneDrive/iCloud/WebDAV 同步配置，保持多机一致
AI 辅助使用流程
- 安装应用 — AI 提供适合当前系统的安装命令（Homebrew / 安装包 / paru）
- 导入现有配置 — 首次启动时，AI 指导从现有 CLI 工具配置导入为默认 Provider
- 添加/切换 Provider — AI 帮助从 50+ 预设中选择合适的服务商并完成配置
- 配置 MCP 与 Skills — AI 执行通过 Deep Link 或手动添加 MCP 服务器和 Skills
- 设置代理与故障转移 — AI 指导配置本地代理和多 Provider 故障转移链
- 云同步设置 — AI 帮助配置 WebDAV 或本地共享目录实现多机同步
关键章节导航
- 安装指南 — Windows / macOS / Linux 安装和首次启动
- 快速开始 — 添加 Provider、切换、MCP/Skills 管理
- 高级用法 — 代理模式、故障转移、云同步、Deep Link
- 故障排查 — 常见安装和使用问题
AI 助手能力
使用本技能时，AI 可以：
- ✅ 根据操作系统提供正确的安装命令（brew / .dmg / .msi / paru / .AppImage）
- ✅ 解释各类 Provider 预设的适用场景（官方 / 中转 / 自建）
- ✅ 构造
ccswitch:// Deep Link 批量导入 Provider、MCP 和 Skills
- ✅ 查询
~/.cc-switch/cc-switch.db 获取当前 Provider 配置详情
- ✅ 解释 Shared Config Snippet 机制，帮助保留插件配置跨 Provider
- ✅ 配置代理故障转移链和 Circuit Breaker 参数
- ✅ 配置 WebDAV / 本地目录云同步路径
- ✅ 排查环境变量冲突（
ANTHROPIC_API_KEY 等与 CC Switch 配置的优先级问题）
核心功能
- ✅ 5 大 CLI 工具支持 — Claude Code / Codex / Gemini CLI / OpenCode / OpenClaw
- ✅ 50+ Provider 预设 — 含 AWS Bedrock / NVIDIA NIM / 主流中转服务
- ✅ 系统托盘快速切换 — 无需打开主界面，托盘菜单直接切换
- ✅ Claude Code 热切换 — 切换后无需重启终端立即生效
- ✅ 统一 MCP 面板 — 跨 4 个应用双向同步 MCP 服务器
- ✅ Skills 管理 — GitHub 仓库 / ZIP 一键安装，symlink 或文件复制
- ✅ Prompts 管理 — Markdown 编辑器，跨应用同步 CLAUDE.md / AGENTS.md / GEMINI.md
- ✅ 本地代理模式 — 格式转换、热切换、自动故障转移、Circuit Breaker
- ✅ 使用量追踪 — Token / 费用 / 请求日志 + 自定义每模型定价
- ✅ 会话管理器 — 跨应用浏览、搜索和恢复对话历史
- ✅ 云同步 — Dropbox / OneDrive / iCloud / WebDAV
- ✅ Deep Link —
ccswitch:// 协议批量导入配置
- ✅ 原子写入 — SQLite + 临时文件重命名，防止配置损坏
- ✅ 跨平台 — Windows 10+ / macOS 12+ / Linux（Ubuntu 22+）
快速命令示例
brew tap farion1231/ccswitch
brew install --cask cc-switch
brew upgrade --cask cc-switch
paru -S cc-switch-bin
sqlite3 ~/.cc-switch/cc-switch.db \
"SELECT name, app, is_active FROM providers ORDER BY app, sort_order;"
open "ccswitch://import-provider?name=MyProvider&apiKey=sk-xxx&baseUrl=https://api.example.com"
安装要求
| 平台 | 最低版本 |
|---|
| Windows | Windows 10 |
| macOS | macOS 12 (Monterey) |
| Linux | Ubuntu 22.04 / Debian 11 / Fedora 34 |
无需额外运行时依赖，安装包包含所有必要组件。
数据存储位置
| 路径 | 内容 |
|---|
~/.cc-switch/cc-switch.db | 主数据库（Provider / MCP / Skills / Prompts） |
~/.cc-switch/settings.json | 设备级 UI 偏好设置 |
~/.cc-switch/backups/ | 自动备份（保留最近 10 份） |
~/.cc-switch/skills/ | 已安装的 Skills（默认 symlink 到对应应用） |
项目链接
