前言在使用 Claude Code 开发大型项目时经常会遇到以下问题项目代码量大AI 需要频繁读取文件Token 消耗过快调用链分析不准确重构时容易遗漏引用关系SpringBoot 项目 Controller → Service → Mapper 路径复杂为了解决这些问题我目前主要使用CodeGraphSerena两者配合后可以显著提升 Claude Code 对项目的理解能力。一、工具定位CodeGraph定位项目级知识图谱主要解决项目结构理解模块关系分析依赖关系分析架构理解类似于给 Claude 提供项目地图适用场景例如分析整个项目架构项目有哪些模块用户登录流程在哪些模块中流转AI Provider 与聊天模块关系CodeGraph 非常擅长。核心能力常用工具codegraph_explore codegraph_node能力项目知识图谱模块依赖关系调用关系概览项目整体理解Serena定位代码级语义导航主要解决找类找方法找引用找实现类调用链分析类似于给 Claude 提供 IDEA 的 CtrlB 和 Find Usage适用场景例如谁调用了 UserService.login()分析登录流程selectPlaceOfResidence SQL 从哪里调用AiProviderService 被哪些地方引用Serena 非常擅长。核心能力常用工具find_symbol find_referencing_symbols find_implementations find_declaration get_symbols_overview能力查找定义查找引用查找实现类调用链分析重构影响分析二、CodeGraph 与 Serena 的区别对比项CodeGraphSerena项目架构分析√×模块关系分析√×类定位△√方法定位△√查找引用×√调用链分析△√重构辅助×√项目整体理解√△推荐组合CodeGraph ↓ 理解项目 Serena ↓ 定位代码 Claude Code ↓ 修改代码三、CodeGraph 安装安装根据官方文档安装。安装完成后验证claude mcp list输出codegraph ✔ Connected说明安装成功。使用方式Claude Code 中直接提问分析项目整体架构分析聊天模块与 AI 模块关系分析登录功能整体流程Claude 会优先调用codegraph_explore codegraph_node索引更新代码结构变化后建议重新构建索引。例如新增模块 大规模重构 包结构调整否则分析结果可能不完整。四、Serena 安装环境要求推荐Python 3.11 uv Claude Code安装 uvPowerShellwinget install--id Astral-sh.uv验证uv--version安装 Serenauv tool install serena-agent验证serena--help验证 Serena启动serenastart-mcp-server--contextclaude-code--project-from-cwd正常日志Starting Serena server Loaded tools Starting MCP server说明安装成功。查看安装位置where.exe serena例如C:\Users\admin\.local\bin\serena.exe五、Claude Code 配置查看 MCPclaude mcp list例如codegraph ✔ Connected serena ✔ Connected说明配置成功。六、推荐 AGENTS.md核心原则CodeGraph ↓ Serena ↓ Read File不要让 Claude 一开始就扫描大量文件。推荐规则Tool Priority 1. CodeGraph 2. Serena 3. File Reading Never start with recursive file reading.七、Spring Boot 项目最佳实践针对 SpringBoot 项目Controller ↓ Service ↓ Mapper ↓ Database分析顺序第一步CodeGraph理解模块关系。第二步Serena定位Controller Service Mapper Entity关系。第三步读取必要文件。避免全项目扫描 递归读取目录 大量 Read八、实际收益以 SpringBoot MyBatis 项目为例未使用Claude ↓ Read 20~50 个文件 ↓ 分析使用后CodeGraph ↓ Serena ↓ Read 3~5 个关键文件 ↓ 分析收益Token 消耗减少调用链分析更准确重构更安全SQL 定位更快大项目体验明显提升九、个人推荐当前优先级1. CodeGraph 2. Serena 3. Git MCP 4. Context7对于 Java / SpringBoot 开发者CodeGraph Serena 基本已经能够覆盖 80% 以上的代码分析场景。推荐作为 Claude Code 的基础配置长期保留。