Codebuff：把整个 AI 编程团队装进你的终端，5.1K Star 的多智能体协作方案

标签: AI编程 / 开源项目 / 多智能体 / TypeScript / CLI工具
原文: 微信公众号「开源星探」https://mp.weixin.qq.com/s/vjFSF-t9vNHSDVpVJgC1NA

核心亮点

Codebuff 是一个开源 AI 编程助手，它不是用一个模型包办一切，而是用多个专业智能体协同工作——文件探索、规划、编辑、审查各司其职。在 175+ 个真实场景测试中完成率 61%，超越 Claude Code（53%）。完全免费，TypeScript 开发，支持任意模型，可在终端直接编辑代码库。

什么是 Codebuff

Codebuff 是一个开源的 AI 编程助手，允许你通过自然语言指令在终端中直接编辑代码库。

完全免费，代码质量很高，主要使用 TypeScript 开发。

核心亮点：多智能体架构

当你告诉 Codebuff 要做什么任务时，它不会直接让一个大模型去完成，而是会派不同的智能体各司其职：

这种分工协作的方式，让 Codebuff 对代码上下文的理解更好，编辑更准确，错误也更少。

性能对比

在官方测试中，Codebuff 在 175+ 个模拟真实场景的编码任务上：

• Codebuff 完成率：61%
• Claude Code 完成率：53%

工作流程详解

以"给我的 API 加上认证功能"为例，Codebuff 的完整协作流程：

1. 文件探索智能体上线
   → 扫描代码库，理解项目架构，找到相关文件
   → 查看项目结构：路由文件、控制器、配置文件

2. 规划智能体出场
   → 根据探索结果规划：哪些文件需要修改、按什么顺序修改
   → 考虑依赖关系，确保修改不会破坏现有功能

3. 编辑智能体开始干活
   → 根据规划进行精确的代码修改
   → 添加新代码的同时，确保风格与现有代码一致

4. 审查智能体最后把关
   → 验证变更是否正确
   → 运行测试确保没有引入新问题

就像一个真实的开发团队在工作，每个角色都有自己的专长，配合默契。全部在终端里完成，不需要离开命令行环境。

快速上手

安装

# 确保已安装 Node.js 和 npm
npm install -g codebuff

使用

cd your-project
codebuff

然后用自然语言告诉 Codebuff 你想做什么：

# 修复安全漏洞
"修复用户注册中的 SQL 注入漏洞"

# 添加限流
"给所有 API 端点加上限流"

# 重构代码
"重构数据库连接代码，提高性能"

Codebuff 会自动找到正确的文件，在整个代码库中进行修改，还会运行测试确保没有破坏任何东西。

CLI 选项详解

质量与性能选项

模式选项

智能体控制

调试选项

创建自定义智能体

Codebuff 最强大的功能之一是可以创建自己的自定义智能体。

codebuff init-agents

这个命令会创建一个完整的智能体开发指南在 .agents/README.md（293行），包含详细的文档、完整的示例和完整的 TypeScript 类型定义。

创建的文件结构：

.agents/
├── README.md          # 完整的 293 行智能体指南
├── my-custom-agent.ts # 可编辑的工作智能体模板
├── package.json       # NPM 包配置
├── LICENSE            # Apache-2.0 许可证（用于发布）
├── examples/          # 3 个示例智能体（基础→高级）
└── types/             # 完整的 TypeScript 定义

适用场景

1. 日常代码维护和重构 — 重构代码结构、优化性能、清理技术债务
2. 安全漏洞修复 — 快速识别并修复安全问题
3. 批量代码规则修改 — 大规模应用代码规范或架构变更
4. 团队自动化流程 — 集成到团队开发流程，自动化重复性任务
5. 新功能快速原型 — 快速实现想法，验证可行性

基本上，任何你不想自己写的代码，或者需要很多重复性工作的任务，Codebuff 都能帮上忙。

项目信息

本文整理自微信公众号「开源星探」，原文链接：https://mp.weixin.qq.com/s/vjFSF-t9vNHSDVpVJgC1NA