Claude Code Launcher

Claude Code Launcher Overview

This 技能 automates the process of launching Claude Code in a new terminal window with Remote Control enabled. It 流lines the 工作流 of:

Opening a fresh terminal window Navigating to a project directory 启动ing Claude Code Activating Remote Control mode Handling user confirmations (if needed) Capturing and displaying the final 状态

Perfect for switching between projects quickly or sharing Claude Code 会话s across devices.

Usage Basic Launch claude-code-launcher /path/to/project

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

From OpenClaw Chat

Simply ask:

"Launch Claude Code in proposal-生成器 with Remote Control" "Open the AI-native-lms project and enable Remote Control" "启动 Claude Code in ~/dev/edikar-standalone" How It Works Step 1: Terminal Preparation Opens a new Terminal window using macOS 自动化 Ensures fresh shell 环境 (zsh) WAIts for the window to be ready Step 2: Project Navigation Changes directory to the specified project path 验证s that the directory exists 报告s any path resolution errors Step 3: Claude Code Launch 执行s claude code command WAIts for Claude Code interface to fully load (~5 seconds) 监控s for 启动up errors (missing dependencies, 权限 issues) Step 4: Remote Control Activation Types /remote-control command into Claude Code Presses Enter to submit WAIts for Remote Control UI to 应用ear (~3-6 seconds) Step 5: User Confirmation 检测s the "Continue" option in Remote Control menu Presses Enter to confirm (or prompts user if needed) 验证s that Remote Control is now active Step 6: 会话 Capture Takes a screenshot of the final 状态 Displays the Remote Control 会话 URL 提取s and displays QR code in格式化ion 报告s 成功 or any errors encountered Error Handling

The 技能 handles these common scenarios:

Issue 恢复y Terminal fAIls to open Retries once, then 报告s error Project path doesn't exist Displays helpful path resolution suggestions Claude Code not 安装ed 报告s missing dependency and suggests brew 安装 claude Claude Code hangs Timeout after 15 seconds, allows manual intervention Remote Control fAIls to activate 记录s error detAIls, suggests 检查ing Claude version Terminal 权限s denied 请求s user to enable Screen Recording in 系统 Preferences Network connectivity issue WAIts up to 10 seconds for reconnection Resources scripts/launch_claude_code.sh

MAIn 自动化 script using Peekaboo 命令行工具 for:

Terminal window management Keyboard/text 输入 自动化 Screenshot capture Error 检测ion and 恢复y 记录ging all operations to ~/.OpenClaw/workspace/记录s/claude-code-launcher.记录 references/troubleshooting.md

Common issues and solutions:

权限 设置up (Screen Recording, 访问ibility) Claude Code 安装ation and 更新s Terminal 应用 configuration Network troubleshooting Prerequisites

✅ 安装ed: peekaboo (for UI 自动化) ✅ 安装ed: claude 命令行工具 (Claude Code) ✅ 系统: macOS with Terminal.应用 ✅ 权限s: Screen Recording + 访问ibility enabled

To enable 权限s:

系统 设置tings → 隐私 & Security → Screen Recording → Enable OpenClaw 系统 设置tings → 隐私 & Security → 访问ibility → Enable OpenClaw

What You 获取

After launching, you'll have:

✅ New Terminal window with Claude Code 运行ning ✅ Remote Control 会话 active and 分享able ✅ 会话 URL for 访问ing from other devices ✅ QR code for 移动 devices (扫描 in Claude 应用) ✅ Full 上下文 of your project avAIlable to Claude ✅ Capability to 暂停/恢复 across devices Example 工作流 User: "Launch Claude Code in edikar-standalone with Remote Control" ↓ 技能 opens new Terminal ↓ cd ~/dev/edikar-standalone ↓ claude code ↓ /remote-control ↓ [Confirms continuation] ↓ Screenshot captured ↓ User sees: - 会话 URL: https://claude.AI/code/会话_... - QR code displayed - Ready to 访问 from phone/tablet

Related Commands /remote-control - Activate Remote Control in Claude Code claude code - 启动 Claude Code interactive 会话 peekaboo - macOS UI 自动化 (used internally)

Need help? See references/troubleshooting.md for common issues and solutions.