CodeBuddy 对比 HagiCode: 功能与差异

HagiCode 是一款提案驱动的 AI 编码工作台,可将需求转化为可审阅的提案,通过 Claude Code、Codex、GitHub Copilot 等 Agent CLI 执行,并把结果沉淀为团队知识。

CodeBuddy Code 是腾讯云的终端编程 Agent,可通过 npm、Homebrew 或原生二进制安装。HagiCode 是桌面工作台,把 CodeBuddy 当作执行器运行,并在外面补上并行会话、提案和 AI 提交。

安装 HagiCode 桌面版

简体中文2026-10-16

简短结论

CodeBuddy Code 是腾讯云 CodeBuddy 产品线里的命令行编程 Agent,这条产品线还包括 IDE 和编辑器插件。HagiCode 是桌面和网页端的工作台,把 CodeBuddy 当作执行器之一来运行。它不替代 CodeBuddy,也不托管模型。

如果你想要终端里的 Agent、用自己的 CodeBuddy 账户、一次只做一件事,单用 CodeBuddy 就够了。当你想同时跑多个 CodeBuddy 任务、在改代码前先有书面提案,或者在一个工作区里管理多个仓库时,再考虑 HagiCode。

CodeBuddy 与 HagiCode 一览

对比项CodeBuddy CodeHagiCode
它是什么

腾讯云的终端 AI 编程 Agent,同系列有 CodeBuddy IDE 和编辑器插件

运行 Agent CLI(包括 CodeBuddy)的桌面和网页工作台,本身不是模型也不是 Agent

界面与平台

终端,另有用于脚本的 -p;原生二进制支持 macOS、Linux、Windows(测试版),也可用 npm 或 Homebrew

Windows、macOS、Linux 桌面端;Docker Compose 容器版;微软商店版

价格与授权

免费、Pro(约 10 美元/月)、Team(约 40 美元/席位)三档,按积分计费;截至 2026 年 10 月,来自腾讯云计费页面

桌面版和容器版免费;商店版基础功能免费,可选一次性购买 TurboEngine

模型与来源

模型随 CodeBuddy 账户和站点而定;可通过 models.json 接入兼容 OpenAI 接口的额外模型

不托管模型,使用你 CodeBuddy 已登录的账户;可选 OmniRoute 模型目录

并行工作

会话内有子 Agent,ACP 里还暴露 Agent Teams

多个会话并排运行,每个以 Agent 形式显示状态

规格与规划流程

有计划权限模式,/init 生成项目上下文,另有 hooks 和 skills

OpenSpec 提案:提出、校验、应用、归档;免费版允许 3 个并发提案

Git 与提交

内置 Git 操作,可在终端里生成提交信息

AI 生成提交,提交时锁定仓库,Monospecs 可按仓库定位

上手成本

用 npm、Homebrew 或脚本安装一次,再登录国内站、国际站或企业站点

要先装好并登录 CodeBuddy,再装 HagiCode 桌面版

最适合

腾讯云生态内的终端用户、脚本和 CI

并行任务、提案驱动的开发和多仓库项目

CodeBuddy 的长处

多种安装方式

CodeBuddy Code 可以用 npm install -g @tencent-ai/codebuddy-code 安装(需要 Node.js 18.20 或更高版本),也可以用 Homebrew:brew install Tencent-CodeBuddy/tap/codebuddy-code。测试版原生二进制完全不需要 Node.js,已用 npm 安装的用户可运行 codebuddy install 迁移过去。

命令是 codebuddy(文档里也提到别名 cbc),用 codebuddy --version 检查。codebuddy update 用于升级,自动更新默认开启。

按地区和组织登录

首次启动时要选择登录位置:国内站、国际站、面向专属部署的企业域名,或仅限腾讯员工的 iOA。国内站和国际站提供的模型不同,所以在比较模型之前,先确认你的账户属于哪一个。

可脚本化,权限可控

codebuddy -p 运行单条提示并支持管道输入,适合放进 shell 流水线,例如 cat error.log | codebuddy -p "..."。Shift+Tab 可在默认、绕过、接受编辑和计划几种权限模式之间切换,需要读写文件或执行命令的非交互运行则用 -y 跳过确认。

扩展性与企业场景

文档涵盖 MCP 服务器、子 Agent、插件、skills、hooks、Python 和 TypeScript SDK、GitHub Actions 以及网页界面。可以在 ~/.codebuddy/models.json 或项目内添加模型,企业部署还可以容器化。codebuddy --acp 会把它作为 ACP 服务运行,带有上下文窗口选项和 Agent Teams 状态,HagiCode 用的正是这个接口。

什么时候选 CodeBuddy,什么时候选 HagiCode

这些情况继续用 CodeBuddy

  • 你习惯在终端里工作,一次处理一件事就够;
  • 你已经处在腾讯云生态里,或使用企业版 CodeBuddy 域名;
  • 你想用 codebuddy -p、管道输入或 GitHub Actions 跑脚本化任务;
  • 你想要最轻的方案:用 Homebrew 或原生二进制安装,不多装应用;
  • 你更喜欢它自带的权限模式、hooks 和插件,而不需要另一个工作台。

