Skip to content

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 现在把「正常结束」「自己停了」「连不上」分开表达,常驻部署终于可以写出靠谱的重启策略,不用再靠解析日志去猜。

Claude-cn.org,专注于 Claude Code 中文教程