CodeGraph 代码知识图谱

CodeGraph 是什么

CodeGraph 是一个预索引的代码知识图谱工具，为 AI 编程助手提供语义化的代码理解能力。它把项目代码解析成结构化的图（函数、类、引用、跨文件依赖等），让助手在回答问题时直接查询图谱，而不是反复读取大量文件。

核心思路

• 预索引：项目初始化时一次性构建完整图谱
• 自动同步：监听文件变化，代码改动后图谱实时更新，无需手动重建
• 精准上下文：只把相关节点交给模型，减少 token 与工具调用次数
• 100% 本地：所有索引与查询都在本机完成，代码不外传

支持的 AI 助手

CodeGraph 通过 MCP 接入主流 AI 编程工具，包括：

• Claude Code
• Cursor
• Codex CLI
• Gemini CLI
• GitHub Copilot（VS Code / CLI / JetBrains）
• opencode、Hermes Agent、Antigravity、Kiro 等

快速上手

1. 安装 CLI

无需预装 Node.js，安装脚本会自动选择对应平台的构建：

# 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

已有 Node 环境也可使用 npm 安装。

2. 接入你的助手

codegraph install

该命令会检测本机已安装的 AI 助手，并把 CodeGraph 的 MCP 服务写入其配置。

3. 初始化项目

cd your-project
codegraph init

会在项目下创建 .codegraph/ 目录并构建完整图谱。

4. 自动同步

默认开启文件监听，代码变更后图谱自动更新，无需再次运行命令。

适用与注意

• 适合中大型、多语言、跨文件依赖复杂的项目
• 每个项目需单独 codegraph init
• 卸载可用 codegraph uninstall，项目索引需用 codegraph uninit 单独清理

小结

CodeGraph 把「让 AI 读懂整个代码库」这件事做成了本地化的基础设施：一次建图、持续同步、按需查询。对于重度使用 AI 编程助手的团队，它能明显降低 token 成本并提升回答准确度。