项目卡片
- 项目:CodeGraph[1]
- 状态:v0.9.5 / 27,400+ Star / 周下载 44,000+ / 2026-01 创建,快速增长中
- 一句话判断:AI 编码助手的"预建搜索引擎"——让 Claude Code、Cursor 等工具不再用 grep 一行行扫描代码,而是直接查图谱。
你有没有觉得 AI 编码助手越来越慢?用 Claude Code 理解一个中等规模项目时,它会启动 Explore 子代理,用 grep、glob、Read 一轮轮扫文件。每次工具调用都消耗 token,几次下来成本和时间都上去了。
我之前做过一个测试,在一个 3000 多文件的 Python 项目上问一个架构问题,Claude Code 光是"找代码"就花了 50 多秒,跑了 19 次工具调用。大部分 token 花在了定位正确的文件上,而非理解代码本身。
根本原因是:AI 每次都在"大海捞针"——没有预先整理好的代码地图,只能靠穷举。
CodeGraph 做的事情很直接:在 AI 问问题之前,先把代码结构整理好,存成一张图谱。AI 查图谱,一两次调用就能拿到答案。
它到底怎么省?CodeGraph 官方在 7 个真实开源项目上做了对比测试,用的是 Claude Opus 4.7,每个场景跑 4 次取中位数:
| 项目 | 规模 | 省费用 | 省时间 | 省工具调用 |
|---|---|---|---|---|
| VS Code | ~10k 文件 | 26% | 52% | 85% |
| Excalidraw | ~640 文件 | 52% | 73% | 96% |
| Django | ~3k 文件 | 12% | 19% | 53% |
| Tokio | ~790 文件 | 82% | 71% | 92% |
| Gin | ~110 文件 | 21% | 27% | 40% |
整体平均:35% 更便宜、46% 更快、71% 更少工具调用。
规律很清楚:项目越大,收益越高。VS Code 这种万文件级别的大型项目,工具调用从 55 次降到 8 次。Tokio 最夸张,82% 的费用下降。小项目本身就搜得快,Gin 大概 150 个文件,差距就小多了。
关键机制在于——没有 CodeGraph 时,AI 会先花大量 token 在"找文件"上:找到正确的文件、找到正确的函数、理清调用关系。CodeGraph 把这些信息提前索引好了,AI 直接查就行。
三分钟上手安装只需要一条命令,不需要 Node.js:
## macOS / Linuxcurl -fsSL https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.sh | sh
安装器会自动检测你装了哪些 AI 编码工具(Claude Code、Cursor、Codex CLI、Gemini CLI 等),然后帮你配置好 MCP server 和指令文件。
如果你已经有 Node.js,也可以直接用 npm:
npx @colbymchenry/codegraph
我试了一下交互式安装,过程很流畅——它会问你装哪些 agent、配置是全局还是项目级,然后自动写好所有配置文件。不用手动编辑 JSON。
装好后,进入你的项目,执行初始化:
cd your-projectcodegraph init -i
这会分析整个代码库,建立知识图谱索引。首次索引一个中等项目大概几十秒,取决于代码量。完成后重启你的 AI 工…