Claude Code 启动器

概述

该技能可自动在新终端窗口中启动启用远程控制（Remote Control）的 Claude Code，从而简化以下工作流程：

1. 打开一个全新的终端窗口
2. 切换至目标项目目录
3. 启动 Claude Code
4. 启用远程控制模式
5. 处理用户确认操作（如需要）
6. 捕获并显示最终状态

非常适合在多个项目间快速切换，或跨设备共享 Claude Code 会话。

使用方法

基础启动

claude-code-launcher /path/to/project

带选项启动

claude-code-launcher /path/to/project --verbose --screenshot

在 OpenClaw 聊天界面中调用

只需直接提问：

• “在 proposal-generator 项目中启动 Claude Code 并启用远程控制”
• “打开 ai-native-lms 项目并启用远程控制”
• “在 ~/dev/edikar-standalone 中启动 Claude Code”

工作原理

步骤 1：终端准备

• 通过 macOS 自动化机制打开一个新的 Terminal 窗口
• 确保使用干净的 shell 环境（zsh）
• 等待窗口完全就绪

步骤 2：项目路径导航

• 切换至指定的项目路径
• 验证该目录是否存在
• 报告任何路径解析错误

步骤 3：启动 Claude Code

• 执行 claude code 命令
• 等待 Claude Code 界面完全加载（约 5 秒）
• 监控启动过程中的错误（例如依赖缺失、权限问题）

步骤 4：启用远程控制

• 在 Claude Code 中输入 /remote-control 命令
• 按 Enter 键提交
• 等待远程控制 UI 出现（约 3–6 秒）

步骤 5：用户确认

• 检测远程控制菜单中的“Continue”选项
• 按 Enter 键确认（若需交互则提示用户）
• 验证远程控制是否已成功启用

步骤 6：会话捕获

• 截取最终状态的屏幕截图
• 显示远程控制会话 URL
• 提取并展示 QR 码信息
• 报告执行成功或所遇错误

错误处理

该技能可应对以下常见问题：

相关资源

scripts/launch_claude_code.sh

主自动化脚本，基于 Peekaboo CLI 实现以下功能：

• 终端窗口管理
• 键盘与文本输入自动化
• 截图捕获
• 错误检测与恢复
• 将全部操作日志记录至 ~/.openclaw/workspace/logs/claude-code-launcher.log

references/troubleshooting.md

常见问题及解决方案：

• 权限配置（屏幕录制、辅助功能）
• Claude Code 的安装与更新
• Terminal 应用程序配置
• 网络问题排查

前提条件

✅ 已安装： peekaboo（用于 UI 自动化）
✅ 已安装： claude CLI（Claude Code）
✅ 系统要求： macOS 及其自带 Terminal.app
✅ 权限要求： 已启用“屏幕录制”和“辅助功能”权限

启用权限方法：

系统设置 → 隐私与安全性 → 屏幕录制 → 启用 OpenClaw
系统设置 → 隐私与安全性 → 辅助功能 → 启用 OpenClaw

你将获得什么

启动完成后，你将拥有：

• ✅ 运行着 Claude Code 的全新终端窗口
• ✅ 已激活且可共享的远程控制会话
• ✅ 可供其他设备访问的会话 URL
• ✅ 适用于移动设备的 QR 码（可在 Claude App 中扫码）
• ✅ Claude 可完整访问当前项目的上下文
• ✅ 支持跨设备暂停/恢复会话的能力

示例工作流

用户：“在 edikar-standalone 项目中启动 Claude Code 并启用远程控制”
↓
技能打开新终端
↓
cd ~/dev/edikar-standalone
↓
claude code
↓
/remote-control
↓
[确认继续]
↓
截取屏幕截图
↓
用户看到：
   - 会话 URL：https://claude.ai/code/session_...
   - QR 码已显示
   - 可立即通过手机/平板设备接入

相关命令

• /remote-control — 在 Claude Code 中启用远程控制
• claude code — 启动 Claude Code 交互式会话
• peekaboo — macOS UI 自动化工具（内部使用）

需要帮助？请查阅 references/troubleshooting.md 获取常见问题及解决方案。