目录

写在前面：

安装命令：

初始化项目：

查询方式：

claude code结合:

验证对比：

---

写在前面：

codegraph 是探索和理解代码的利器，替代的是传统 grep + read 反复查找的模式。但如果任务很明确、上下文已经清楚，直接操作文件更高效。

为什么要安装这个，因为现在大部分都是基于verbcoding.大模型理解了需要进行改动的文件，应该都是基于grep命令，约等于每次都是全项目的查找，（当然不排除偶尔的bug修改，会指定具体的文件告诉模型）。安装他，首先它会生成项目的脑图，轻量的数据库存储起来。

1：可快速的检索，说是可以减少token消耗（这个其实还行，不在意消耗的人来说无所谓的

2：可以提速模型的效率，更快的加速代码生成。（可以看着更重要一点

3：基于复杂的业务，可以各个文件相互关联，改A的同时会影响B。这个会有效的考虑到。（待验证吧，毕竟聪明的模型，自己读全项目也能考虑到，但是项目太大，一致读，耗时耗token,有回到了1 2的优势上了。

安装命令：

npm i -g @colbymchenry/codegraph

是否安装成功：

codegraph --version   

 -- 返回版本号即可。

进入你项目根目录：cd your-project

初始化项目：

codegraph init -i

项目比较小，所以3.8秒就就见好图谱，大的项目或者文件很多，可能会比较慢。

项目里会生成对应的文件：

查询方式：

用Navicat里，连接：选择 SQLite,文件选择项目里 codegraph.db

表说明：

claude code结合：

A:再终端输入： codegraph，它会自动出现能适配的工具

B:我选了claude code,然后就是添加全局or当前项目。

C:更新成功。

D:再上一步安装的时，我选择了允许。

Claude Code 的自动允许权限列表，工具调用时不会弹出权限确认提示,以及对用的功能描述，注释我手工也加上了

这些都是只读查询工具，不会修改任何文件，所以配置为自动允许是安全的——省去了每次调用时都需要你手动点确认的麻烦

codegraph_trace：调用链追踪。用途: 查询从符号 A 到符号 B 的完整调用路径比如 "从 Controller 到 SQL 执行，中间经过了哪些方法？"codegraph_trace(from="BigScreenController", to="selectOverview")返回: 完整的调用链，每一跳的方法体都会内联展示。还能追踪动态调度（回调、React 重渲染、子类覆写等），这是 grep 做不到的。

codegraph_explore — 批量源码浏览。用途: 一次调用获取多个相关符号的源码， capped 返回codegraph_explore(query="BigScreenMapper BigScreenServiceImpl selectOverview")返回: 相关符号的完整源码，相当于批量 Read，省去多次 codegraph_node 调用。

E:当前项目的claudecode的json里启用该mcp

F:示例：claude code 里输入命令，查看状态：

验证对比：

原来：所搜全局匹配

安装后：

后端得：

前端的：