用 Claude Code 写代码最烦的是什么？
不是它写不出你想要的函数，也不是它偶尔犯傻。是每次开新会话，它都要像个无头苍蝇一样，重新探索一遍你的整个代码库。
你看着那个进度条：
探索 /src/api/ 结构... 探索 /src/components/ 结构... 探索 /src/database/ 结构...
每次。
每次都要花一两分钟，每次都要烧掉十几万 tokens，每次都要等它把文件一个个扫完。然后你关掉会话，这些昂贵的“知识”就清零了。下次再开？再来一遍。
这根本不是智能，这是重复劳动。
有开发者受不了了，直接造了个工具叫 CodeGraph。
思路很简单：与其让 Claude 每次从零开始爬文件，不如先给它一张地图。
这张地图不是那种“README.md 里写点项目介绍”的糊弄事。它是用 tree-sitter 把你的代码解析成 AST，然后把所有函数、类、方法、调用关系、继承链、导入关系，全部塞进一个本地的 SQLite 数据库里。
还加了向量嵌入做语义搜索。
Claude 需要理解代码的时候，不再是一个个文件去 grep、去 glob、去 Read。它直接对着这张地图问：
“哪些函数调用了这个函数？” “这个类的父类是谁？” “改了这个文件会影响到哪些地方？”
查询结果秒回。
作者测出来的数据很直接：同样的复杂任务，用了 CodeGraph 之后，探索代理的工具调用少了 25%，token 消耗少了 30%。
时间直接砍掉三分之一。
这才是真正的工作流优化——不是让 AI 更聪明，而是让它别干蠢事。
安装也简单得不像话。
Node.js 18+ 环境，一条命令：
npx @colbymchenry/codegraph
交互式安装程序会帮你配好 MCP 服务器、设置权限、问你要不要初始化当前项目。重启 Claude Code，在项目里跑个 codegraph init -i，半秒钟内索引完成。
之后 Claude 编辑文件，CodeGraph 会自动同步索引。
它支持 16+ 语言，从 TypeScript、Python 到 Go、Rust 都覆盖。最关键的是，100% 本地运行，你的代码不出门。
我为什么觉得这东西有用？
因为它解决的是真实痛点，不是臆想出来的需求。
Claude Code 的探索机制在设计上就有问题——没有会话间记忆，导致每次都要重新交“探索税”。社区里那些往 CLAUDE.md 里塞摘要、搞子代理共享内存文件的方案，都是治标不治本的 hack。
CodeGraph 的思路更彻底：既然你要探索，我就给你建个索引库。既然你要理解关系，我就把关系预先算好。
这其实是个很基础的工程思维：用空间换时间，用预处理换实时计算。
但太多人被 AI 的“智能”光环迷惑，忘了最基本的效率原则。
当然，这工具刚出来，肯定有局限。
比如它依赖 Claude Code 的 MCP 协议和 hooks 机制，换个编辑器或者 AI 助手就用不了。比如超大项目的索引速度和存储开销还没经过大规模测试。比如它现在还是个人项目，长期维护性存疑。
但这些都不影响它的核心价值：它指出了一个方向——AI 编程助手不应该每次都从零开始认识你的代码。
我们应该给它们更好的“记忆系统”，而不是让它们一遍遍重复扫描。
先跑起来再说。
如果你也在用 Claude Code，被那个探索进度条折磨过，试试这个工具。GitHub 仓库和 npm 包都在下面，自己看文档。
省下来的 tokens 和时间，够你多写好几个功能了。
GitHub: https://github.com/colbymchenry/codegraph
npm: https://www.npmjs.com/package/@colbymchenry/codegraph
