CodeGraph完全教程：给AI编程装上"代码大脑"，Token省到离谱

继CodeGraph开源后在GitHub爆火，越来越多的开发者开始将其集成到日常工作中。本文是一篇从安装到进阶的完整教程，帮你在30分钟内完成配置，让AI编程效率翻倍。

第一步：安装（3种方式任选）

方式一：NPM全局安装（推荐）

# 使用 npm
npm install -g @codegraph/cli

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

方式二：从源码安装

git clone https://github.com/colbymchenry/codegraph.git
cd codegraph
pnpm install && pnpm build
pnpm link --global

方式三：VS Code 扩展

在VS Code扩展市场搜索 "codegraph"，一键安装。安装完成后会自动附带CLI工具。

第二步：生成索引

进入项目根目录，运行：

# 基础索引
codegraph index

# 只索引指定目录
codegraph index src/ lib/

# 排除目录
codegraph index --exclude node_modules/ dist/ build/

索引时间参考：小项目（<1万行）10-30秒；中型项目（1-10万行）1-5分钟；大型项目（10-100万行）5-30分钟。

第三步：与Claude Code集成（零配置）

Claude Code 会自动检测项目中的 CodeGraph 索引并使用，无需任何手动配置。

当你向Claude询问代码库相关问题——比如"分析login函数的调用流程"或"找出所有依赖UserService的地方"——它会优先从知识图谱获取答案，而非重复扫描文件。实测效果：

• 响应时间从48秒降至26秒（提升46%）
• Token消耗从12,400降至5,300（节省57%）
• 工具调用从7.2次降至2.1次（减少71%）

进阶技巧

增量索引（大型项目必备）

codegraph index --incremental   # 只索引修改过的文件
codegraph watch                  # 实时监控文件变化自动更新

零文件读取模式

codegraph config set zero_file_read true

开启后AI完全不读取文件，所有信息来自预先生成的索引——速度最快、成本最低。

可视化代码图谱

codegraph serve

访问 http://localhost:3000 可查看项目架构图、调用图和依赖图。

支持的工具和语言

AI客户端：Claude Code、Cursor 0.45+、Windsurf 1.5+、VS Code + GitHub Copilot、DeepSeek-TUI

编程语言：TypeScript/JavaScript、Python、Java、C/C++、Rust、Go、C#

隐私：100%本地运行，代码数据永不离开你的电脑。