CodeGraph：让 Claude Code 少扫文件，先查代码知识图谱

用 Claude Code 跑大项目，最烦的不是它不会写代码。

是它开始“找路”。

一个问题抛进去，先 grep，再 glob，再 Read，绕一圈读十几个文件。你盯着终端看工具调用刷屏，心里大概也知道：token 又在烧了。

CodeGraph 干的事很直接。

它先给代码库建一张本地语义知识图谱，把函数调用、类继承、模块引用这些关系提前整理好。Claude Code 再探索项目时，不用一页页翻文件，而是先问这张图。

这个思路不花哨，但很对症。

README 里的测试放在 6 个真实代码库上跑，平均工具调用减少 92%，探索速度提升 71%。VS Code 这种 TypeScript 大仓库，带 CodeGraph 时 3 次工具调用、17 秒完成；不用它则是 52 次调用，耗时 1 分 37 秒。

我第一反应是：这不就是给 AI Coding 补了一个“项目导航层”。

以前 Claude Code 想搞清楚一条调用链，经常要从入口开始猜，猜错了就继续读。CodeGraph 直接把相关符号、调用方、被调用方、代码片段一起捞出来，Explore Agent 少走很多弯路。

它最适合的场景也很明确。

不是小脚本，不是 demo 项目。

而是那种你自己都得先搜半天的业务仓库：改登录流程、追接口入口、找某个 controller 被哪些路由挂着、改一个函数前看看会影响谁。

CodeGraph 还做了影响范围分析。

改代码前先查 callers、callees、impact，至少能避免那种“我只动了一处，结果半个链路炸了”的尴尬。对于重构任务，这比让模型凭感觉改要稳一点。

语言和框架覆盖也比较实用。

它支持 19 种以上编程语言，包括 TypeScript、Python、Go、Rust、Java、Swift、C++ 等；路由识别也覆盖 Django、Flask、FastAPI、Express、Laravel、Rails、Spring 等常见框架。

安装没有搞复杂。

npx @colbymchenry/codegraph 跑安装器，项目里再 codegraph init -i，之后 Claude Code 检测到 .codegraph/ 就会自动用相关工具。文件保存后，图谱也会跟着同步。

还有一点我挺喜欢：数据全在本地。

不需要 API Key，不接外部服务，底层就是 SQLite 图数据库。对于公司项目或者私有仓库，这个设定至少让人敢试。

当然，它不是让 Claude Code 突然变聪明。

更像是把“找代码”这件脏活提前做了。模型少翻文件，少猜路径，真正的上下文留给理解和修改。

如果你经常拿 Claude Code 啃大仓库，CodeGraph 这种工具就很容易有体感。

省下来的不只是几十秒。

还有那种看着 agent 在项目里乱逛时的烦躁。

GitHub地址： colbymchenry/codegraph