你有没有这样的经历—用 Claude Code 或者 Cursor 看一个大项目,结果它自己在那狂读文件、跑 grep,等了半天才回你一句话?
我就经常遇到。尤其是看那些几千个文件的项目,AI 编码助手就像无头苍蝇一样到处翻,token 烧得飞快,我的API账单也在蹭蹭往上涨。
今天在 GitHub 热榜上看到的这个项目——CodeGraph,就是来解决这个问题的。今天涨了将近 3000 颗星,势头很猛。
简单说:它给你的项目建了个"知识图谱",AI 问问题直接查图,不用翻文件。
本质是个预索引的工具。你在项目根目录跑一下,它就把所有文件、函数、类之间的关系扫一遍,存到一个 SQLite 数据库里。之后 Claude Code、Cursor、Codex 这些工具来问你项目的问题时,不用再自己扫描文件了——直接从数据库里拿答案。
这就像是给 AI 配了一份项目地图。AI 原来得自己开着车在城里每条路跑一遍才知道怎么走;现在直接把地图扔给它,看一眼就知道了。
看一组数据就明白了
作者在 7 个真实项目上做了测试,对比开不开 CodeGraph 的差距:
✓ 平均成本降低 35%
✓ Token 用量减少 57%
✓ 回答速度提升 46%
✓ 工具调用减少 71%
拿 VS Code 源码(约 1 万个文件)来测:token 从 280 万降到 60 万,工具调用从 55 次降到 8 次。
注意:项目越大效果越明显。小项目(一两百个文件)提升没那么夸张,但也不会变慢。大项目才是它的主战场。
怎么装?
一条命令搞定安装:
Mac / 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
装完之后在你的项目里跑
codegraph init -i
它会自动检测你装了哪些 AI 编码工具,帮你配置好。之后重新打开你的 AI 编码助手,就能直接用了。
另外,它还自动监控文件变化——你改代码的时候它后台自动更新索引,不需要手动重新跑。
支持的编程语言有 19 种:TypeScript、JavaScript、Python、Go、Rust、Java、C#、PHP、Ruby、C、C++、Swift 等,基本上你用的它都认识。
而且 100% 本地运行,数据不离开你的电脑,不用 API Key。
跟 Understanding-Anything 的区别?
上次介绍的 Understanding-Anything 是把代码变成交互式知识图谱你可以自己拖拽看。而 CodeGraph 是给 AI 编码助手用的——它不给你看,是直接让 AI 更聪明地理解你的项目。
一个是给人看的,一个是给 AI 用的。不冲突,甚至可以一起用。
开源 MIT 协议,随便用。
我用下来的感觉:如果你的项目很大(超过 500 个文件),或者你经常用 AI 编码助手做代码理解和重构,那这个工具能帮你省下不少 API 费用。
我是龙虾,一个普通开发者。每周发现好用的开源工具,真实体验后分享给你。
夜雨聆风