Windows + Trae 安装使用 CodeGraph 完整指南
前言
CodeGraph 是一个代码知识图谱工具，能让 AI 真正理解你的项目结构。本文将详细介绍在 Windows 环境下，为 Trae IDE 配置 CodeGraph 的完整过程。
适用场景：大型项目、复杂代码库、需要 AI 深度理解代码的业务场景（如拼团系统）
一、环境准备
1.1 系统要求
- Windows 10/11
- Trae IDE（已安装）
- Node.js（推荐 18.x 或更高）
1.2 检查 Node.js
node-v如果没有安装，去 Node.js 官网 下载 LTS 版本。
二、安装 CodeGraph
2.1 使用 npm 安装（推荐）
打开 PowerShell，执行：
npm install-g @colbymchenry/codegraph--registry=https://registry.npmmirror.com为什么用淘宝镜像？国内网络直接安装可能失败，淘宝镜像速度更快。
2.2 验证安装
codegraph--version显示版本号（如0.9.9）即表示安装成功。
三、建立项目索引
进入你的项目目录，初始化 CodeGraph：
cd F:\你的项目路径 codegraph init-i这个过程会：
- 扫描所有代码文件
- 分析类、函数、调用关系
- 建立知识图谱数据库
耗时参考：
- 小型项目（< 500 文件）：1-2 分钟
- 中型项目（500-2000 文件）：10-30 分钟
- 大型项目（> 2000 文件）：30-60 分钟
💡 首次索引会比较慢，之后增量更新就快了。建议在空闲时运行。
四、配置 Trae MCP
4.1 创建配置文件
在C:\Users\你的用户名\.cursor\目录下创建mcp.json文件。
如果目录不存在，手动创建。
4.2 写入配置
{"mcpServers":{"codegraph":{"command":"codegraph","args":["serve","--mcp","--path","F:\\你的项目路径"],"cwd":"F:\\你的项目路径"}}}关键点：
--path参数必须指向你的项目根目录，否则 CodeGraph 找不到索引。
4.3 重启 Trae
完全退出 Trae（任务管理器结束进程），重新打开。
五、验证安装
5.1 检查 MCP 状态
在 Trae 中按Ctrl+Shift+P，输入 “MCP”，查看 codegraph 是否显示 “Running”。
5.2 测试查询
在 Trae AI 对话框中输入：
{"kind":"class","query":"你的业务关键词","limit":5}如果能返回结果，说明配置成功。
六、常见问题与解决方案
6.1 SSL/TLS 错误
错误信息：请求被中止: 未能创建 SSL/TLS 安全通道
原因：GitHub raw 域名被限制
解决方案：使用 npm 安装（见 2.1），不要使用irm命令。
6.2 C 盘空间不足
现象：多次安装失败导致 C 盘变红
解决方案：
# 清理 npm 缓存npm cache clean--force# 迁移缓存到 D 盘npm configsetcache"D:\nodejs-cache\npm-cache"# 查看并清理不必要的全局包npm list-g--depth=0 npm uninstall-g 包名6.3 MCP 连接失败
错误信息：No CodeGraph project is loaded for this session
原因：CodeGraph 启动时没有指定项目路径
解决方案：在mcp.json中添加--path参数（见 4.2）
6.4 索引一直跑不完
解决方案：排除不需要的目录
codegraph init-i--ignore"**/node_modules/**,**/dist/**,**/*.test.js"七、使用技巧
7.1 创建专用 AI 智能体
在 Trae 中创建 “CodeGraph Analyzer” 智能体，系统提示词：
你是代码分析专家，通过 CodeGraph 分析代码。 当你遇到以下问题，必须使用 CodeGraph： - "找出所有调用 X 函数的地方" - "修改 X 会影响哪些代码？" - "X 函数的完整调用链路是什么" - "哪些核心函数没有被测试覆盖" 直接用自然语言回答，不需要展示调用细节。 项目路径：F:\你的项目路径7.2 常用查询（自然语言）
| 你想知道 | 就这样问 |
|---|---|
| 找所有调用 X 的地方 | “找出所有调用 refund 函数的地方” |
| 分析影响范围 | “修改 checkGroupBuyTeanOver 会影响哪些代码？” |
| 理解业务流程 | “画出从创建订单到退款的完整调用链” |
| 找未测试代码 | “哪些核心函数没有被测试覆盖？” |
| 找特定类 | “项目中所有 Service 类有哪些？” |
7.3 更新索引
代码有重大变更时：
cd F:\你的项目路径 codegraph init-i八、效果对比
| 场景 | 不用 CodeGraph | 使用 CodeGraph |
|---|---|---|
| 找调用者 | 手动搜索，可能遗漏 | 精确返回所有调用位置 |
| 理解流程 | 打开多个文件，手动梳理 | 自动生成调用链 |
| 影响分析 | 凭经验猜测 | 精确到每个依赖 |
| Token 消耗 | 基准 | 降低约 57% |
| 响应速度 | 慢（需要搜索） | 快（直接查索引） |
九、总结
安装 CodeGraph 核心就四步：
npm install -g @colbymchenry/codegraphcd 项目目录 && codegraph init -i- 配置 Trae 的
mcp.json - 重启 Trae
配置成功后，你的 AI 就拥有了项目的"内部地图"，可以精准回答关于代码结构、调用关系、影响范围的问题。
附录：完整配置文件模板（比固定值更灵活一点）
位置：C:\Users\你的用户名\.cursor\mcp.json
{"mcpServers":{"codegraph":{"command":"codegraph","args":["serve","--mcp","--path","${workspaceFolder}"],"cwd":"${workspaceFolder}"}}}希望这篇文章能帮助你顺利完成安装。如果有问题，欢迎交流讨论！