Claude Code Control

🤖 自动化控制 Claude Code 终端会话

通过 AppleScript 在 macOS Terminal 中程序化控制 Claude Code,支持命令注入、截图捕获和会话录制,适合自动化 AI 工作流。

收藏
13.3k
安装
3.2k
版本
1.1.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

Claude Code Control 是一个基于 Node.js 的自动化工具,通过 AppleScript 与 macOS Terminal.app 深度集成,实现对 Claude Code 的 programmatic 控制。开发者可在指定项目目录启动 Claude Code 会话,通过系统级键盘事件注入命令,并自动捕获终端窗口截图生成时间戳日志。

显著优点

  • 无需模拟器:直接操作真实 Terminal 窗口,行为与人工操作完全一致
  • 完整会话追溯:JSON 格式保存完整交互历史,便于审计与回放
  • 截图验证机制:每条命令执行后自动截图,适合自动化测试场景
  • 轻量依赖:仅需 Node.js 18+ 和标准 macOS 工具,无复杂虚拟化层

潜在局限

  • 平台锁定:完全依赖 macOS AppleScript/System Events,无法跨平台
  • 权限敏感:需要授予 Terminal 和 Script Editor 辅助功能权限,企业环境可能受限
  • UI 脆弱性:终端窗口位置/大小变化、系统弹窗、暗色模式切换均可能破坏自动化
  • 无原生 API:通过键盘模拟而非 Claude Code 官方 SDK,存在字符编码和时序风险

适合人群

  • macOS 环境下的 QA 自动化工程师
  • 需要批量验证 Claude Code 行为的 AI 应用开发者
  • 构建 AI agent 工作流编排系统的技术团队

常规风险

  • 辅助功能权限属于高危系统权限,可能被恶意利用监控用户输入
  • 命令通过键盘事件注入,特殊字符转义不当可能导致意外操作
  • 截图功能可能捕获敏感信息(API 密钥、代码片段),需严格管理存储路径
  • "Pro Features" 中的远程 SSH 控制若实现不当,将显著扩大攻击面

Claude Code Control 内容

examples文件夹
手动下载zip · 24.8 kB
run-atlas-tests.jstext/javascript
请选择文件