前言Freebuff 是一款基于命令行界面的编码工具无需订阅、API 密钥或令牌费用即可使用。可以选择以下模型DeepSeek V4 Pro 和 FlashMiniMax M3GPT-5.6 Luna一、多智能体架构Freebuff 最大的技术特色不是又换了个大模型套壳而是继承了 Codebuff 的多智能体协作架构——不是一个模型从头做到尾而是拆解成多个专职 Agent 协同工作。官方宣传的内置9 个专用子智能体subagents包括但不限于File Picker Agent扫描代码库、理解项目架构、自动定位相关文件不需要你手动 文件Planner Agent把任务拆解成有依赖顺序的分步计划Editor Agent做精确的局部编辑而不是粗暴地重写整个文件Code Reviewer代码审查子智能体会在生成后自查问题比如漏掉的 faviconBrowser-use浏览器自动化 / 联网调研Thinker-with-files (Gemini)借助 Gemini 做深度阅读与思考举个官方给的例子当你输入给我的 API 加上 JWT 鉴权时Freebuff 不会直接开始瞎写而是会依次调用 File Picker → Planner → Editor 等多个 Agent 分工完成。官方还给出了一个评测数据在覆盖 175 编程任务、多个开源仓库的内部评测集上Codebuff 以 61% 对 53% 的成绩跑赢了 Claude Code该数据来自官方 README仅供参考未见第三方复现。二、CLI 安装与上手CLI 是 Freebuff 的主打产品官网 freebuff.com/cli 给出的流程非常简单三步搞定# 1. 安装需要 Node.js 18支持 macOS / Windows / Linux npm install -g freebuff # 2. 进入你的项目目录新项目老项目都行 cd your-project # 3. 启动 freebuff不需要注册账号不需要粘贴 API Key。常用交互方式源自 GitHub READMEfilename # 文件提及精确引用某个文件 AgentName # 调用指定的专用子智能体 !command 或 /bash # 直接执行终端命令bash 模式 /history # 恢复历史对话 /theme:toggle # 切换明暗主题还支持在项目根目录放一个knowledge.md文件把项目背景、规范提前喂给 Agent减少重复解释成本。典型工作流官方推荐的完整闭环命令链是/interview → /plan → 实现 → /review即先用/interview让 Agent 反问你把需求聊清楚再/plan出方案然后让它动手改代码最后/review做代码审查——整个过程会在每次回复后给出 3 条可点击的下一步建议避免对话卡壳。三、Desktop 客户端如果你不喜欢纯终端交互freebuff.com/desktop 提供了图形化桌面客户端目前 Beta最大的差异化能力是可以同时开多个工作区、并行跑多个 Agent 任务而不是像 CLI 那样一次只能盯一个会话。下载与登录方式支持 macOSApple Silicon / Intel、Windows64位 / 老 CPU 无 AVX2 版本、LinuxAppImage用 GitHub 或 Google 账号登录即可无需 API Key目前安装包还未做代码签名macOS 上需要右键选择打开或在系统设置 → 隐私与安全里放行Windows 上如果被 SmartScreen 拦截需要点更多信息 → 仍要运行Windows 用户如果启动直接闪退、报错代码3221225501大概率是 CPU 太老2013 年前的 Intel / 2015 年前的 AMD不支持 AVX2 指令集需要换成 Older CPUs 版本四、技术架构一览进阶向如果你想更深入了解或者二次开发Codebuff 底层是完全开源的Apache 2.0仓库地址https://github.com/CodebuffAI/codebuff其中freebuff/子目录是 Freebuff 专属部分结构很简单freebuff/ ├── cli/ # CLI 构建与 npm 发布相关文件 └── web/ # Freebuff 官网从源码构建 CLI# 在仓库根目录执行 bun freebuff/cli/build.ts 1.0.0对开发者更有意义的是Codebuff 提供了codebuff/sdknpm 包允许你用 TypeScript generator 语法自定义 Agent 工作流把 AI 生成和程序化控制逻辑混合编排支持 Agent 之间互相调用spawn subagents、条件分支、多步骤流程理论上支持OpenRouter 上的任意模型不像 Claude Code 锁死在 Anthropic 生态里可以把自定义 Agent 发布到 Codebuff Agent Store供他人复用——官方的说法是Codebuff agents are the new MCP也就是说Freebuff 只是这套开源多智能体平台上面向普通开发者的一层免费封装如果你有更定制化的需求可以直接基于 Codebuff SDK 自己搭。声明实际使用时的官网信息为准。