claude remote-control 有了明确退出码:4 和 69
把 claude remote-control 挂在一台常开的机器上,再从手机或网页连上去继续干活,是不少人的固定用法。既然是「常驻」,自然会想交给 systemd、launchd 或 supervisor 这类服务管理器托管:挂了就拉起来。
问题是,以前它不管因为什么停下,退出状态都看不出区别,服务管理器很难判断「该不该重启」。2.1.325 给出了明确的约定。
退出码含义
| 情况 | 退出码 |
|---|---|
| 单会话运行正常结束 | 0(保持不变) |
remote-control 自己停止了 | 4 |
| 无法完成注册 | 69 |
69 和 Unix 惯例里的 EX_UNAVAILABLE(服务不可用)是同一个数字,语义也接近:通常是网络、账号或服务端暂时不可用。
用 systemd 托管的思路
有了区分,就能只在「非正常停止」时重启,正常结束则不打扰:
ini
[Unit]
Description=Claude Code Remote Control
After=network-online.target
[Service]
WorkingDirectory=/home/me/project
ExecStart=/usr/local/bin/claude remote-control
Restart=on-failure
RestartSec=10
# 0 视为正常结束,不重启;4、69 属于失败,会被拉起
[Install]
WantedBy=default.target如果注册失败(69)多半是网络或登录问题,可以把 RestartSec 设长一点,避免短时间内反复重试。launchd 用户可以结合 KeepAlive 的 SuccessfulExit 键达到类似效果。具体命令参数以官方文档为准。
同版本里 Remote Control 的其他变化
- 已连接的会话带有分享链接(或无法确认是否带有)时,
/resume和/teleport会先断开连接再执行,之后用/remote-control重新连接即可; - 修复了
claude remote-control会话中,Claude Code 重启后才到达的权限批准没有套用 deny 规则的问题。
小结
退出码是脚本和服务管理器之间的「接口」。remote-control 现在把「正常结束」「自己停了」「连不上」分开表达,常驻部署终于可以写出靠谱的重启策略,不用再靠解析日志去猜。