这些情况选 HagiCode

  • 你同时跑多个 CodeBuddy 任务,想在一个视图里看全;
  • 你想让 Agent 改代码前先有经过评审的提案,完成后归档;
  • 一个 CodeBuddy 任务需要改动多个仓库,你想一次规划好;
  • 你想让 CodeBuddy 的改动用生成的提交信息提交,并且不必切到别的编辑器;
  • 你把 CodeBuddy 和其他 Agent CLI 搭配使用,想在一个工作区里管理。

把 CodeBuddy 和 HagiCode 一起用

HagiCode 架在 CLI 之上。它通过 ACP 启动你已安装的 CodeBuddy,账户、地区和积分都留在 CodeBuddy 那边,HagiCode 不会接管它的登录。

没有任何绑定。仓库和你的 .codebuddy 设置都在原处,随时可以在同一个项目里运行 codebuddy。

  • 用 npm、Homebrew 或原生安装器安装 CodeBuddy Code,并用 codebuddy --version 确认。
  • 运行一次 codebuddy,在与你账户对应的站点(国内站、国际站或企业站点)登录。
  • 安装 Windows、macOS 或 Linux 版 HagiCode 桌面端,也可用 Docker Compose 版或微软商店版。
  • 在 HagiCode 的 Agent CLI 设置里把 CodeBuddy 选为执行器;HagiCode 会在 PATH 中查找 codebuddy 命令。
  • 打开仓库,开始会话或 OpenSpec 提案;CodeBuddy 的工具调用会显示在 HagiCode 的统一视图里。
  • 想回去时,关闭 HagiCode,在同一目录运行 codebuddy 即可,无需还原任何设置。

HagiCode 在 Agent 之上增加了什么

并行会话与 Agents 管理

每个 CodeBuddy 会话都是一个有独立上下文和状态的 Agent,而不是又多开一个运行 codebuddy 的终端。当你要在多个目录里同时启动任务时,这一点最有用。

OpenSpec 提案

任务可以从一份提案开始,经过提出、校验、应用和归档。CodeBuddy 在提案范围内实现,提案则保留了终端滚动记录里留不住的思路。

AI 提交与 Code Server

HagiCode 根据 CodeBuddy 的改动起草提交信息,并在提交期间锁定仓库。内置的 Code Server 编辑器在对话旁边打开 CodeBuddy 改过的文件。

Monospecs 与 Vault

Monospecs 列出多仓库工作区里的所有仓库,让 CodeBuddy 的任务看到全貌。Vault 把参考项目和笔记留给后续会话,包括新启动的 codebuddy 进程。

模型路由、工具调用视图与用量

CodeBuddy 的工具调用以与其他 CLI 相同的结构化形式显示,实时和历史一致。OmniRoute 可为每个 Agent CLI 提供模型目录,可选的 TokenMonitor 状态栏会显示今日的 Token 与费用。

结论

  • CodeBuddy Code 是终端里的 Agent,HagiCode 是运行它的工作台。
  • 个人、单任务或脚本化场景只用 CodeBuddy;需要并行任务、提案和多仓库改动时再加 HagiCode。
  • 前提是先装好并登录 CodeBuddy,而且随时可以退回直接运行 codebuddy。

常见问题

CodeBuddy Code 怎么安装?

运行 `npm install -g @tencent-ai/codebuddy-code`(需要 Node.js 18.20 或更高版本),macOS 和 Linux 也可用 `brew install Tencent-CodeBuddy/tap/codebuddy-code`。测试版原生二进制不需要 Node.js。然后运行 `codebuddy --version` 和 `codebuddy` 完成登录。文档见 codebuddy.ai/docs/cli/installation。

CodeBuddy 免费吗?

CodeBuddy 有每月积分有限的免费套餐,另有 Pro 和 Team 套餐(截至 2026 年 10 月,Pro 约 10 美元/月,Team 约 40 美元/席位)。腾讯云的计费页面没有写明哪些套餐包含 CLI,依赖免费档之前请先确认。

CodeBuddy 能和 HagiCode 一起用吗?

可以。先安装并登录 CodeBuddy Code,再在 HagiCode 里选它作为 Agent CLI。HagiCode 通过 ACP 驱动它,你的账户和积分仍由 CodeBuddy 管理。

HagiCode 会取代 CodeBuddy 吗?

不会。HagiCode 把 CodeBuddy 当执行器,在外面补上会话、提案、提交和多仓库工具。你仍可在同样的仓库里直接运行 `codebuddy`。

CodeBuddy 的命令是什么?

命令是 `codebuddy`,文档里还提到简写别名 `cbc`。npm 包名是 @tencent-ai/codebuddy-code。

CodeBuddy 和 HagiCode 该选哪个?

终端、个人或脚本化场景单用 CodeBuddy。想在 CodeBuddy 之上获得并行会话、OpenSpec 提案或多仓库工作区时,再加上 HagiCode。

桌面版

本地化的 AI 代码助手,保护隐私,提升效率