利用语义代码智能增强 Claude Code、Cursor、Codex 和 OpenCode 的功能。工具调用次数减少 94% · 勘探速度提升 77% · 100% 本地化

开始使用

npx @colbymchenry/codegraph

交互式安装程序会自动配置您的代理程序——Claude Code、Cursor、Codex CLI、opencode

初始化项目

cd your-projectcodegraph init -i

为什么选择 CodeGraph？

当 Claude Code 探索代码库时，它会生成Explore 代理，这些代理会使用 grep、glob 和 Read 扫描文件——每次工具调用都会消耗令牌。

CodeGraph 为这些代理提供了一个预先索引的知识图谱——包括符号关系、调用图和代码结构。代理可以立即查询该图谱，而无需扫描文件。

基准测试结果

在 6 个真实代码库上进行了测试，比较了 Claude Code 的 Explore 代理在有无CodeGraph 的情况下的表现：

平均而言：工具调用次数减少 92%，速度提升 71%。

主要特点

框架感知路由

CodeGraph 可以检测 Web 框架的路由文件，并生成route通过边链接到其处理类或函数的节点references。现在，查询视图/控制器的调用者即可获取绑定该视图/控制器的 URL 模式。 

快速入门

1. 运行安装程序

npx @colbymchenry/codegraph

安装程序将：

• 询问要配置哪些代理——自动检测已安装的代理，例如：Claude Code、Cursor、Codex CLI、opencode。
• 提示安装codegraph到您的 PATH 环境变量中（以便代理可以启动 MCP 服务器）
• 询问这些配置是应用于所有项目还是仅适用于当前项目。
• 为每个选定的代理编写 MCP 服务器配置 + 指令文件（例如CLAUDE.md，，，）.cursor/rules/codegraph.mdc~/.codex/AGENTS.md
• 当 Claude Code 是目标之一时，设置自动允许权限。
• 初始化当前项目（仅限本地安装）

非交互式（脚本/CI）：

codegraph install --yes                              # auto-detect agents, install globalcodegraph install --target=cursor,claude --yes       # explicit target listcodegraph install --target=auto --location=local# detected agents, project-localcodegraph install --print-config codex               # print snippet, no file writes

2. 重启您的代理

重启您的代理（Claude Code / Cursor / Codex CLI / opencode）以加载 MCP 服务器。

3. 初始化项目

cd your-projectcodegraph init -i

构建每个项目的知识图谱索引。同时，连接所有项目本地代理界面（例如 Cursor .cursor/rules/codegraph.mdc），以便单个全局codegraph install配置在您打开的每个项目中都能正常工作——无需为每个项目重新运行安装程序。

就是这样——当.codegraph/目录存在时，您的代理将自动使用 CodeGraph 工具。

工作原理

1. 提取——tree -sitter将源代码解析为 AST。特定语言的查询提取节点（函数、类、方法）和边（调用、导入、扩展、实现）。

2. 存储——所有内容都存储在本地 SQLite 数据库中（.codegraph/codegraph.db），并支持 FTS5 全文搜索。

3. 解析——提取后，引用将被解析：函数调用→定义，导入→源文件，类继承，以及框架特定的模式。

4. 自动同步— MCP 服务器使用操作系统原生文件事件监控您的项目。更改经过防抖处理（2 秒静默窗口），仅筛选源文件，并进行增量同步。图表会在您编写代码的同时保持最新状态，无需任何配置。