你的 AI 编程助手越来越慢了?试试这个 43k Star 的开源方案

事情是这样的——

最近用 Claude Code 做一个中大型项目，模块越来越多，目录结构也深了。

每次让它改代码。

然后我就看着终端里它开始忙活：grep 搜关键词、打开文件读一段、关了再 grep、再打开另一个文件……来回折腾了十几轮，等了快五分钟才给我答案。

这不是第一次了。每次问架构相关的问题，它都要把项目重新"认识"一遍，翻看很多其实跟当前问题无关的文件。

Token 在烧，时间在走，体验在掉。

慢的根源不是 AI，是缺少一份"地图"

Claude Code 或 Codex 理解代码的方式，说白了和新同事接手项目差不多——没有地图，只能挨个文件看。

它会反复调用 grep、glob、Read 去搜去找去翻。项目越大，这套动作就越重，而且每次对话都是从零开始，上次好不容易理清的调用链，这次又要重来一遍。

那换个思路：如果提前把项目的代码结构、函数调用关系、类继承链条——也就是整个代码的"骨架"——扫描出来存好，AI 每次直接查，不就不用来回翻文件了？

这就是CodeGraph干的事。

CodeGraph：给 AI 配一份项目"索引"

CodeGraph 是一个开源的代码知识图谱工具，专门为 AI 编程助手设计。

它做的事说起来不复杂：把你项目的源码提前解析一遍，提取出所有函数、类、方法、变量，以及它们之间的调用、继承、引用关系，存成一个本地的结构化数据库。AI 需要理解代码的时候，直接查这张图，而不是现场翻文件。

打个比方：就像一本书，AI 本来是靠一页页翻来找到答案。CodeGraph 相当于提前给这本书做了一份带交叉引用的目录 + 索引，翻到目录就知道答案在哪。

GitHub：https://github.com/colbymchenry/codegraph，Star 已经43k+。

支持的语言覆盖主流技术栈：TypeScript/JavaScript、Python、Go、Rust、Java、C/C++、C#、PHP、Ruby、Swift、Kotlin、Dart 等 20+ 种。

支持的 AI 工具也很全：Claude Code、Cursor、Codex CLI、OpenCode、Hermes、Gemini、Antigravity、Kiro，共 9 个。

怎么做到的？

CodeGraph 内部是一条四步管线：

AST 解析

— 用 tree-sitter 解析源码，每种语言有自己的一套提取规则，把函数、类、方法、调用关系都抽出来。

落库

— 所有符号和关系写进本地 SQLite，配上 FTS5 全文搜索，查什么都能快速命中。

关联

— 跨文件解析 import 引用，还能自动识别你项目用的框架（Express、Spring、Django、Gin 等 24 种），把路由到处理函数的链路也补上。

增量更新

— 监听文件变更，代码一改索引自动刷新，不用手动重建。

最后通过 MCP 协议把查询能力暴露给你的 AI 工具，Agent 用codegraph_explore一问就出结果。

三步上手

第一步：安装

不需要装 Node.js，CodeGraph 自带运行时。

Windows（PowerShell）：

irm https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.ps1 |iex

macOS / Linux：

curl-fsSL https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.sh |sh

有 Node 的话也能走 npm：

npx @colbymchenry/codegraph

第二步：配置 Agent

codegraph install--yes

它会自动扫描你装了哪些 AI 工具，然后帮你把 MCP 配置写进去。实测输出长这样：

◆ Claude Code: Updated ~\.claude.json

◆ Cursor: Updated ~\.cursor\mcp.json

◆ Codex CLI: Updated ~\.codex\config.toml

◆ Gemini CLI: Updated ~\.gemini\settings.json

└ Done! Restart your agents to use CodeGraph.

Windows 用户注意：装完之后如果提示 codegraph: command not found，关掉终端重开即可，安装脚本改了 PATH 需要刷新。

第三步：初始化项目

cd your-project

codegraph init -i

这一步扫描项目，建索引。我自己的一个 35 文件小项目实测：

.6s

632 个符号节点、1552 条关系边，1.6 秒完成。项目大了会久一些，几千文件大概一两分钟。

初始化完项目根目录多出一个.codegraph/文件夹（里面是 SQLite 数据库），之后重启你的 AI 工具就行了，什么都不用再配。工具检测到.codegraph/会自动用上。

怎么知道生效了？

codegraph status

看到Files indexed有数字就是建好了。在 AI 工具里问一个架构问题，如果它调了codegraph_explore而不是 grep/find，就说明在起作用。

不想用了？

codegraph uninstall

从所有 Agent 中移除配置

codegraph uninit

删除项目的 .codegraph/ 索引目录

干净利落。

一句话总结

CodeGraph 干的事就是把项目代码的"骨架"提前抽出来存好，让 AI 不用每次都现场翻文件。全本地运行，不需要联网，不需要 API key。安装 + 配置 + 初始化，三步搞定，对中小项目秒级索引完毕，对大型项目效果立竿见影。

开源免费，43k+ Star，如果你的 AI 编程助手也开始变慢了，值得一试。