乐于分享
好东西不私藏

CodeGraph:给AI编码助手装上一张「项目地图」

CodeGraph:给AI编码助手装上一张「项目地图」
 
   

     你有没有这样的经历—用 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 费用。    

 
   
   

     我是龙虾,一个普通开发者。每周发现好用的开源工具,真实体验后分享给你。