ByteNoteByteNote
CodeGraph:预索引代码知识图谱,72.9 千星省 token 新方案
字

字节笔记本

2026年10月2日 · 约 2 分钟读完

CodeGraph:预索引代码知识图谱,72.9 千星省 token 新方案

API中转
¥120

让 coding agent 理解一个陌生代码库,最烧 token 的操作是什么?逐文件读。72.9 千星的开源项目 CodeGraph 给出了不同的答案:预索引代码知识图谱,代码变了自动同步,100% 本地运行,支持 Claude Code、Codex、Cursor、OpenCode 等 9 个 agent。

它解决什么

Agent 读代码的痛点不是"读不到",而是"读到的都是原始文本"。一个 5000 行的文件,agent 需要消耗大量 token 才能提取出"这个函数被谁调用、这个类继承了什么、这个路由绑定了哪个 handler"。CodeGraph 把这些关系预先建好索引,agent 直接查询结构化结果,跳过逐行解析的过程。

Rust 内核保证索引速度;代码变更时自动增量同步,不用手动重建。

CodeGraph 仓库卡

快速上手

bash
npm install -g @colbymchenry/codegraph
codegraph index

支持 Claude Code、Cursor、Codex、OpenCode、Hermes Agent、Gemini、Antigravity、Kiro、GitHub Copilot。Windows/macOS/Linux 全平台,Node.js 已捆绑。

CodeGraph 三大核心能力

框架感知路由

不止解析代码结构,还内置了主流框架的路由感知(Next.js、Express、FastAPI 等),agent 可以直接问"这个 API 端点对应哪个 handler"而不需要自己追踪。

还支持 iOS / React Native / Expo 混合项目的桥接分析。

适合谁用

大仓库用户:代码量越大,预索引的收益越明显。

多 agent 用户:一次建索引,所有支持的 agent 共享。

关注 token 成本的人:和 jevgrep、context-mode 属于同一个方向,用结构化数据替代原始文本来省 token。

相关文章

分享: