claw-forge CLI

使用 claw-forge CLI 运行自主编码代理完成项目开发,直至所有功能通过。涵盖完整工作流:init → spec → plan → run → status → ui。

安装

概览

什么是claw-forge CLI

claw-forge CLI 是一个多提供商自主编码代理框架,专为高效、可靠地完成完整项目开发而设计。它通过并行运行的多个编码代理协同工作,自动推进项目从初始化到最终验收的整个流程。核心理念是让代理持续工作,直到所有功能特性都通过测试或用户主动停止。该工具集成了完整的开发工作流,包括项目初始化、需求规格编写、任务规划、代理执行、进度监控和可视化看板等多个环节,形成一个闭环的自动化开发环境。

与传统的 AI 编程工具不同,claw-forge 强调结构化流程和依赖管理。它通过依赖有向无环图(DAG)来组织功能特性之间的先后关系,确保复杂项目的正确构建顺序。系统默认使用 Claude Opus 进行关键的任务规划阶段,因为规划质量直接决定最终产出质量。同时支持多种编辑模式,其中 hashline 模式特别适合资源有限的模型,能显著提升代码修改的成功率。

该工具提供了丰富的配置选项和运行策略,支持成本优化、多提供商故障转移、批量并发处理等高级功能。无论是从零开始的绿色场项目,还是为现有项目添加新功能的棕色场场景,都能提供相应的解决方案。配套的 Kanban UI 界面让用户能够实时监控代理活动、查看成本统计和依赖关系,极大提升了大型项目的可视化管理能力。

核心功能特点

  1. 完整工作流集成:从项目初始化到最终验收的全流程自动化
  2. 智能依赖管理:基于 DAG 的功能特性依赖关系规划和执行控制
  3. 多代理并行协作:支持多个编码代理同时工作,提高开发效率
  4. 灵活配置策略:支持优先级路由、轮询和最低成本等多种提供商调度方式
  5. 双模编辑支持:提供 str_replace 和 hashline 两种代码修改模式,适配不同模型能力
  6. 实时进度监控:内置状态检查和 Kanban 看板,直观展示项目进展和成本信息

适用场景

claw-forge 特别适合需要快速交付完整功能的项目场景,尤其是那些具有明确需求但实现复杂度较高的应用开发。对于初创团队或独立开发者来说,它可以大幅缩短从想法到可运行产品的周期,避免传统开发中常见的规划不足和执行偏差问题。例如,一个需要用户认证、数据管理和实时展示的 Web 应用,可以通过编写清晰的需求规格文件,让 claw-forge 自动生成并实现所有必要的功能模块。

在团队协作环境中,claw-forge 的依赖管理和进度跟踪功能特别有价值。当多个功能特性存在前后依赖关系时(如必须先完成数据库设计才能实现 API 接口),系统会自动安排正确的执行顺序,避免人工协调带来的混乱。企业用户还可以利用其多提供商支持和成本优化策略,在保证质量的同时控制 API 调用费用。夜间批量运行模式也适合需要长时间迭代的大型项目。

对于现有项目的功能扩展(棕色场场景),claw-forge 提供了专门的 add 命令来处理。无论是为成熟产品添加 OAuth2 登录功能,还是为遗留系统增加新的报表导出能力,都可以通过编写补充规格文档来实现。其 bug 修复协议采用红绿测试先行原则,确保每次修改都有明确的验证标准,降低引入新问题的风险。这种结构化的方法特别适合对稳定性要求较高的生产环境项目。