乐于分享
好东西不私藏

剑识 | AI代码导航

剑识 | AI代码导航

1、龙虾脱壳

你有没有看过龙虾脱壳的过程?

那只硬壳被弃在原地,龙虾从里面爬出来,浑身湿软、毫无防护。在接下来的几个小时里,新壳会慢慢硬化,它才能重新获得保护。

这个画面让我想起了 AI 编码 Agent 的现状。

你让 Claude Code 去理解一个大型代码库。它先 spawn 一个 Explore agent,然后 grep 搜索文件路径,glob 匹配文件名,逐行 Read 文件内容。每一个步骤都在消耗 token,每一秒都在花钱。

它不是在写代码。它是在探索代码。

就像一个没有地图的游客,靠敲门问路来认识一座城市。

问题是:每个 AI 编码 Agent 都在重复这个敲门的过程——同一份代码库,每次都得从头来一遍。

直到我看到了 CodeGraph。

2、什么是一个「代码知网」

先来看一张图。

这是今天 GitHub 上最火的项目之一。上线一周拿到 38,905 颗星,排名本周趋势第二。

作者 Colby McHenry 发现了一个被所有人忽视的问题:AI 编码 Agent 在「读代码」这件事上花了 70% 的预算。

他的方案简单到令人发指:

给 AI 一张代码地图,而不是让它自己问路。

CodeGraph 用 Tree-sitter 把代码解析成 AST,把符号关系、调用链、代码结构全部预索引到本地的 SQLite 数据库里。然后通过 MCP 协议暴露给 AI Agent。

你说一句「帮我理解这个模块的架构」,Agent 不再需要 grep + Read 轮流轰炸 —— 它直接从知识图谱里调出完整上下文。

3、差距有多大

来看数据。

CodeGraph 在 7 个生产级开源项目上做了对照实验:

项目
语言
无 CodeGraph
有 CodeGraph
节省
VS Code
TypeScript
1,400K tokens
393K tokens
72%
Django
Python
680K tokens
210K tokens
69%
Tokio
Rust
920K tokens
285K tokens
69%
Gin
Go
440K tokens
145K tokens
67%
OkHttp
Kotlin
510K tokens
168K tokens
67%

平均结果:

指标
无 CodeGraph
有 CodeGraph
变化
工具调用次数
100%
减少 70%
🟢
Token 消耗
100%
减少 59%
🟢
成本
$1.00
降低 35%
🟢
回答速度
基准
提升 49%
🟢

核心洞察:不是模型不够聪明,是 Agent 把太多精力花在了「找东西」上。

4、架构拆解

CodeGraph 的架构分为四层:

解析层:用 Tree-sitter 解析 7+ 语言的 AST。支持 TypeScript、Python、Rust、Go、Java、Kotlin、Swift。每次保存文件,增量更新,增量解析,不是全量重扫。

存储层:SQLite + FTS5 全文索引。全部在本地,零外部依赖。你的代码永远不会离开你的机器。

服务层:MCP 协议暴露。这意味着任何支持 MCP 的 AI 工具都能接入——Claude Code、Codex、Cursor、Gemini、Hermes Agent。一次索引,处处可用。

Agent 层:Code Explorer 自动组装上下文。它能听懂「谁调用了这个函数」「这个模块的依赖关系是什么」「这个路由链的完整路径」这类自然语言问题。

5、龙虾的新壳

回到龙虾的隐喻。

龙虾脱壳是因为旧壳限制了生长。AI 编码 Agent 也到了该「脱壳」的时候了——旧壳就是「每次都从头探索代码」。

CodeGraph 就是那层新壳。

它不会让你扔了 Claude Code。它让你在 Claude Code 前面加一个「代码知网」。你负责问问题,它负责回答;Agent 负责写代码,CodeGraph 负责指路。

这就是 AI Agent 的认知升级:不再把带宽浪费在「读」,而是把能量集中在「写」。

6、上手与适用人群

如果你满足以下任一场景,CodeGraph 值得一试:

• 大型代码库维护者:每次改代码都要花 10 分钟等 Agent 理解上下文

• 跨语言开发者:同时维护多个技术栈,每次切换 Agent 都要重新适应

• 追求成本控制的技术 Leader:团队每月 AI 编码工具账单越来越高

• MCP 生态玩家:已经在用 Claude Code / Codex / Cursor,希望进一步提效

安装只要一行:

npm install -g @colbymchenry/codegraph codegraph init 

然后配置 Claude Code 的 MCP 设置即可。

7、明日观察

AI 编码正在经历一场从「工具」到「基础设施」的跃迁。

上一波是 cursor、copilot——它们是更好的代码补全。下一波是 codegraph、agentmemory——它们是更好的代码理解。

前者让写代码变快,后者让懂代码变快。

两者叠加,才是真正的 AI 编码 2.0。

我会持续观察这个赛道。CodeGraph 之后,还会有「代码记忆」「代码规划」「代码验证」的同类项目出现。

龙虾每次脱壳都变得更强大。AI 也是。

今日项目:github.com/colbymchenry/codegraph

AI First · 认知升级 · 实战方法论