代码知识图谱codegraph

codegraph是一款AI编程助手的“代码大脑”，专注于降低AI的Token消耗和工具调用次数。平均减少58%工具调用、35%Token消耗、22%速度提升。我建议其他MCP可以不装，这个必优先安装。因为实在是太好用了。

GitHub地址：https://github.com/colbymchenry/codegraph

Install

1
2
3
4
5
6
7
8

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.sh | sh

# Windows (PowerShell)
irm https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.ps1 | iex

## 验证
codegraph --version

Wire up your agent(s)

1

codegraph install

它将自动发现和自动配置Claude Code, Cursor, Codex CLI, opencode, Hermes Agent, Gemini CLI, Kiro — wiring the CodeGraph MCP server into each.

初始化工程

1
2

cd your-project
codegraph init

codegraph init 一行命令即可创建本地目录 .codegraph/ ，并且会将当前项目构建成一个图，然后你的Agent就会自动使用CodeGraph工具了。并且后面你更新了文件，codegraph会自动刷新图索引的，因此你很少需要手动去更新索引。不过如果你真的想这么做也可以，下面两条简单命令

1
2

codegraph index          # full re-index
codegraph sync           # incremental update of changed files

配置

codebase会使用项目中的.gitignore中定义的文件作为它排除项。这个通常也符合预期，请不需要索引的文件写入.gitignore文件即可。

使用

在Agent中使用自然语言提问，凡是有跟代码相关的它会自动调用codegraph的。比如

• “这个项目的整体架构是什么？”
• “修改XXX的影响范围是什么？”
• “找一下XXX功能的入口和调用链”

最佳实践

• 优先自然语言提问，不要自己去拼接工具调用
• 在大的重构之前，先问下“修改XX的影响范围？”，防止踩坑。
• 新人接收项目，问“项目架构+核心流程，用图谱生成全景”。
• 调试的时候，问“XXX报错，报错日志为YYY，这个调用链是怎样的？”，用于快速定位问题。