AI 编程助手在浪费你的钱?这个本地工具帮 Claude Code 省掉 70% 的 token

最近发现一个开源项目，用下来只想说一句话：为什么现在才有人做这个东西？

它叫 CodeGraph，一个完全本地运行的代码语义索引工具，专门给 AI 编程助手"开挂"。支持 Claude Code、Cursor、Codex CLI、OpenCode 和 Hermes Agent。

痛点：AI 编程助手在"瞎找"

用过 Claude Code 或 Cursor 的都知道，当你问一个架构级的问题，比如"Django 的 ORM 是怎么把 QuerySet 转成 SQL 的"，AI 会怎么做？

它会启动 Explore 子代理，然后用 grep、glob、Read 一个文件一个文件地扫。你的 token 在燃烧，账单在飙升，而它可能还在第 30 个文件里迷路。

CodeGraph 的思路很简单：别让它现找，提前把代码结构建好索引。

它做了什么

CodeGraph 会把你的项目构建成一个语义知识图谱，包含：

符号关系（函数调用、类继承）
调用链（谁调了谁）
代码结构

然后以 MCP Server 的形式暴露给 AI 编程助手。AI 需要了解代码时，直接查图谱，一两个调用就能拿到答案。

数据说话

项目作者在 7 个真实开源项目上做了基准测试，结果非常亮眼：

项目	语言	成本节省	Token 节省	速度提升	工具调用减少
VS Code	TypeScript	26%	78%	52%	85%
Excalidraw	TypeScript	52%	90%	73%	96%
Tokio	Rust	82%	86%	71%	92%
Alamofire	Swift	47%	64%	48%	83%

平均下来：省 35% 的钱、57% 的 token、快 46%、少 71% 的工具调用。

规律也很明显：项目越大，收益越高。小型项目本身搜索就快，差距不大；但像 VS Code 这种万级文件的项目，从 55 次工具调用降到 8 次，简直是质变。

几个亮点

零依赖安装。 不需要 Node.js，macOS/Linux 一行 curl，Windows 一行 PowerShell，完事。

19+ 语言支持。 TypeScript、Python、Go、Rust、Java、C#、Swift、Kotlin 等主流语言全覆盖。

14 个 Web 框架路由识别。 Django、Flask、Express、Spring、Rails、NestJS 等框架的路由文件都能自动解析，URL 模式和 Handler 直接关联。

100% 本地。 数据不离开你的机器，没有 API Key，没有外部服务，底层就是 SQLite。

自动同步。 用 FSEvents（macOS）/ inotify（Linux）/ ReadDirectoryChangesW（Windows）监听文件变化，代码改了图谱自动更新，不用手动重建索引。

安装和使用

三步搞定：

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

# 2. 初始化项目
cd your-project
codegraph init -i

# 3. 重启你的 AI 编程助手

安装器会自动检测你装了哪些编程助手（Claude Code、Cursor 等），自动配置好 MCP Server。如果你中途不想用了，codegraph uninstall 一行命令干净卸载。

适合谁用？

如果你满足以下任一条件，建议试试：

用 Claude Code / Cursor / Codex CLI 做项目开发，项目规模超过几百个文件
经常问架构级问题，每次 AI 都要花大量 token 去探索
对 API 费用敏感，想降低编程助手的消耗
在大型代码库里做重构，需要频繁追踪调用链

如果只是写写小脚本，几百个文件以内，收益可能不明显。

项目地址

GitHub: https://github.com/colbymchenry/codegraph

MIT 开源，放心用。

说实话，这类工具理应成为 AI 编程助手的基础设施。与其让 AI 每次都从头"读"整个代码库，不如给它一张地图。CodeGraph 就是那张地图。