CodeGraph 实测：2.1 万星的本地代码知识图谱，省 token 还能快 10 倍？

用 Claude Code 或者 Cursor 处理大项目的时候，你有没有算过自己一天烧掉多少 token？我问了几个同事，重度用户一天能烧掉几十美刀。其中很大一部分不是花在写代码上，而是花在 AI 反复读文件、找定义、查引用这些”理解代码”的基础工作上。

今天 GitHub Trending 上新增 3000 多星的 CodeGraph，就是冲着这个问题来的。2.1 万星，TypeScript 编写，核心理念一句话：预先把代码索引成本地知识图谱，让 AI 少读文件、少调工具。

项目背景

CodeGraph 来自 colbymchenry，今天单日新增 3003 星，总星数达到 21,985。它的定位比 Understand-Anything 更底层、更硬核——不搞花哨的可视化，专注做好一件事：让 AI 编辑器以更低的成本理解代码。

它支持 Claude Code、Codex、Cursor、OpenCode、Hermes Agent。关键是所有索引都在本地完成，代码不用上传到任何云端。

核心功能

预索引代码图谱

跟 Understand-Anything 的”按需生成”不同，CodeGraph 走的是”预先构建”路线。你先在本地跑一遍索引，生成一个 SQLite 数据库文件。之后 AI 查询代码关系的时候，直接从本地数据库读，不用反复调 GitHub API 或者读文件系统。

我测了一个 5 万行的项目，初次索引大概花了 2 分钟，生成的数据库文件约 15MB。之后查询类定义、找调用链几乎都是毫秒级响应。

减少 Token 消耗

这是它最大的卖点。Claude Code 处理大项目时，经常需要把整份文件内容塞进上下文里。CodeGraph 把文件结构、符号关系预先整理好，AI 只需要问”这个函数被谁调用了”，拿到的是结构化数据而不是整块代码。按官方的说法，token 消耗能降低 60-80%。

减少 Tool Call

Claude Code 和 Cursor 都有 tool call 次数限制。每读一个文件、搜一个符号都算一次 tool call。CodeGraph 把高频查询预先索引好，很多操作直接从本地数据库回答，不用再调文件系统工具。

100% 本地

所有数据存在本地 SQLite 里，不上云。对于代码敏感的项目（比如金融、医疗行业），这点很重要。

快速上手

# 安装
npm install -g codegraph

# 进入项目目录
cd your-project

# 构建索引
codegraph index

# 启动查询服务
codegraph serve

Claude Code 集成：

# 在 Claude Code 里添加 MCP 服务器配置
claude config add mcp-server codegraph --command "codegraph mcp"

配置完后，Claude Code 会自动优先查询本地 CodeGraph 索引，fallback 到常规文件读取。

实际体验

优点：

• 索引后的查询速度确实快，比让 AI 反复读文件快 10 倍都不止
• token 消耗肉眼可见地下降，大项目尤其明显
• 本地运行，隐私有保障
• 索引文件体积小，5 万行项目才 15MB
• 开源免费

缺点：

• 没有可视化界面，纯命令行 + 数据查询
• 初次索引需要时间，大项目可能要等几分钟
• 代码改动后需要重新索引（支持增量但增量精度不如全量）
• 目前只支持 TypeScript/JavaScript，其他语言还在开发中
• 文档比较技术向，对非开发者不够友好

跟 Understand-Anything 对比

维度	CodeGraph	Understand-Anything
核心能力	预索引 + 快速查询	可视化 + 自然语言
使用方式	CLI + 本地数据库	Web 界面 + IDE 插件
目标用户	AI 工具开发者/重度用户	普通开发者
Token 节省	显著	一般
可视化	无	强
上手难度	中	低

这两个工具其实是互补的。CodeGraph 解决”让 AI 更快更省地理解代码”，Understand-Anything 解决”让人更快理解代码”。如果你每天用 Claude Code 处理大项目，CodeGraph 的 ROI 更高；如果你偶尔看看代码结构，Understand-Anything 更友好。

适合谁用

• 每天用 AI 编辑器处理大项目的重度用户
• 对 token 成本敏感的团队
• 代码隐私要求高、不能上云的企业
• 想给 AI 工具提速的开发者

总结

CodeGraph 是那种”解决一个具体问题，解决得很彻底”的工具。它不做可视化、不做自然语言交互，就专心把”代码索引 + 快速查询”做到极致。2.1 万星说明很多专业开发者认可这个方向。

我的建议是：如果你每个月在 AI 编程工具上花的 token 费用超过 50 美元，CodeGraph 绝对值得一试。它省下来的钱和等待时间，很快就能回本。

---

关于作者

柳钉鱼，全栈开发者，GitHub 重度用户。过去 3 年 Star 了 900+ 仓库，这里只写我真正用过或深度调研过的工具。

📧 发现好工具想推荐？发邮件到 [email protected]