前言
在使用 Claude Code 开发大型项目时，经常会遇到以下问题：
- 项目代码量大，AI 需要频繁读取文件
- Token 消耗过快
- 调用链分析不准确
- 重构时容易遗漏引用关系
- SpringBoot 项目 Controller → Service → Mapper 路径复杂
为了解决这些问题，我目前主要使用：
- CodeGraph
- Serena
两者配合后，可以显著提升 Claude Code 对项目的理解能力。
一、工具定位
CodeGraph
定位：
项目级知识图谱主要解决：
- 项目结构理解
- 模块关系分析
- 依赖关系分析
- 架构理解
类似于：
给 Claude 提供项目地图适用场景
例如：
分析整个项目架构项目有哪些模块用户登录流程在哪些模块中流转AI Provider 与聊天模块关系CodeGraph 非常擅长。
核心能力
常用工具：
codegraph_explore codegraph_node能力：
- 项目知识图谱
- 模块依赖关系
- 调用关系概览
- 项目整体理解
Serena
定位：
代码级语义导航主要解决：
- 找类
- 找方法
- 找引用
- 找实现类
- 调用链分析
类似于：
给 Claude 提供 IDEA 的 Ctrl+B 和 Find Usage适用场景
例如：
谁调用了 UserService.login()分析登录流程selectPlaceOfResidence SQL 从哪里调用AiProviderService 被哪些地方引用Serena 非常擅长。
核心能力
常用工具：
find_symbol find_referencing_symbols find_implementations find_declaration get_symbols_overview能力：
- 查找定义
- 查找引用
- 查找实现类
- 调用链分析
- 重构影响分析
二、CodeGraph 与 Serena 的区别
| 对比项 | CodeGraph | Serena |
|---|---|---|
| 项目架构分析 | √ | × |
| 模块关系分析 | √ | × |
| 类定位 | △ | √ |
| 方法定位 | △ | √ |
| 查找引用 | × | √ |
| 调用链分析 | △ | √ |
| 重构辅助 | × | √ |
| 项目整体理解 | √ | △ |
推荐组合：
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安装 uv
PowerShell：
winget install--id Astral-sh.uv验证：
uv--version安装 Serena
uv tool install serena-agent验证：
serena--help验证 Serena
启动：
serenastart-mcp-server--context=claude-code--project-from-cwd正常日志：
Starting Serena server Loaded tools Starting MCP server说明安装成功。
查看安装位置
where.exe serena例如：
C:\Users\admin\.local\bin\serena.exe五、Claude Code 配置
查看 MCP：
claude 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 的基础配置长期保留。
