分享一本“Codegraph 代码地图”的电子书
digoal约 3 分钟又是一个晚上, 这本“Codegraph 代码地图”电子书搞定了.
接下来准备把我常用的 AI 技术栈工具打包到一个容器里. 到时候分享给大家伙, 未来打算再出 AI 相关的分享视频, 欢迎关注.
你有没有算过一笔账:让 Claude Code 帮你在一个中型项目里改个 bug,一次问答烧掉多少 token?
答案是:在 Tokio 这种 79 万行 Rust 代码库里,一次"how does X work"问答,平均要 57 次工具调用、15 次 Read、4.3M tokens——账单 3.04 美元。
而同一个问题,装上 codegraph 之后:3 次调用、0 次 Read、386k tokens、0.44 美元。
节省 95% 调用、91% token、86% 成本。
这本 Handbook 是什么
CodeGraph Handbook 是我最近在读的一本开源电子书,作者把 codegraph 这个工具掰开揉碎讲了一遍。codegraph 本身是个 Rust 内核 + SQLite FTS5 实现的本地代码知识图谱,给 AI Coding Agent 当 MCP 服务用——一次 codegraph_explore 调用,直接返回源码、调用路径、爆炸半径,把 grep+Read 整条链替换掉。
这本书锚定 codegraph v1.5.0,3300 行、19 章、11 张架构图、80+ 条真机验证记录,分三档给读者:
用户(70%):5 分钟上手、MCP 工具手册、7 仓案例库、FAQ 开发者(20%):知识图谱 Schema、Rust 内核、评估体系、贡献者指南 架构师(10%):进程拓扑、Context 组装管线、MCP 协议工程化
89% / 69% / 60% 是什么意思
codegraph 团队在 7 个不同语言、不同规模的开源项目上做了对照 benchmark——VS Code、Excalidraw、Django、Tokio、OkHttp、Gin、Alamofire,4 次中位数取样。
聚合出来的数据是:
| 89% | |
| 69% | |
| 60% | |
| → 0 |
最关键的指标是最后一个:文件读取归零。Agent 不再需要先把整个文件塞进 context,而是通过知识图谱直接拿到"X 函数在 y 文件第 z 行,它的 callers 是 A、B、C"——一行回答,零 Read。
为什么不是替代品
很多人会问:这跟 LSP、ctags、Sourcegraph、Embedding RAG 有什么区别?
作者在书里给了一个很清晰的答案:它不取代,而是补足。
LSP 跳转精确但 editor-bound,agent 没法直调 ctags 秒级匹配但只有字符串,无语义边 Sourcegraph 商业 SaaS,代码上云、HTTP 延迟 Embedding RAG 语义相似 ≠ 结构精确,caller 找不到
CodeGraph 的位置是:100% 本地 + 知识图谱 + MCP 直通——三者同时做对。代码不出网,延迟 <10ms,22 种节点类型、12 种边类型、19 个 SQLite 索引,Swift compiler 27k 文件 fresh index 100 秒,Linux kernel 70k 文件 2M 符号在 2 核 VPS 上 12 分钟建好。
5 分钟从装到用
上手路径很短:
# 1. 装 CLI
npm i -g codegraph# 2. 在项目根目录建索引
codegraph init
# 3. 一行接入 Claude Code
codegraph install
之后在 Claude Code 对话里直接调 codegraph_explore,输入符号名或文件路径,就能拿到带行号标注的源码 + 调用链 + 改它会动到哪些文件。
支持 8 个 AI Agent:Claude Code、Cursor、Codex、Continue.dev、Cline、Zed、OpenCode、Aider——同一套 MCP 协议,8 份 target agent 配置 JSON 全部预置。
真实的成本账
Handbook 里给了一个简单的算式:一个工程师一天 50 个问答,每个平均省 0.7 美元:
~770/月/工程师
20 人团队一年就是 ~18.4 万美元 的 token 节省——而 codegraph 本身是 MIT 开源、零 API Key、零云费用。
适合谁读
被 AI Coding 工具的 token 账单烧怕的团队 lead:直接看 Ch02 快速上手 + Ch09 七仓案例库 想给 codegraph 提 PR 的贡献者:Ch11 知识图谱 Schema + Ch12 Rust 内核 + Ch16 贡献者指南 想理解"怎么给 AI Agent 加知识层"的架构师:Ch10 进程拓扑 + Ch13 Context 组装管线 + Ch14 MCP 三模式决策
如果你也在用 Claude Code / Cursor 写代码,又在月底看着 token 账单皱眉,这套工具值得花一个下午试试。Handbook 是 MIT 协议,代码是 MIT 协议,白嫖不亏。
📦 项目地址:codegraph (GitHub)
📖 Handbook 仓库:codegraph-handbook(19 章 / 11 mermaid 图 / 80+ 验证条目)