用 Claude Code 写小项目的时候,可能没什么特别的感觉。但代码库一大,麻烦就来了——每次想让模型理解项目结构,它都得一个文件一个文件地扫,工具调用堆成山,速度慢不说,token 烧得也是飞快。
最近发现一个开源工具叫 CodeGraph,思路很直接:提前为你的代码库构建一张语义知识图谱。函数调用链、类继承关系、模块之间的引用,这些全都预先解析好,存成图。之后 Claude Code 要找什么,直接在图上沿着关系链找,不用再挨个翻文件了。
效果相当明显。根据官方给出的数据,工具调用减少了 92%,探索速度提升了 71%。拿 VS Code 这么大体积的项目来测试,做代码溯源十几秒就能出结果。
除了基础的代码关系识别,它还能在你改动代码之前分析影响范围——让你看清楚动了这一处,还有哪些地方会跟着受影响。改了一处却搞垮整个模块的事,能少发生不少。
语言支持也挺广,覆盖了 19 种编程语言。框架层面还能识别 Django、Express、Spring 等 13 个常用框架的路由映射,对做 Web 开发的同学来说非常实用。
所有数据都存在本地,不依赖任何外部服务,隐私上很安心。安装就一条命令的事,装完之后文件保存会自动同步图谱,基本不用额外操心。
如果你手头的项目代码量不小,又经常用 Claude Code 做代码探索或者重构,不妨在 开源实战 中找找同类工具交叉对比,或者直接试一下 CodeGraph。省下来的时间和 token 都相当可观。
GitHub 地址:https://github.com/colbymchenry/codegraph
顺便提一句,CodeGraph 这种提前建图的思路,本质上就是把代码库的“知识”沉淀成一张知识图谱,让 AI 直接基于结构化信息推理,而不是每次都从原始文件里从头读起。这种方式在云栈社区里也有不少讨论,感兴趣可以多去看看。
|