给编码 agent 一张地图:省下 44% 的钱,多占 80% 的上下文
CodeGraph 把仓库一次性抽成符号与调用边的图,存进本地 SQLite,让 Claude Code、Cursor、Codex 这类 agent 问一次就拿回精确上下文。7 个仓库的测试里工具调用少 88%、成本低 44%,但作者自己在 README 里承认:长会话结束时留在窗口里的检索上下文反而多了约 80%。两头都属实。
编码 agent 进一个陌生仓库,默认动作是 grep、glob、Read,一个文件一个文件翻,靠手工把调用链重新拼出来。CodeGraph 把顺序倒过来:先把整个仓库的函数、调用边、依赖关系一次性抽成图,存进本地 SQLite,agent 问一次,直接拿回相关源码、符号之间的调用路径,还有改动的爆炸半径。
作者 colbymchenry 在 README 里给了一组数:7 个开源仓库、7 种语言、Claude Code 无头模式、每组 4 次取中位数。
- 工具调用少 88%
- token 少 62%
- 成本低 44%
- 快 53%
- 文件读取降到 0
VS Code 那个仓库大约 1.1 万个文件。带图:2 次工具调用、58 秒、15.5 万 token、0.53 美元。不带图:28 次调用、2 分 10 秒、67 万 token、1.8 美元。

反过来的那一面
README 里有一段主动披露,比上面那串数字更值得看。
在同样 7 个仓库的多轮会话里,CodeGraph 的响应在会话结束时留在上下文窗口里的检索内容,比文件读取型 agent 多出约 80%。VS Code 上是 67k token 对 18k。机制跟它快的原因同一个:它一次返回一整块密集的、逐字的源码,答完还赖在窗口里;grep 那条路是一堆小结果,进来一波,被挤出去一波。
所以“处理的 token 更少”和“常驻的占用更大”同时成立。跑长会话、窗口又不大的话,这笔账得提前算。
第二个反转:省多少钱看的是问题需要多少探索,跟仓库大小关系不大。Excalidraw 省 78%,Django 只省 13%,Gin 基本持平。作者自己的解释是,文件读取那一组需要 28 到 43 次工具调用才够得着答案的问题,省得最狠;7 到 14 次就答出来的,差距就小。
基准测试怎么挡的
两组的 codegraph CLI 都被 PATH 清洗加一个 PreToolUse 钩子挡住。不挡的话对照组会自己从 Bash 摸到 CLI。他们测过不挡的情况,28 次里有 26 次对照组找到了 CLI,把对比彻底带偏;挡上之后 28 次全部被拦,污染 0。
宣传材料里主动写这种细节的,不多。
工程上的几个取舍
解析内核用 Rust 写,20 种语言在编译好的代码里解析,每个文件只过一次边界。Linux 内核 7 万文件、200 万符号、640 万关系,在 2 核 6G 的 VPS 上 12 分钟内建完。
数据全在项目下的 .codegraph/codegraph.db,SQLite 加 FTS5,不出本机,不要 API key。文件 watcher 用系统原生事件,默认防抖 2 秒;改一个文件,在 4400 文件的仓库上大约 0.3 秒同步完,不重扫整棵树。
MCP 那边只对外暴露一个工具 codegraph_explore。作者的说法是,一个强工具比一排窄工具更不容易选错,也更省上下文。其他七个工具接口都在,默认不列出,要用 CODEGRAPH_MCP_TOOLS=explore,node,search 这类环境变量自己开。
Claude Code 上有个坑要在配置里填:alwaysLoad: true。不填的话 Claude Code 会把 MCP 工具藏在工具搜索后面,新会话里模型只看见一个名字,得先找一次才用得上。
装上跑
npm i -g @colbymchenry/codegraph
codegraph install # 自动识别并配置 Claude Code、Cursor、Codex 等
cd your-project
codegraph init # 建当前项目的图,之后自动同步
想一步到位:npx @colbymchenry/codegraph。
注意 install 和 init 是两件事:前者全局一次,后者每个项目一次。装完 CLI 不会自动建索引。

一条评论值得拎出来
推文下面有网友回了句:编码 agent 真正贵的地方是改错,而改错来自读得太少,不是读得太多。
放在这里挺对。CodeGraph 没有让模型变聪明,它只是把“理解仓库”这件事从每次现算,改成了一次建索引。agent 读得更少,但读得更准。代价是磁盘上一个 SQLite 文件,和长会话里更重的上下文。两个代价值不值,取决于你开的是什么窗口、问的是什么问题。
仓库地址:github.com/colbymchenry/codegraph,MIT 协议。
发布时间: 2026-11-19 23:40