核心用法
Claude Code Launcher 是一个 macOS 自动化技能,专为需要远程访问和跨设备协作的开发场景设计。用户只需指定项目路径,即可自动完成:开启新终端 → 导航到项目目录 → 启动 Claude Code → 激活 Remote Control 模式 → 捕获会话状态。支持通过自然语言指令触发,如"在 proposal-generator 项目中启动 Claude Code 并开启远程控制"。
显著优点
1. 零摩擦启动:将原本需要多次手动操作的流程(打开终端、cd、启动 claude、输入 /remote-control)压缩为单次指令
2. 跨设备无缝衔接:Remote Control 激活后生成会话 URL 和二维码,支持手机、平板等设备扫码接入同一 Claude 会话
3. 完善的错误恢复:内置 6 类常见故障的自动检测与修复机制,包括权限缺失、网络中断、Claude Code 未安装等
4. 会话可追踪:所有操作记录至 ~/.openclaw/workspace/logs/claude-code-launcher.log,便于审计与故障排查
潜在局限
- 平台锁定:仅支持 macOS + Terminal.app,Linux/Windows 用户无法使用
- 依赖外部 CLI:需要预装
peekaboo(UI 自动化)和claude(Anthropic 官方 CLI),安装失败则整个技能失效 - 权限门槛高:必须手动授予屏幕录制和辅助功能权限,首次配置较繁琐
- 无 headless 模式:必须打开真实图形终端,无法用于 CI/CD 等纯自动化场景
- 网络依赖:Remote Control 需要稳定联网,局域网隔离环境无法使用
适合人群
- 频繁切换多项目的全栈开发者
- 需要手机/平板查看或轻量编辑代码的移动办公场景
- 远程 pair programming 或需要向非技术人员展示 Claude 会话的协作场景
常规风险
| 风险类型 | 说明 |
|---------|------|
| 权限过度授予 | 屏幕录制权限可被恶意利用捕捉敏感信息 |
| 会话 URL 泄露 | Remote Control URL 若被截获,他人可加入会话 |
| 自动化误操作 | 脚本在错误目录执行 `claude code` 可能污染工作区 |
| 依赖版本漂移 | `claude` CLI 更新可能导致 `/remote-control` 命令行为变化 |
| 日志敏感信息 | 日志文件可能记录项目路径等元数据,需定期清理 |