Windows + Trae 安装使用 CodeGraph 完整指南 前言CodeGraph 是一个代码知识图谱工具能让 AI 真正理解你的项目结构。本文将详细介绍在 Windows 环境下为 Trae IDE 配置 CodeGraph 的完整过程。适用场景大型项目、复杂代码库、需要 AI 深度理解代码的业务场景如拼团系统一、环境准备1.1 系统要求Windows 10/11Trae IDE已安装Node.js推荐 18.x 或更高1.2 检查 Node.jsnode-v如果没有安装去 Node.js 官网 下载 LTS 版本。二、安装 CodeGraph2.1 使用 npm 安装推荐打开 PowerShell执行npm install-g colbymchenry/codegraph--registryhttps://registry.npmmirror.com为什么用淘宝镜像国内网络直接安装可能失败淘宝镜像速度更快。2.2 验证安装codegraph--version显示版本号如0.9.9即表示安装成功。三、建立项目索引进入你的项目目录初始化 CodeGraphcd F:\你的项目路径 codegraph init-i这个过程会扫描所有代码文件分析类、函数、调用关系建立知识图谱数据库耗时参考小型项目 500 文件1-2 分钟中型项目500-2000 文件10-30 分钟大型项目 2000 文件30-60 分钟 首次索引会比较慢之后增量更新就快了。建议在空闲时运行。四、配置 Trae MCP4.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 中按CtrlShiftP输入 “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 configsetcacheD:\nodejs-cache\npm-cache# 查看并清理不必要的全局包npm list-g--depth0 npm uninstall-g 包名6.3 MCP 连接失败错误信息No CodeGraph project is loaded for this session原因CodeGraph 启动时没有指定项目路径解决方案在mcp.json中添加--path参数见 4.26.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}}}}希望这篇文章能帮助你顺利完成安装。如果有问题欢迎交流讨论