Claude Code Wingman

🦅 WhatsApp 遥控 AI 编程助手

dev-tools榜 #43

将 Claude Code 集成到 WhatsApp,实现远程任务下发、实时审批和进度追踪,让 AI 编程助手随身可控

收藏
8.8k
安装
3.6k
版本
0.2.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

Claude Code Wingman 是一款桥接工具,将 Anthropic 的 Claude Code CLI 与 Clawdbot(WhatsApp 机器人框架)打通。用户通过 WhatsApp 聊天即可向 Claude Code 下发编程任务,并在需要审批时收到即时通知。

工作流程:
1. 用户发送自然语言指令(如"修复 api.py 中的认证 bug")

2. Clawdbot 在后台启动 tmux 会话,运行 Claude Code

3. 当 Claude Code 需要执行敏感操作(编辑文件、运行命令等)时,通过 WhatsApp 向用户请求批准

4. 用户回复"允许"或"拒绝",Clawdbot 将决策转发给 Claude Code

5. 任务完成后,结果返回 WhatsApp 聊天窗口

实时监控: 用户可随时通过 tmux attach 命令接入会话,直接观察或干预 Claude Code 的执行过程。

显著优点

  • 移动端友好:无需打开终端或 IDE,在 WhatsApp 中即可完成复杂编程任务的委托和审批
  • 安全可控:所有危险操作(文件修改、命令执行)均需显式人工批准,避免 AI 自主造成的意外
  • 异步协作:任务在后台 tmux 会话中持续运行,用户可随时查询状态或接管控制
  • 零配置接入:通过 Clawdbot 插件机制安装,复用已有的 Claude Code 认证和配置

潜在缺点与局限性

  • 依赖 tmux:会话管理完全依赖 tmux,若 tmux 崩溃或服务器重启,未保存的状态可能丢失
  • 单会话限制:未明确支持多任务并行管理,复杂场景下可能出现会话冲突
  • 审批延迟:WhatsApp 消息往返存在延迟,对需要快速迭代的高频交互任务不够流畅
  • 终端渲染限制:tmux capture-pane 获取的文本输出可能丢失颜色、布局和交互元素,影响问题诊断
  • 权限边界模糊:Clawdbot 本身拥有启动 Claude Code 的权限,一旦通过初始审批,后续子操作的权限委托链条较长

适合人群

  • 需要在外出时监控或干预 AI 编程任务的开发者
  • 希望为团队建立"AI 助手操作审计和人工把关"流程的技术负责人
  • 已使用 Claude Code 且希望扩展其触达场景(移动设备、IM 工具)的现有用户

常规风险

| 风险类型 | 说明 |
|---------|------|
| 会话劫持 | tmux 会话若未妥善保护,多用户系统上可能被其他用户 attach |
| 凭证泄露 | Clawdbot 与 Claude Code 的集成可能涉及 API key 或会话 token 的传递存储 |
| 误操作放大 | 移动端的快速回复可能导致未经仔细审查的批准决策 |
| 网络依赖 | WhatsApp 连接不稳定时,审批流程中断可能导致 Claude Code 长时间等待 |
| 日志残留 | tmux 输出历史可能包含敏感代码或数据,需定期清理

Claude Code Wingman 内容

clawdbot-skill文件夹
test-project文件夹
手动下载zip · 14.1 kB
README.mdtext/markdown
请选择文件