# 代码知识图谱codegraph

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

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

## Install
```
# 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)
```
codegraph install
```

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

## 初始化工程
```
cd your-project
codegraph init
```

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


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

## 使用
在Agent中使用自然语言提问，凡是有跟代码相关的它会自动调用codegraph的。比如
- “这个项目的整体架构是什么？”
- “修改XXX的影响范围是什么？”
- “找一下XXX功能的入口和调用链”

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



---

> 作者: XiongNeng  
> URL: https://xiongneng.me/posts/ai/codegraph/