CodeGraph：给你的AI编程助手装上代码知识图谱
什么是 CodeGraph？
CodeGraph 是一个开源（MIT）的代码知识图谱工具，由 `colbymchenry/codegraph` 开发，在 GitHub 上已获 54000+ Star。
它会给你的代码库建立索引，生成一张"知识图谱"，让 AI 编程助手知道你的项目里有什么文件、函数、类、接口、它们之间怎么互相调用。这样 AI 就能精准定位相关代码，不需要每次都从头扫描整个项目。
一句话： 少发 token，少调工具，回答更快，100% 本地运行。
支持的 AI 助手
| 助手 | 支持 |
|---|---|
| Claude Code | ✅ |
| Cursor | ✅ |
| Codex CLI | ✅ |
| OpenCode | ✅ |
| Hermes Agent | ✅ （我们用的 Hermes 也支持！） |
| Gemini CLI | ✅ |
| Antigravity IDE | ✅ |
| Kiro | ✅ |
安装使用
1️⃣ 安装 CLI
一行命令，不需要 Node.js：
curl -fsSL https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.sh | sh
也可以用 npm（如果有的话）：
npm i -g @colbymchenry/codegraph
装完后开一个新终端，让 `codegraph` 命令生效。
2️⃣ 接入你的 AI 助手
codegraph install
这一步会自动检测你装了哪些 AI 助手，并把 CodeGraph 的 MCP 服务器配置到它们里面。
⚠️ 注意：只装 CLI 不会自动接入助手。必须跑 `codegraph install`。
3️⃣ 初始化项目
进入你的项目目录，运行：
cd your-project
codegraph init
会在项目里创建 `.codegraph/` 目录，并构建完整的代码知识图谱——一步完成。
4️⃣ 自动同步（不用管了）
CodeGraph 默认开启自动监听。你改代码、增删文件，它自动更新图谱，永远不用手动重新索引。
为什么用 CodeGraph？
| 传统方式 | CodeGraph 方式 |
|---|---|
| AI 每次重新扫描整个项目 | AI 直接从图谱中查找相关代码 |
| 大量 token 消耗在无关文件上 | 只加载需要的上下文 |
| 工具调用频繁，回答慢 | 精准定位，回答更快 |
| 大项目容易超出上下文限制 | 智能裁剪，只给 AI 需要的 |
卸载
codegraph uninstall
恢复所有 AI 助手的原始配置。项目里的 `.codegraph/` 目录不会自动删除，可以用 `codegraph uninit` 清理。
云平台（内测中）
CodeGraph 团队正在开发一个托管平台（getcodegraph.com），可以为每个 PR 分析变更影响——哪些流程被修改、哪些测试该跑、哪里可能出问题。目前在内测阶段，可以申请等待名单。
总结
如果你在用 AI 编程助手写代码，尤其是大项目，CodeGraph 是个很好的工具——安装简单，一次配置，自动同步。它让你的 AI 助手更"懂"你的代码，少浪费 token，多干实事。
🛠 小爱提醒：我们自己的 Hermes Agent 也支持 CodeGraph！可以试试装上之后聊代码，体验会好很多。