它瞄准的 token 问题
当 Claude Code 这类编程智能体探索一个陌生仓库时,它派出辅助智能体用 grep、glob、Read 扫文件。每一次都是一次工具调用,而每次工具调用都花 token 和延迟。CodeGraph 的赌注是:这些探索里大部分,是在重新发现本可以一次性索引下来的结构。它提前建一张语义代码图,经 MCP 喂给你的智能体,于是智能体查一个索引、而不是反复重读目录树。
项目报告的收益是大约便宜 16%、工具调用减少约 58%,而且 100% 本地跑。把这些当成维护者测得的数字、而非对你代码库的保证,但机制是站得住的:查一张预建的图,比爬一次实时文件系统更便宜。
什么让它实用
- 本地且自包含。 索引存在你项目里的
.codegraph/目录,CLI 自带运行时,所以没什么要编译、也没有原生构建。 - 广泛的智能体支持。 一条命令把 CodeGraph MCP server 接进 Claude Code、Cursor、Codex CLI、opencode、Hermes Agent、Gemini CLI、Antigravity IDE 和 Kiro。
- 可逆。 一条卸载命令从它碰过的每个智能体里剥掉 MCP 配置,项目索引单独移除,所以采用它是低承诺的。
安装
用对应系统的一行命令拿到 CLI,无需 Node.js:
# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.sh | sh
# Windows (PowerShell)
irm https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.ps1 | iex如果你已经在跑 Node,npm i -g @colbymchenry/codegraph 在任意版本上都行。安装器把 codegraph 放上 PATH,但不改你当前的 shell,所以下一步前先开一个新终端。
接线并建索引
装上 CLI 本身并不会把它连到任何东西。在一个新终端里跑智能体安装器,然后按项目建索引:
codegraph install
cd your-project
codegraph init -icodegraph install 检测并配置每个受支持的智能体。codegraph init 创建本地 .codegraph/ 目录,-i 标志在同一步里也建好初始图;不加它,之后跑 codegraph index 来填充。更新用 codegraph upgrade 原地完成,它会检测你的安装方式。
该知道的糙边
CodeGraph 跑一个后台 daemon,而讨论最热的 closed issue 都是关于这个 daemon 在桌面上的行为:一个烦人的终端窗口弹出来,以及在 Windows 上 daemon 进程闪出黑色控制台窗口。尤其如果你在 Windows 上,预期自己会撞上并要处理这一类问题,按你的版本查 tracker。这是个 1.0 之前的工具(2026 年 6 月 v0.9.9),截至 2026-06 有 211 个 open issue,所以核心能用、边角还在打磨。还有一个实际点:这张图是建索引那一刻代码的快照,所以代码漂移时你要重跑 codegraph index 刷新它,否则智能体最终查的是一张过时的地图。
也值得知道:项目有个托管产品在路上(getcodegraph.com),所以这个开源 CLI 旁边坐着一个未来的付费平台。没有东西逼你上它,但这是该留意的商业形态。
CodeGraph 与 Understand Anything 的对比
| codegraph | Understand Anything | |
|---|---|---|
| Stars | 46,365 | 56,235 |
| 消费者 | 智能体,在运行时 | 人,在仪表盘里 |
| 输出 | MCP 提供的索引 | 交互式可视化图 |
| 目标 | 更少工具调用与 token | 学懂一个陌生代码库 |
计数取自 GitHub,截至 2026 年 6 月。两者都建一张代码知识图,但面向不同受众。Understand Anything 渲染一个可视化仪表盘,给人去探索、学懂一个代码库。CodeGraph 把图喂给智能体,让它花更少代价做同样的活。它们更多是互补、而非竞争:一个帮你理解代码,另一个帮你的智能体便宜地导航代码。
相关
CodeGraph 接进的智能体,正是 cc-switch 帮你配置的那些,也接进 Hermes Agent。想看还有什么在往上爬,见 LLM 工具、每日速报和周报。
FAQ
CodeGraph 到底做什么? 它把你的代码库预索引成一张语义图,经 MCP 喂给编程智能体,于是它们查索引、而不是反复 grep 和读文件。
我的代码会被发到哪里吗? 不会。README 声明它 100% 本地跑,索引存在你项目里的 .codegraph/ 目录。
它支持哪些智能体? Claude Code、Cursor、Codex CLI、opencode、Hermes Agent、Gemini CLI、Antigravity IDE 和 Kiro,都由 codegraph install 配置。
为什么老有终端窗口弹出来? 那是它的后台 daemon,也是报告最多的问题之一,尤其在 Windows 上。按你的版本查 tracker 的修复。