命令行使用
2026/8/21大约 3 分钟
登录(每台设备一次)
clauded login 终端会打印一条授权链接并自动打开浏览器。在控制台登录后点「批准」,终端就会显示:
Device #1042 registered ✓ (~/.clauded/device.json) 一份订阅可以在多台电脑上用,每台设备各自登录一次;控制台里能看到哪些设备在用、随时可以吊销。
退出登录用 clauded logout,它会清除设备注册并还原你原来的 Claude 凭证。
看状态
clauded status claude: ~/.clauded/claude-cli/2.1.220/claude (clauded 管理) · 2.1.220
device: #1042
gateway: https://api.augmunt.com
email: you@example.com
(reachable, 112ms)
daemon: running (pid 34127) at http://127.0.0.1:53219 出问题时先看这一屏:设备有没有登录、线路通不通、后台服务在不在跑、账号有没有分配。对不上号的,去排错。
四种用法
| 用法 | 命令 | 说明 |
|---|---|---|
| 命令行 | clauded | 经代理启动 Claude Code;后台服务和 Claude Code 本体都会按需自动准备好 |
| 网页版 | clauded web | 浏览器打开官方对话界面,用的是同一个账号。不需要后台服务,门槛最低 |
| 桌面版 | clauded app | 下载安装 Claude 桌面版并经代理启动(macOS) |
| 编辑器 | clauded ide install | 让 VS Code / Cursor / Windsurf 里的 Claude 官方插件走 clauded,重启编辑器后生效 |
clauded 后面跟的任何参数都会原样转交给 Claude Code,所以平时怎么用就怎么用:
clauded # 进入交互式会话
clauded "把这个函数拆成两个" # 直接带提示词
clauded --resume # Claude Code 自己的参数照常可用 桌面版提示证书不受信任
桌面版内嵌的组件只认系统证书库,跑一次 clauded cert install(会要一次管理员授权)即可。
Codex 走 codexd
同一次安装同时提供 codexd 入口,命令树与 clauded 完全一致,只是启动的是 Codex:
codexd # 启动 CodeX CLI
codexd web # ChatGPT 网页版
codexd app # CodeX 桌面版
codexd ide install # 编辑器里的 Codex 扩展 Claude 和 Codex 是两条独立的订阅,各有自己的账号和运行环境。
后台服务
平时不用管它 —— 直接敲 clauded 会自动把它拉起来。需要手动操作时:
clauded daemon # 启动(前台运行转发代理)
clauded stop # 停止
clauded install # 注册开机自启,省得每次重启后手动拉 用哪一份 Claude Code
一台机器上可能同时存在好几份 Claude Code(官方安装器装的、npm / bun 全局装的、clauded 自己下载的)。clauded status 的第一行会说明当前用的是哪一份、什么版本,取向可以自己定:
| 取向 | 行为 |
|---|---|
managed(默认) | 只用 clauded 管理的那份;没有就在启动时自动下载 |
system | 只用 PATH 上系统安装的那份;找不到会报错,不下载 |
auto | 先找系统的,找不到再用管理的那份 |
clauded config claude current # 当前用哪一份
clauded config claude source managed # 切换取向
clauded config claude path /usr/local/bin/claude # 钉死某个可执行文件
clauded config claude reset # 恢复默认 显式指定路径是「钉死」,不再跟着取向走;点回 source managed 或 source system 即可恢复自动选择。Codex 侧同理:clauded config codex …。
换一条线路
clauded config gateway pick # 列出候选线路并测速,交互选择
clauded config gateway test # 测当前线路
clauded config gateway current # 看当前线路
clauded config gateway reset # 恢复自动选择 日志
clauded log on # 打开每请求日志(含完整 request / response body)
clauded log status
clauded log off 日志写在 ~/.clauded/logs/daemon.log。默认是关的,排查完记得关掉。
命令还有一些没在这页展开的,见命令速查;随时可以 clauded help 看完整帮助。
