colbymchenry

colbymchenry / codegraph

#3
19,3901,071+2,456 todayTypeScript
在 GitHub 上查看

为Claude Code预索引的代码知识图谱——更少的token、更少的工具调用、100%本地化

CodeGraph 是一个基于 TypeScript 开发的代码知识图谱工具，专为 Claude Code、Cursor、Codex 和 OpenCode 等 AI 编程助手设计。它通过预先索引代码中的符号关系、调用图和整体结构，构建语义化的知识图谱，使 AI 代理在探索代码库时无需反复调用 grep、glob 和 Read 等工具扫描文件，而是直接查询图谱获取信息。实测数据显示，使用 CodeGraph 后，工具调用次数平均减少 92% 以上，代码探索速度提升 71% 至 82%，同时所有索引和处理均在本地完成，确保代码安全。适用于大型代码库的快速理解与导航，显著降低 token 消耗和响应时间。

💡 应用场景

CodeGraph最适合需要AI代理高效理解大型、多语言代码库的场景，尤其适合Claude Code、Cursor等AI编码工具的用户，能显著降低token消耗和探索时间。

大型代码库探索

问题：在大型项目（如VS Code、Swift编译器）中，AI代理需要大量grep和文件读取来理解代码结构，消耗大量token和时间。

方案：CodeGraph预索引代码的符号关系、调用图等知识图谱，AI代理直接查询图谱而非扫描文件，减少92%以上的工具调用。

示例：在VS Code（4000+文件）中，询问“扩展主机如何与主进程通信”，使用CodeGraph仅需3次工具调用、17秒，而传统方式需52次调用、1分37秒。

降低AI工具成本

问题：使用Claude Code等AI编码工具时，频繁的文件搜索和读取操作消耗大量token，导致API费用高昂。

方案：CodeGraph将知识图谱预索引到本地，AI代理从图谱直接获取符号和关系信息，大幅减少token消耗（如VS Code场景从56.6k降至更少）。

示例：在Alamofire项目中，使用CodeGraph仅消耗57.3k tokens完成代码理解，而传统方式消耗更多且需要多次文件读取。

多语言项目快速上手

问题：接手包含多种编程语言（如Python+Rust、Swift+C++）的混合项目时，手动梳理代码调用关系非常耗时。

方案：CodeGraph支持多语言代码的索引和知识图谱构建，AI代理可快速理解跨语言代码结构和依赖关系。

示例：在Claude Code的Python+Rust混合项目中，询问“工具执行如何端到端工作”，CodeGraph仅需3次调用、39秒即可给出答案。

零文件读取的代码审查

问题：在代码审查或调试时，需要频繁跳转查看函数定义、调用链，手动操作效率低且容易遗漏。

方案：CodeGraph预索引的调用图和符号关系让AI代理无需实际读取文件即可回答代码结构问题，审查流程更流畅。

示例：在Excalidraw项目中，询问“协作编辑和实时同步如何工作”，CodeGraph无需任何文件读取，仅3次工具调用、29秒完成分析。

📊 项目信息

语言
TypeScript
Stars
⭐ 19,390
Forks
1,071
今日新增
+2,456
排名
#3
收录
总榜
趋势日期
2026年5月23日
最后推送
2026/5/23

🏷️ 标签

TypeScript代码知识图谱AI代码助手预索引高性能本地化开发者工具AI开发者