Codebuff与Freebuff：终端AI代码助手使用指南

基础定义与关系

Codebuff：开源（Apache-2.0）终端 AI 代码助手，采用多智能体架构，可自托管或付费订阅，核心能力是自然语言驱动全代码库编辑。
Freebuff：Codebuff 的免费广告版（MIT 协议），无订阅、无额度限制、无需 API Key，CLI 内展示广告换取免费 tokens，核心能力与 Codebuff 一致。

• GitHub： https://github.com/CodebuffAI/codebuff
• 官网： https://codebuff.com/
• 最新版本（2026-05-09）：Codebuff 1.0.0；Freebuff 0.0.80

nvm + pnpm 全局/本地安装命令与区别

全局安装

1
2

pnpm add -g freebuff
pnpm add -g codebuff

本地安装（项目内）

1
2
3
4

cd 项目目录
pnpm init -y
pnpm add freebuff
pnpm add codebuff

全局运行

1
2

freebuff
codebuff

本地运行

1
2

npx freebuff
npx codebuff

• 全局：一次安装，系统全部可用，随 nvm 切换 Node 生效。
• 本地：仅当前项目可用，无系统残留，环境隔离。

基础操作

1）启动后自动索引代码库（约 2 秒）。
2）直接输入自然语言指令，例如：

1
2

给 React 应用添加深色模式切换
修复登录组件的认证错误

3）工具自动：扫描相关文件 → 规划修改 → 编辑代码 → 运行测试 → 展示结果。
4）输入 /help 查看命令列表；/init 初始化项目配置（可选）。

Freebuff 广告体验

• 每 3–5 条消息展示 1 条轻广告（文字为主，无弹窗）。
• 广告不影响操作，无需点击，直接换取免费 tokens。

Codebuff 与 Freebuff 对比

私有化部署（去广告，Codebuff 专属）

1）克隆仓库：

1
2

git clone https://github.com/CodebuffAI/codebuff.git
cd codebuff

2）安装依赖并构建：

1
2

npm install
npm run build

3）全局链接：

1

npm link

4）使用：codebuff（无广告，无限 tokens）。

常见问题

1）Freebuff 真的无限制吗？
是的，无订阅、无额度上限、无付费墙，靠广告覆盖成本。

2）支持哪些技术栈？
全栈支持：JS/TS、Python、Java、Go、Rust、PHP 等，自动识别项目结构。

3）广告会很频繁吗？
不会，每 3–5 条消息 1 条广告，文字为主，不打断工作流。

更新日志

2026-05-24：统一标题层级，去除步骤式编号，规范列表与标点，优化段落间距，补充引言。