All-in-One CLI 助手,统一管理 Claude Code、Codex、Gemini、OpenCode & OpenClaw 的提供商配置。
本仓库为 SaladDay/cc-switch-cli 的 CNB 镜像,提供国内加速下载和 npm 包分发。
npm install -g cc-switch-cli --registry=https://npm.cnb.cool/ccdecode/cc-switch-cli-npm/-/packages/
# ⚡ 一条命令完成 WebDAV 登录 + 推送(首次使用 / 换机器)
cc-switch claude-sync push \
--webdav-url https://dav.jianguoyun.com/dav/ \
--webdav-username user@app.com \
--webdav-password your-app-password
# ⚡ 一条命令完成 WebDAV 登录 + 拉取(新机器迁移)
cc-switch claude-sync pull \
--webdav-url https://dav.jianguoyun.com/dav/ \
--webdav-username user@app.com \
--webdav-password your-app-password
# 自更新
cc-switch update # 更新到最新版本
从 CNB Release 直接下载对应平台的二进制文件:
| 平台 | 文件 | 说明 |
|---|---|---|
| Linux AMD64 (Alpine) | cc-switch-cli-linux-x64-musl.tar.gz | 静态链接,无需额外依赖 |
| Linux AMD64 (通用) | cc-switch-cli-linux-x64.tar.gz | glibc 动态链接 |
| Linux ARM64 (通用) | cc-switch-cli-linux-arm64.tar.gz | 适用于 ARM 服务器/树莓派 |
| Linux ARM64 (Alpine) | cc-switch-cli-linux-arm64-musl.tar.gz | 静态链接,ARM Alpine |
| Windows x64 | cc-switch-cli-windows-x64.zip | Windows |
# 下载最新版
curl -LO https://cnb.cool/ccdecode/cc-switch-cli/-/releases/latest/download/cc-switch-cli-linux-x64-musl.tar.gz
# 解压
tar -xzf cc-switch-cli-linux-x64-musl.tar.gz
# 安装到 PATH
chmod +x cc-switch
sudo mv cc-switch /usr/local/bin/
# 验证
cc-switch --version
# 下载 zip 并解压 # https://cnb.cool/ccdecode/cc-switch-cli/-/releases/latest/download/cc-switch-cli-windows-x64.zip # 移动到 PATH 目录 move cc-switch.exe C:\Windows\System32\ # 或直接运行 .\cc-switch.exe
npm install -g cc-switch-cli --registry=https://npm.cnb.cool/ccdecode/cc-switch-cli-npm/-/packages/
git clone https://cnb.cool/ccdecode/cc-switch-cli.git
cd cc-switch-cli/src-tauri
cargo build --release
# 编译产物:./target/release/cc-switch
sudo cp target/release/cc-switch /usr/local/bin/
编译要求: Rust 1.85+
cc-switch
进入交互式 TUI 界面,按菜单操作即可。
# 提供商管理
cc-switch provider list # 列出所有提供商
cc-switch provider switch <id> # 切换提供商
cc-switch provider add # 添加新提供商
cc-switch provider speedtest <id> # 测试延迟
# MCP 服务器管理
cc-switch mcp list # 列出 MCP 服务器
cc-switch mcp add # 添加 MCP 服务器
cc-switch mcp sync # 同步到配置文件
# Skills 管理
cc-switch skills list # 列出已安装的 skills
cc-switch skills discover <query> # 搜索 skills
cc-switch skills install <name> # 安装 skill
# WebDAV 同步(cc-switch 全局配置)
cc-switch config webdav show # 查看同步配置
cc-switch config webdav upload # 上传同步
cc-switch config webdav download # 下载同步
# Claude Code 配置同步(通过 WebDAV 同步 ~/.claude/ 目录)
cc-switch claude-sync push # 推送到 WebDAV
cc-switch claude-sync pull # 从 WebDAV 拉取
cc-switch claude-sync status # 查看同步状态
通过 --app 标志指定目标应用:
cc-switch --app claude provider list # Claude Code(默认)
cc-switch --app codex provider list # Codex
cc-switch --app gemini provider list # Gemini
cc-switch --app opencode provider list # OpenCode
cc-switch --app openclaw provider list # OpenClaw
支持通过 WebDAV 在多台设备间同步完整的 Claude Code 配置(~/.claude/ 目录),包含 8 个功能模块:
| 模块 | 名称 | 内容 |
|---|---|---|
| A | 核心配置 | settings.json、keybindings.json(含敏感字段加密) |
| B | 用户扩展 | commands/、agents/、skills/、rules/、CLAUDE.md |
| C | 插件系统 | plugins/marketplaces/、plugins/cache/ |
| D | 记忆与对话 | projects/<project>/memory/、对话 JSONL |
| E | 会话与历史 | sessions/、history.jsonl、plans/ |
| F | 辅助数据 | stats-cache.json、file-history/ |
| G | 企业配置 | managed-settings.json |
| H | 项目级配置 | .claude/settings.json |
支持坚果云等 WebDAV 服务,模块 A 中的 API Key、OAuth Token 等敏感字段支持 AES-256-GCM 加密传输。
cc-switch-cli npm 包是一个轻量级包装器,安装时自动下载对应平台的预编译二进制文件。
cc-switch-cli-npm/ ├── package.json # 包配置 ├── index.js # 入口文件 ├── install.js # 安装脚本(自动下载二进制) ├── uninstall.js # 卸载脚本 └── bin/ └── cc-switch # 可执行文件包装
# 指定二进制安装目录
CC_SWITCH_INSTALL_DIR=/opt/bin npm install -g cc-switch-cli
# 强制覆盖已存在的安装
CC_SWITCH_FORCE=1 npm install -g cc-switch-cli
# .cnb.yml 示例
$:
push:
- docker:
image: node:22
stages:
- name: install cc-switch
script:
- npm config set registry https://npm.cnb.cool/ccdecode/cc-switch-cli-npm/-/packages/
- npm install -g cc-switch-cli
- cc-switch --version
cc-switch-cli/ # Rust 源码 ├── src-tauri/ │ ├── src/ │ │ ├── cli/ # CLI 命令 + TUI 交互界面 │ │ ├── services/ # 业务逻辑层 │ │ ├── database/ # SQLite 存储 │ │ └── main.rs # 入口 │ └── Cargo.toml # Rust 依赖 └── .github/workflows/ # CI/CD cc-switch-cli-npm/ # npm 包装器 ├── package.json ├── install.js # 自动下载平台二进制 └── bin/cc-switch # 可执行入口
| 资源 | 地址 |
|---|---|
| 原项目 (GitHub) | https://github.com/SaladDay/cc-switch-cli |
| CNB 镜像仓库 | https://cnb.cool/ccdecode/cc-switch-cli |
| CNB Release 下载 | https://cnb.cool/ccdecode/cc-switch-cli/-/releases |
| CNB npm 制品库 | https://cnb.cool/ccdecode/cc-switch-cli-npm |
MIT © Original Author: Jason Young | CLI Fork Maintainer: saladday