CodeGraph是一个开源工具，通过为Claude Code、Cursor等AI编码代理提供预索引的知识图谱（符号关系、调用图、代码结构），显著提升其代码理解效率。基准测试显示，在7个真实开源项目上，平均可降低35%成本、减少70%工具调用、提升49%速度，且完全本地运行。
核心要点
- 核心原理：用预索引的知识图谱替代代理的逐文件扫描（grep/glob/Read），代理直接查询图谱获取符号关系、调用图和代码结构。
- 基准测试平均结果：成本降低35%，Token消耗减少59%，速度提升49%，工具调用减少70%。
- 在大型代码库（如VS Code约1万文件）上效果最显著：成本降35%，工具调用降72%，Token降73%。
- 支持Claude Code、Cursor、Codex CLI、opencode等主流AI编码代理，通过交互式安装器自动配置。
- 完全本地运行，无数据外泄风险，跨平台支持Windows/macOS/Linux。
正文
当Claude Code等AI代理探索代码库时，它会生成探索代理，通过grep、glob和Read等工具扫描文件，每次工具调用都会消耗Token。
CodeGraph为这些代理提供了一个预索引的知识图谱——包含符号关系、调用图和代码结构。代理可以直接查询图谱，无需扫描文件，从而大幅提升效率。
基准测试结果
在涵盖7种语言的7个真实开源代码库上，对比了代理（Claude Code，无头模式）在有和没有CodeGraph的情况下回答一个架构问题的表现。每个单元格显示的是每臂4次运行中位数的节省量。
平均：成本降低35% · Token减少59% · 速度提升49% · 工具调用减少70%
| 代码库 | 语言 | 成本 | Token | 时间 | 工具调用 |
|---|---|---|---|---|---|
| VS Code | TypeScript · ~1万文件 | 降低35% | 减少73% | 加快41% | 减少72% |
| Excalidraw | TypeScript · ~600 | 降低47% | 减少73% | 加快60% | 减少86% |
| Django | Python · ~2700 | 降低34% | 减少64% | 加快59% | 减少81% |
| Tokio | Rust · ~700 | 降低52% | 减少81% | 加快63% | 减少89% |
| OkHttp | Java · ~640 | 降低17% | 减少41% | 加快36% | 减少64% |
| Gin | Go · ~150 | 降低22% | 减少23% | 加快34% | 减少19% |
| Alamofire | Swift · ~100 | 降低38% | 减少59% | 加快51% | 减少77% |
收益随代码库规模扩大而增加：在大型仓库上，代理只需少量调用即可从索引中获取答案，零文件读取；而没有CodeGraph的代理则需要在grep/find/Read之间扩散（以及它生成的子代理）。在小型仓库（如Gin约150个文件）上，原生搜索已经足够便宜，因此差距缩小。
快速开始
npx @colbymchenry/codegraph
交互式安装器会自动配置你的代理——Claude Code、Cursor、Codex CLI、opencode。
初始化项目：
cd your-project
codegraph init -i
关联概念
- 知识图谱
- MCP服务器
- AI编码代理
- 语义代码索引
- 工具调用优化
可操作项
- 在终端运行
npx @colbymchenry/codegraph启动交互式安装器，自动配置你的AI编码代理。 - 进入你的项目目录，运行
codegraph init -i初始化代码索引。 - 在Claude Code、Cursor等代理中提问，观察工具调用次数和响应速度的变化。
- 对于大型代码库（如超过1000个文件），效果最为显著，建议优先尝试。
原文: colbymchenry/codegraph
自动加工于 2026-05-21 08:04