Claude Code Launcher

🚀 一键启动远程协作编码

一键启动 Claude Code 并开启远程控制,实现跨设备无缝协作编程,支持自动化终端管理与错误恢复

收藏
4.9k
安装
1.4k
版本
1.0.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

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` 命令行为变化 |
| 日志敏感信息 | 日志文件可能记录项目路径等元数据,需定期清理 |

Claude Code Launcher 内容

references文件夹
scripts文件夹
手动下载zip · 8.7 kB
troubleshooting.mdtext/markdown
请选择文件