logo
0
1
WeChat Login

cc-switch-cli

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.gzglibc 动态链接
Linux ARM64 (通用)cc-switch-cli-linux-arm64.tar.gz适用于 ARM 服务器/树莓派
Linux ARM64 (Alpine)cc-switch-cli-linux-arm64-musl.tar.gz静态链接,ARM Alpine
Windows x64cc-switch-cli-windows-x64.zipWindows

Linux / macOS 一键安装

# 下载最新版 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

Windows

# 下载 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 全局安装

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

Claude Code 配置同步

支持通过 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 加密传输。


npm 包说明

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

在 CI/CD 中使用

# .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

About

https://github.com/SaladDay/cc-switch-cli/

Language
Rust95.1%
Go4.4%
JavaScript0.2%
Shell0.2%
Others0.1%