CC-Switch CLI 使用

CC-Switch CLI 给命令行用户管理 provider、MCP、prompts、skills 和配置备份。

下载与安装

先打开 CC-Switch CLI Releases，选择与你系统匹配的压缩包；下面的命令可直接复制。

macOS

curl -LO https://github.com/saladday/cc-switch-cli/releases/latest/download/cc-switch-cli-darwin-universal.tar.gz
tar -xzf cc-switch-cli-darwin-universal.tar.gz
chmod +x cc-switch
sudo mv cc-switch /usr/local/bin/
xattr -cr /usr/local/bin/cc-switch

Linux x64

curl -LO https://github.com/saladday/cc-switch-cli/releases/latest/download/cc-switch-cli-linux-x64-musl.tar.gz
tar -xzf cc-switch-cli-linux-x64-musl.tar.gz
chmod +x cc-switch
sudo mv cc-switch /usr/local/bin/

Linux ARM64

curl -LO https://github.com/saladday/cc-switch-cli/releases/latest/download/cc-switch-cli-linux-arm64-musl.tar.gz
tar -xzf cc-switch-cli-linux-arm64-musl.tar.gz
chmod +x cc-switch
sudo mv cc-switch /usr/local/bin/

Windows

从 CC-Switch CLI Releases 下载 Windows zip，把 cc-switch.exe 放到 PATH 目录，或在解压目录中直接运行。

常用命令

cc-switch provider list
cc-switch provider current
cc-switch provider add
cc-switch provider edit <id>
cc-switch provider switch <id>
cc-switch provider speedtest <id>

指定应用：

cc-switch --app claude provider list
cc-switch --app codex provider list
cc-switch --app gemini provider list

MCP 管理

cc-switch mcp list
cc-switch mcp add
cc-switch mcp edit <id>
cc-switch mcp enable <id> --app claude
cc-switch mcp disable <id> --app claude
cc-switch mcp sync
cc-switch mcp import --app claude

Prompts 与 Skills

cc-switch prompts list
cc-switch prompts activate <id>
cc-switch prompts deactivate
cc-switch skills list
cc-switch skills search <query>
cc-switch skills install <name>
cc-switch skills sync

配置备份

cc-switch config show
cc-switch config validate
cc-switch config backup --name before-service-switch
cc-switch config restore
cc-switch config export ./cc-switch-backup.json
cc-switch config import ./cc-switch-backup.json

配置 AveMujicaAPI

交互式执行：

cc-switch provider add

填写以下值：

• Claude Code 兼容模式：Provider 选择 OpenAI-compatible，Base URL https://api.avemujica.moe/v1，Key <YOUR_AVEMUJICA_API_KEY>。
• Codex：Base URL https://api.avemujica.moe/v1，Key <YOUR_AVEMUJICA_API_KEY>，wire API responses。
• Gemini/Cline 兼容模式：Provider 选择 OpenAI-compatible，Base URL https://api.avemujica.moe/v1，Key <YOUR_AVEMUJICA_API_KEY>。

验收

• cc-switch provider current 显示已切换到 AveMujicaAPI。
• 对应 CLI 能完成一次最小对话。
• cc-switch config backup 已保存切换前配置。