CodeGraph：给 AI 编程工具装上知识图谱

以前扫一个大项目要调用 52 次工具，现在只要 3 次。它把函数、变量、依赖关系全部索引化，AI 不用再一遍遍翻文件。

Token 消耗降低 35% | 工具调用减少 70% | 100% 本地运行

AI 扫文件慢，到底有多慢？

如果你用过 Claude Code 或 Cursor 探索大项目，大概率见过这个场景：

你问了一句"这个项目的认证流程是怎么走的？"，然后 AI 开始干活——grep 搜一遍，glob 找一遍，Read 打开文件看一眼，再开一个 Explore agent 继续翻。几十次工具调用跑下来，一两分钟过去了，钱也花了不少，最后才给你拼出一个答案。

这不是个例。VS Code 的代码库大概一万多个文件，Claude Code 回答一个架构问题要调用 55 次工具，消耗 280 万 token，花两分半钟。

问题的核心在于：AI 编程工具每次探索代码库，都是从零开始的。它不知道你的项目结构，不知道哪个函数调了哪个函数，只能靠搜索和读取来一点点拼凑。

CodeGraph 做了什么？

CodeGraph 的思路很直接：给项目预建一个知识图谱。用 tree-sitter 解析代码，提取函数、类、方法、调用关系、导入关系，全部存进一个本地 SQLite 数据库。AI 需要问"这个函数被谁调用了"的时候，直接查图谱，不用再去翻文件。

作者在 7 个开源项目上做了对比测试：

平均下来，费用少 35%，token 少 57%，工具调用少 71%，速度快 46%。

拿 Excalidraw 举例。没有 CodeGraph 的时候要调 79 次工具、花接近三分钟；有了之后，3 次工具调用、48 秒搞定。

它不是什么？

CodeGraph 不是另一个 AI，也不是云端服务。它完全在本地跑——SQLite 数据库存在你的项目里（.codegraph/codegraph.db），代码不会上传到任何地方。

# macOS / 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 就能给当前项目建索引。之后写代码时它自动增量更新，不需要手动触发。

支持哪些工具？

Claude Code、Cursor、Codex CLI、opencode、Hermes Agent。语言覆盖 20 多种主流语言——TypeScript、Python、Go、Rust、Java、C/C++、Swift、Kotlin 等。iOS + React Native 混合项目也能跨语言追踪调用。

用起来是什么感觉？

配好之后基本无感。项目里有 .codegraph/ 目录，Claude Code 就会自动优先用 CodeGraph 的工具。

• codegraph_context：一句话描述任务，自动搜索、找调用链、返回代码片段
• codegraph_callers / codegraph_callees：看谁调了这个函数，或者这个函数调了谁
• codegraph_impact：改函数之前，看看会影响哪些代码
• codegraph_trace：整条调用链路一步到位

不想用的时候，codegraph uninstall 一条命令清掉。

社区反馈

以前 Claude Code 扫一个大项目，工具调用要 52 次。用了 CodeGraph 之后，3 次。

4000 个文件的项目，速度快 46%，token 费用少 35%。完全本地运行，代码不外传。

GitHub 2.7 万 stars，支持 Claude Code、Cursor，Windows/Mac/Linux 都能跑。

项目从 2026 年 1 月 18 日开源到现在，不到四个月拿到近 2.7 万 star。

值不值得试试？

几十上百个文件的小项目可能感受不太明显——本身搜索就快。但如果你在几千甚至上万文件的项目里用 AI 辅助开发，装一个的成本几乎为零，省下来的 token 和等待时间就是纯收益。

用 Claude Opus 跑一次大项目的探索，没 CodeGraph 可能要两三刀，有了之后可能几毛就搞定。