claude-code-wingman

核心用法

Claude Code Wingman 是一款专为 Claude Code 设计的会话编排工具，通过 tmux 终端复用器实现多实例并行管理。用户可通过单一入口同时启动多个独立会话，每个会话在隔离的 tmux 窗口中运行特定项目任务，并通过 WhatsApp 接收实时状态通知与审批请求。

核心工作流包含：使用 claude-wingman.sh 脚本创建命名会话（--session）、指定工作目录（--workdir）和任务描述（--prompt）；通过 master-monitor.sh 守护进程监控所有会话状态；借助 handle-approval.sh 响应来自 WhatsApp 的批准/拒绝/始终允许指令。会话状态可通过 tmux capture-pane 实时捕获并解析，形成可视化仪表板。

显著优点

并行效率提升：突破单一会话限制，支持 VSR 修复、Clawdbot 功能开发、代理重构等多任务同步推进，显著压缩项目周期。

移动化管控：与 WhatsApp 深度集成，用户无需常驻终端即可通过移动端完成审批决策，实现"随时随地"的远程开发管理。

会话生命周期管理：提供从创建、监控、命令注入到终止的完整闭环，支持会话复用（向现存会话追加指令）和自动清理机制。

低侵入架构：基于成熟的 tmux 技术栈，不修改 Claude Code 本体，仅通过标准 CLI 接口和按键模拟实现控制，兼容性强。

潜在缺点与局限性

审批延迟风险：WhatsApp 通知依赖网络与人工响应，紧急任务可能因审批等待而阻塞；自动审批模式虽可缓解，但会牺牲安全性。

状态解析脆弱性：通过正则匹配 tmux 输出判断"工作中/等待审批/错误"状态，Claude Code 界面更新可能导致解析失效。

单点故障：master-monitor 守护进程若崩溃，将中断通知链路；当前版本缺乏进程自动恢复机制。

学习成本：用户需同时理解 tmux 会话模型、Clawdbot 配置体系和 Wingman 脚本参数，上手门槛高于原生 Claude Code。

适合的目标群体

• 多项目技术负责人：需同时推进多个代码库的重构或功能开发
• 远程/移动办公开发者：依赖手机进行开发任务审批与状态跟踪
• 自动化工作流构建者：希望将 Claude Code 集成到 CI/CD 或定时任务体系
• Claude Code 重度用户：已熟悉 CLI 操作，追求效率极致化的开发者

使用风险

进程残留风险：异常终止时 tmux 会话可能持续后台运行，消耗系统资源，需定期执行 tmux ls 审计。

命令注入隐患：--prompt 参数直接传递至 tmux send-keys，若被外部系统调用且未过滤特殊字符，存在注入可能。

敏感信息暴露：日志文件存储于 /tmp 目录，虽权限设为 600，但文件名含用户可控会话名，符号链接攻击可导致信息泄露。

自动审批副作用：--auto 模式自动选择"允许此会话的所有操作"，在不可信代码库中可能执行危险命令，建议仅用于受控环境。

配置安全依赖：Clawdbot 的 webhook token 和手机号存储于 ~/.clawdbot/clawdbot.json，文件权限不当将导致通知通道被劫持。