用途:在远程主机上执行 shell 命令,无需手动建立连接,可用于部署、监控或控制远程服务器。
用法:使用前先在 ~/.claude/ssh-targets.json 配置目标。其中 host 和 username 为必填,port 默认 22;认证方式为 password,或 keyPath 加可选 passphrase。调用格式为 exec:ssh,后接 shell 命令;若需指定命名主机,可在第一行写 @name,例如 exec:ssh 后接 @prod,再接 sudo systemctl restart myapp。
进程持久性:SSH 关闭时会终止子进程,若需在断开后继续运行,可借助 systemd-run 或 setsid nohup,例如 systemd-run --unit=myunit bash -c 'your-command',或用带时间戳的唯一单元名 systemd-run --unit=job-$(date +%s) bash -c 'nohup myprogram &';无 systemd 时可使用 setsid nohup bash -c 'myprogram > /tmp/out.log 2>&1' &。
依赖:需要 ~/.claude/gm-tools 中的 ssh2,安装命令为 npm install ssh2,安装目录为 ~/.claude/gm-tools;调用脚本写入 .gm/exec-spool/in/nodejs/<N>.js。
限制:其他平台支持、收费与价格、效果指标等资料暂未提供。