CodeGraph代码知识图谱教程：让AI编程助手零扫描理解代码库

📅 2026-08-03 · 🏷️ 代码理解 · AI编程 · MCP

CodeGraph是什么？

CodeGraph是一个预索引代码知识图谱引擎，用tree-sitter解析整个代码库的符号关系、调用图和结构信息，存入SQLite数据库。AI编程工具（Claude Code、Cursor、Gemini等）通过MCP协议查询这个知识图谱，无需逐行扫描文件就能理解代码结构。

核心价值：平均减少60-90%的Token消耗、46%的响应时间和71%的工具调用次数。

解决了什么问题？

当AI编程助手需要理解大型代码库时，传统方式是反复扫描文件——每次问一个问题就要重新读取文件、解析结构。一个"用户登录流程怎么走"的问题可能让AI调用23次工具、花47秒才能回答。

CodeGraph预先把整个代码库索引成知识图谱，AI直接查询结构化信息，秒级响应。

核心特性

• tree-sitter解析：支持20+编程语言（TS/JS/Python/Java/C++/Rust/Go/C#/PHP等）
• SQLite存储：本地数据库，100%离线运行
• MCP协议：原生支持Claude Code、Codex、Cursor、Gemini、OpenCode等8+工具
• 自动同步：代码变更时自动增量更新索引
• 跨平台：Windows 10/11、macOS 12+、Ubuntu 22.04+

安装

# 需要Node.js 18.17.0+（推荐20.x LTS）
npm install -g @codegraph/cli

# 或用pnpm（更快）
pnpm add -g @codegraph/cli

# 验证安装
codegraph --version

使用方法

第一步：索引代码库

cd your-project
codegraph init
codegraph index

# 输出：
# ✅ Indexed 1,247 files
# ✅ Extracted 8,432 symbols
# ✅ Built 3,156 relationships
# ✅ Knowledge graph saved to .codegraph/db.sqlite

第二步：配置Claude Code

# 在项目根目录的 .claude/settings.json 中添加：
{
  "mcpServers": {
    "codegraph": {
      "command": "codegraph",
      "args": ["serve"]
    }
  }
}

第三步：在Claude Code中使用

# 启动Claude Code后直接提问：
> 这个项目的用户认证流程是怎样的？

# CodeGraph会自动被调用，返回结构化的调用链：
# login() → authenticate() → verifyToken() → checkPermissions()
# 而不是逐个文件扫描

支持的工具

工具	集成方式	体验
Claude Code	原生MCP	最佳
Cursor 0.45+	MCP	优秀
Gemini CLI	MCP	良好
GitHub Copilot	VS Code扩展	良好
Windsurf 1.5+	MCP	良好

如果你之前用过Graphify做代码知识图谱，CodeGraph是其升级版，功能更全面。也可以看看我们的Graphify代码知识图谱教程了解对比。对于Claude Code的更多增强方案，ECC增强Claude Code教程也是必读的。

性能实测数据

指标	无CodeGraph	有CodeGraph	提升
Token消耗	50k	15k	-70%
响应时间	47s	25s	-47%
工具调用次数	23次	7次	-70%

总结

CodeGraph是目前最成熟的本地代码知识图谱引擎，42.8k Stars说明社区认可度极高。对于在大型代码库中使用AI编程助手的开发者，CodeGraph是必备的基础设施——它能显著降低Token成本、提升响应速度，让AI编程工具真正高效地理解你的项目。