每次用 Claude Code 或 Cursor 读项目源码的时候，你有没有过这种感觉——它像一头扎进迷宫，到处翻文件、grep、find，半天才找到你想问的东西？
说实话，看着它翻文件的那个劲儿，比自己动手查还着急。
今天 GitHub 上有个项目火得不行——CodeGraph，一夜之间攒了三千多个星。它的思路特别直白：与其让AI每次从头扫码，不如提前给整个代码库建个「知识图谱」。说白了，就像你查字典之前先看目录，效率能一样吗？
CodeGraph 是个开源的 CLI 工具，支持 Claude Code、Codex、Cursor、OpenCode、Hermes Agent 这些主流的 AI 编程助手。它做了一件事：把你项目的所有代码关系——谁调了谁、哪个函数在哪儿定义、路由跟handler怎么连的——全部提前索引好，存到本地 SQLite 数据库里。
然后呢？AI 工具通过 MCP（Model Context Protocol）协议直接读这个图，不用再一个个翻文件了。
打个比方：以前AI查代码就像去图书馆，不知道书在哪儿，只能挨个书架翻。CodeGraph 直接给了它一张精确的图书索引图，告诉你"第三排第二本"。
数据不会骗人
CodeGraph 的作者用 Claude Opus 4.7 做了 7 个开源项目（VS Code、Excalidraw、Django、Tokio、OkHttp、Gin、Alamofire）的对比测试，每个项目跑 4 轮取中位数，结果挺惊人的：
平均下来：
• 费用省了 35%
• Token 少了 57%
• 速度快了 46%
• 工具调用少了 71%
具体到项目，差别更夸张。Excalidraw（约 640 个文件）：不用 CodeGraph 的时候，AI 狂调了 79 次工具才答完问题；配上 CodeGraph，只用了 3 次。Tokio 的 Rust 代码库也是——费用从 0.42，降了 82%。
说白了，项目越大，收益越明显。VS Code 那种十万个文件量级的项目，工具调用从 55 次降到了 8 次。
怎么做到的？
CodeGraph 的核心就是预索引。它用了一个叫 Tree-sitter 的解析器来理解代码的语法结构，跑一次就能把整个项目的以下信息全扒出来：
• 符号关系：函数、类、变量之间的引用
• 调用图：谁调了谁，整个调用链路
• 路由映射：Web 框架的 URL 路径跟对应 handler 的关联
• 影响分析：改一处代码，会影响哪些地方
而且它不是一次性跑完就完——它有文件监听器，用操作系统原生的文件事件（macOS 的 FSEvents、Linux 的 inotify、Windows 的 ReadDirectoryChangesW），你改代码它就自动更新图，不用再手动触发。
支持的语言有 19 种以上：TypeScript、JavaScript、Python、Go、Rust、Java、C#、PHP、Ruby、C、C++、Swift、Kotlin、Dart……基本上常用的都有了。
Web 框架方面更细，Django、Flask、FastAPI、Express、NestJS、Laravel、Spring、Gin 等等 14 个框架的路由都能识别。
上手简单到离谱
安装就一行命令：
curl -fsSL https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.sh | sh
或者用 npm 也行：
npx @colbymchenry/codegraph
然后进项目目录跑个初始化：
cd your-project
codegraph init -i
安装器会自动检测你有没有装 Claude Code、Cursor 之类的工具，然后帮你配好 MCP 服务器。整个过程交互式的，选几个选项就行。
配好之后重启你的 AI 助手，它就知道怎么用这个知识图谱了。
哦对了，100% 本地运行，数据不出机器，不需要 API Key。这一点对做安全敏感项目的人来说挺重要的。
一点个人感受
我个人觉得这个项目的思路其实挺有意思的——它不是在卷模型能力，而是在卷上下文质量。
现在的 AI 编程助手再强，如果读代码的方式还是 grep+Read 那一套，大项目里照样抓瞎。CodeGraph 这种"先建索引再查询"的思路，本质上跟数据库里加索引没有区别——不改变查询逻辑，但让查询快了几个数量级。
而且说实话，它支持的 19 种语言和 14 个框架路由识别，这个覆盖面已经够日常项目用了。对于个人开发者做大中型项目，或者团队引入 AI 编程工具的场景，这个东西真的能省不少钱——API 调用费是按 token 算的，少调一次就是省一笔钱。
目前它跟 Claude Code 的集成最完善，Cursor 和 Codex 也支持得不错。如果你是重度 AI 编程助手用户，建议试试。
你在项目里用过类似的工具吗？或者有没有踩过 AI 助手在大项目里找不到北的坑？评论区聊聊 🖋️
