Claude Code Wingman

🎯 零成本自动化编码,释放API预算

dev-tools榜 #43

将Claude Code代码任务分流至tmux后台运行,利用免费/工作API节省个人Anthropic预算,适合长耗时编程任务。

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

使用说明

核心用法

Claude Code Wingman 是一个成本优化型自动化技能,通过在本地tmux会话中启动独立的Claude Code实例,将代码执行任务从Clawdbot的对话通道分流至免费或企业提供的Claude Code API。

典型工作流程:
1. 用户提出代码需求(修复bug、重构、新增功能)

2. Clawdbot调用wingman脚本,在指定工作目录创建命名tmux会话

3. 自动审批器(auto-approver)后台运行,自动处理权限提示

4. Clawdbot定期捕获tmux输出汇报进度

5. 用户可随时attach介入查看或接管

6. 任务完成后更新TOOLS.md记录会话历史

关键命令:

  • 启动会话:claude-wingman.sh --session <name> --workdir <dir> --prompt "<task>"
  • 监控进度:tmux capture-pane -t <session> -p -S -100
  • 查看日志:cat /tmp/auto-approver-<session>.log
  • 终止会话:tmux kill-session -t <session>

显著优点

  • 成本效益显著:将消耗API额度的代码任务转移至免费/工作Claude Code API,个人$20/月预算可专注于对话场景
  • 会话持久化:tmux后台运行,网络中断或终端关闭不影响任务执行
  • 并行处理能力:支持同时运行多个命名会话处理不同项目任务
  • 自动权限处理:内置auto-approver自动响应Claude Code的权限提示,减少人工干预
  • 透明可控:用户可随时attach查看实时输出,随时介入或终止

潜在缺点与局限性

  • 首次信任确认:新目录首次运行需用户手动attach并确认文件夹信任(一次性)
  • 交互能力受限:tmux中的Claude Code无法像Clawdbot对话那样进行多轮澄清和迭代讨论
  • 调试复杂性:任务失败时需通过tmux日志排查,不如直接对话直观
  • 环境依赖:依赖本地tmux和claude命令行工具,配置环境要求较严格
  • 安全风险:auto-approver自动批准权限操作,存在意外执行高风险指令的可能

适合人群

  • 拥有免费/企业Claude Code访问权限但个人Anthropic API预算有限的开发者
  • 需要批量处理重复性编码任务(如大规模重构、模板生成)的技术人员
  • 熟悉tmux和命令行工作流、追求成本优化的资深工程师
  • 运行长耗时任务且需要会话持久化的场景

常规风险

  • 自动执行风险:auto-approver机制可能批准破坏性操作(如删除文件、修改配置),建议在版本控制完善的环境中使用
  • 会话管理遗漏:长期运行的tmux会话可能占用系统资源,需定期清理
  • 工作目录混淆:多并行会话时,--workdir参数错误可能导致代码变更位置错误
  • 信任边界模糊:首次文件夹信任确认后,后续自动执行降低了人工审查门槛
  • 日志敏感信息:auto-approver日志可能记录任务细节,多用户环境需注意权限设置

Claude Code Wingman 内容

手动下载zip · 2.8 kB
README.mdtext/markdown
请选择文件