命令行参考

clauve-cli 是 Clauve 的命令行客户端。它和桌面版连的是同一个后台进程，桌面版能做的操作命令行都能做。

全局选项

账号

login

clauve-cli login [-u <账号>] [--password-stdin]

登录 Clauve。不带 -u 时会提示输入账号；--password-stdin 从标准输入读密码，适合脚本：

echo "$CLAUVE_PASSWORD" | clauve-cli login -u you@company.com --password-stdin

logout

clauve-cli logout

登出。手上有坐席时会先归还。

坐席

apply

clauve-cli apply

申请坐席。成功后凭据写进本机 Claude Code；暂时没有空闲坐席时，后台进程会自动重试。

switch

clauve-cli switch

手动更换坐席。24 小时内最多 5 次，status 里能看到剩余次数。用量到阈值时的自动换席不占这个次数。

return

clauve-cli return

主动归还坐席，让给其他人用。

status

clauve-cli status [--json]

查看登录账号、当前坐席、5 小时 / 7 天用量和剩余换席次数。--json 输出机器可读格式，便于接入脚本或状态栏。

restart

clauve-cli restart [--install <Clauve.app>]

重启 Clauve 后台进程并保留坐席，正在用坐席的 Claude Code 不会断线。升级时用；--install 先安装指定的新版 Clauve.app 再启动（仅 macOS）。

Claude Code 配置

config check

clauve-cli config check

检查本机 Claude Code 配置是否已接好用量采集和凭据失效探针，只读不改。

config init

clauve-cli config init [--force]

写入配置：

• statusLine：用来采集用量。你已经有别的 statusLine 时不会覆盖，会提示手动串联；确认替换才加 --force。
• StopFailure hook：请求认证失败时先续好凭据，再让当前会话继续。

config idle-release

clauve-cli config idle-release [on|off]

查看或设置「Claude Code 闲置 2 小时后自动归还坐席」，默认开启。不带参数时只查看当前设置。

退出码与排查

• 命令失败时会输出原因并以非零退出码结束，脚本里可以直接判断。
• 遇到问题先加 -v 重跑一遍看调试输出，再把输出发给管理员。