cc-switch

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 辅助使用流程

1. 安装应用 — AI 提供适合当前系统的安装命令（Homebrew / 安装包 / paru）
2. 导入现有配置 — 首次启动时，AI 指导从现有 CLI 工具配置导入为默认 Provider
3. 添加/切换 Provider — AI 帮助从 50+ 预设中选择合适的服务商并完成配置
4. 配置 MCP 与 Skills — AI 执行通过 Deep Link 或手动添加 MCP 服务器和 Skills
5. 设置代理与故障转移 — AI 指导配置本地代理和多 Provider 故障转移链
6. 云同步设置 — 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+）

快速命令示例

# macOS 通过 Homebrew 安装（推荐）
brew tap farion1231/ccswitch
brew install --cask cc-switch

# macOS 更新
brew upgrade --cask cc-switch

# Arch Linux 安装
paru -S cc-switch-bin

# 查看当前 Provider 数据库
sqlite3 ~/.cc-switch/cc-switch.db \
  "SELECT name, app, is_active FROM providers ORDER BY app, sort_order;"

# 通过 Deep Link 导入 Provider（在终端触发）
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 到对应应用）

项目链接

• GitHub：https://github.com/farion1231/cc-switch
• 用户手册：https://github.com/farion1231/cc-switch/tree/main/docs/user-manual/en
• Releases：https://github.com/farion1231/cc-switch/releases
• Changelog：https://github.com/farion1231/cc-switch/blob/main/CHANGELOG.md