用途
Claude Code Wingman 是一个多会话编排器,目的是同时运行和管理多个 Claude Code 实例。每个实例在不同的项目目录中处理各自的任务,例如缺陷修复、功能开发或代理重构。用户可以通过 WhatsApp 等聊天渠道远程监控和控制所有会话。
主要能力
- 并行编排多个 Claude Code 会话,每个会话在独立的目录中工作。
- 通过统一的 wingman 脚本启动新会话或向已有会话发送新指令。
- 查看所有活跃会话的状态,包括工作中、等待审批、错误等状态。
- 在 WhatsApp 中接收会话需要审批的通知,并通过 approve、always、deny 等命令远程响应。
- 支持监控守护进程(master-monitor.sh),读取 Clawdbot 配置,定期轮询会话并发送提醒。
- 会话可通过 tmux attach 手动接管和检查。
使用方式
推荐通过 Clawdbot 安装:
clawdbot skill install claude-code-wingman
手动安装:
cd ~/code git clone https://github.com/yossiovadia/claude-code-orchestrator.git cd claude-code-orchestrator chmod +x .sh lib/.sh
启动新会话:
~/code/claude-code-orchestrator/claude-wingman.sh
--session <session-name>
--workdir <project-directory>
--prompt "<task description>"
向已有会话发送命令:
~/code/claude-code-orchestrator/claude-wingman.sh
--session <existing-session-name>
--workdir <same-directory>
--prompt "<new task>"
审批命令示例:
~/code/claude-code-orchestrator/lib/handle-approval.sh approve <session> ~/code/claude-code-orchestrator/lib/handle-approval.sh always <session> ~/code/claude-code-orchestrator/lib/handle-approval.sh deny <session>
启动监控守护进程:
~/code/claude-code-orchestrator/master-monitor.sh & ~/code/claude-code-orchestrator/master-monitor.sh --poll-interval 5 --reminder-interval 120 &
查看日志:
tail -f /tmp/claude-orchestrator/master-monitor.log
适用场景
- 需要并行处理多个项目的编码任务。
- 长时间运行、多文件修改或重复性编码工作。
- 希望通过手机远程审批和监控编码会话。
限制
- 需要 claude CLI、tmux 和 jq 环境。
- 首次在新目录运行 Claude Code 时,需要手动批准文件夹信任提示。
- 官方资料中未提供收费、价格或平台兼容性的详细信息。