跳至主要內容

ccs CLI 命令行版

大约 5 分钟

ccs CLI（CC-Switch 命令行版）

服务器没图形界面？想把切换写进部署脚本、巡检脚本、应急脚本？这就是 ccs CLI 的舞台。

ccs 是 CC-Switch 的命令行版本，行为和图形版完全等价：你能在 GUI 里做的事，ccs 都能在终端里做。差别只在于一个是点界面、一个是敲命令。

谁适合用 ccs

  • 运维：服务器只有 SSH，没有桌面环境
  • DevOps：要把"切到生产线路 → 重启服务 → 跑健康检查"串成一条脚本
  • 重度终端党：嫌点 GUI 慢，习惯 ccs use 一行解决

不确定要不要用 ccs？

日常桌面办公，GUI 版更直观；要自动化、跨机器同步、应急切换，就用 ccs。两者可以装在同一台机器，互不冲突。

一、安装

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/ccs

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/ccs

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/ccs

Windows

  1. 下载对应版本的 zip
  2. 解压拿到 cc-switch.exe，重命名为 ccs.exe
  3. 放进 PATH 目录（如 C:\Windows\System32 或自定义工具目录）

把命令名改成 ccs

官方下载的可执行文件叫 cc-switch，本文统一用 ccs 作为命令名，因为短、好打，也是社区习惯。如果你保留 cc-switch 原名也完全可以，把下面文档里的 ccs 替换成 cc-switch 即可。

验证安装

ccs --version

能输出版本号就说明可执行文件已经在 PATH 里。

二、首次配置

第一次用 ccs，准备两个值：

字段填什么
API URLClaude https://www.yuzhixiaolongxia.com、Codex https://www.yuzhixiaolongxia.com/v1、Gemini https://www.yuzhixiaolongxia.com/
API Key对应家族分组的平台令牌

直接进入交互式向导：

ccs

按提示走：

  1. 添加 Provider（后端配置）
  2. 选择目标应用（claude / codex / gemini）
  3. 填 API URL 与 API Key
  4. 保存并启用

完成后建议立刻做两件事：

ccs status      # 查看当前启用的是哪条配置

再新开终端启动目标 CLI（claude / codex / gemini）发一句话验证。

三、最常用的 4 个命令

如果你只学 4 个命令，就这 4 个：

命令用途
ccs list列出当前所有保存的后端配置
ccs use <名称>切换到指定配置
ccs status看当前启用的是哪条
ccs edit编辑配置（进交互界面修改）

列出所有配置

ccs list

会显示所有保存的 Provider，并标出当前启用项。

切换

ccs use 预制小龙虾-Claude-prod

切完后重开终端才能让目标 CLI 生效。

当前状态

ccs status

发版前、排查前都先跑这条，确认你以为的"启用项"和实际一致。

编辑配置

ccs edit

进入交互界面后选要改的 Provider，修改 API Key / Base URL / Model 等。Key 轮换时最常用。

四、按应用单独操作

一台机器同时配了 Claude / Codex / Gemini 时，建议加 --app 锁定操作范围：

ccs --app claude list
ccs --app codex list
ccs --app gemini list

ccs --app codex use 预制小龙虾-Codex-prod
ccs --app codex status

这样能避免你"以为在切 Codex，结果切了 Claude"。

五、其他能力（按需了解）

ccs 不止能切 Provider，还能管 MCP、Prompt 模板、整体配置备份。

模块典型命令用途
Providerccs provider list/add/edit/delete后端配置增删改查
MCPccs mcp list/add/sync多机同步 MCP 工具配置
Promptsccs prompts list/activate <id>启用/切换团队提示词模板
Configccs config backup/restore/export/import整体配置备份、迁移、恢复

备份和迁移

换机器、重装系统前，强烈建议先：

ccs config export ./ccs-backup.json

新机器或恢复后：

ccs config import ./ccs-backup.json

备份文件含明文令牌

导出的 JSON 里包含所有 API Key。请妥善保管，不要上传到公共仓库或公网网盘。

改坏配置怎么回滚

ccs config backup    # 改之前先存一份
# ... 一通修改 ...
ccs config restore   # 改坏了一键回去

六、典型运维场景

场景 1：部署后切回生产线路

ccs --app codex use codex-prod
ccs --app codex status

预期看到当前启用项就是 codex-prod。

场景 2：换电脑 / 新服务器初始化

# 老机器
ccs config export ./ccs-backup.json

# 拷过去后，在新机器
ccs config import ./ccs-backup.json
ccs status

场景 3：令牌轮换批量改

ccs --app claude list
ccs --app claude edit
# 选要改的条目，替换 API Key
ccs --app claude status

场景 4：大改前先存档

ccs config backup
ccs --app codex use codex-staging   # 临时切测试
# 排查完
ccs config restore                   # 回到大改前的状态

七、常见坑

现象原因怎么处理
command not found: ccs可执行文件不在 PATH检查 /usr/local/bin/ccs 是否存在、是否可执行；重开终端
ccs status 显示对了，但 CLI 仍走旧后端已打开的 CLI 终端没重开关掉所有目标 CLI 终端，重开后再启动
401 / 403令牌错或分组不匹配重建对应家族令牌，再 ccs edit 替换
导入备份失败不同大版本 ccs 备份格式可能有变升级到最新版后重试，或手工逐条迁移
多应用混淆，切错了没加 --app一律带上 --app claude/codex/gemini

八、写进脚本时的建议

把 ccs 接进 CI / 部署 / 巡检脚本时，建议养成这几个习惯：

  • 切换前后各跑一次 ccs status，方便日志里留痕
  • 大改前先 ccs config backup，给自己留回退点
  • 切换完成后，用目标 CLI 跑一个最小请求做活体验证，不要光看状态
  • 多应用机器一律带 --app，不要在默认上下文里盲操作
  • 生产机器上及时清理"再也用不到"的旧配置，避免某天误切

上一步：切换 Gemini CLI

预制小龙虾 | 文档系统
Copyright © 2026 预制小龙虾