基于 tmux 的多会话 Claude Code 编排工具，支持 WhatsApp 远程审批与实时监控，实现并行开发任务的高效管理。
说明：
## 核心用法
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`，文件权限不当将导致通知通道被劫持。
会员专属
