如果团队已经接入 Claude Code CodeGraphMCP 代码图谱可以换一套更省心的问法提 codegraphAgent 会优先走图谱分析而不是盲扫全仓库。前言你是不是也这样用 AI 写代码一上来就让 Agent批量 Read 文件token 烧得飞快改一个方法不知道还有谁在调用默默奇妙就改出一堆的问题新人接手老项目代码不知道在哪里看需求还在「找入口、找链路」如果团队已经接入Claude Code CodeGraphMCP 代码图谱可以换一套更省心的问法提codegraphAgent 会优先走图谱分析而不是盲扫全仓库。适用读者用 Claude Code 的前端/后端/全栈同学、Tech Lead、刚接手老项目的开发者。屎山代码维护者的福音也可能是地狱。没人喜欢维护这种代码就怕连锁反应问题越改越多。30 秒快速入门场景你要什么一句话模板熟悉架构模块、入口、接口「借助 codegraph 分析当前项目…」改代码影响面 安全修改「先用 codegraph 追踪 XXX 方法…」排查链路接口全链路 / 循环依赖「通过 codegraph 梳理 /api/xxx…」新增功能对齐现有规范「先通过 codegraph 看同模块已有实现…」三条技巧对话里带codegraph大改后跑codegraph syncAI 不调用图谱时加「强制优先 codegraph」一句。1CodeGraph 解决什么问题传统方式里Agent 靠Grep / Read / Glob摸项目结构常见问题痛点图谱方式文件多、上下文不够查符号、调用链、依赖改一处、漏影响面先impact / callers再改接口 Bug 难定位HTTP 链路一层层追重复探索、成本高索引一次多次查询CodeGraph 会把代码解析成本地知识图谱类、函数、调用关系、模块依赖等通过MCP暴露给 Claude Code。 你不需要背一堆 MCP 工具名——在对话里写codegraphAgent 会自动选用图谱能力。2四大场景怎么选先看这张表复制日常查架构 → 新人接手、看整体结构 改代码 → 改函数 / 接口 / 逻辑最常用 排查问题 → 联调、性能、循环依赖 新增功能 → 新接口、新工具类、新模块1.2.3.4.下面每个场景都配有可直接复制的对话框模板把XXX换成你的类名、方法名、接口路径即可。一、快速熟悉项目 / 架构适合新人接手、技术评审前、重构前摸底。模板 1查看项目整体模块与入口复制借助 codegraph 分析当前项目输出 1. 项目核心目录结构与主要模块划分 2. 程序入口文件、启动流程 3. 核心对外接口/服务列表1.2.3.4.模板 2梳理类的继承 / 依赖关系复制用 codegraph 解析梳理 XXX 类的继承链、依赖的其他类和被哪些类调用。1.示例替换UserService、OrderController二、修改已有代码最常用适合改函数、改接口字段、修逻辑、小步重构。模板 1改单个方法先查影响范围复制先用 codegraph 追踪 getPolicyInfo 方法 1. 所有调用方、调用链路 2. 该方法依赖的内部函数、外部接口 3. 列出修改后可能受影响的文件与逻辑 再基于分析结果优化这个方法保证原有功能不变。1.2.3.4.5.把getPolicyInfo换成你要改的方法名。模板 2修 Bug先拉完整上下文复制调用 codegraph 获取 XXX 函数完整上下文、周边代码与调用场景分析报错原因并给出修复代码。1.模板 3重构拆分 / 简化复制基于 codegraph 分析的代码依赖与调用关系对当前方法做重构保证所有调用处兼容不改动原有入参和出参。1.主编建议大仓改代码务必先跑「影响范围」模板再让 Agent 写 patch。三、接口 / 链路排查适合联调对不上、接口慢、怀疑循环依赖。模板 1追踪接口全调用链路复制通过 codegraph 梳理 /api/policy/query 这个接口的完整执行链路控制器 → Service → 数据层标注每一层核心逻辑。1.模板 2循环依赖 / 冗余调用复制使用 codegraph 检查当前模块是否存在循环依赖、重复调用的问题并给出优化方案。1.四、新增功能 / 接口适合加新 API、加工具方法、扩模块。模板 1参照现有规范新增接口复制先通过 codegraph 查看同模块下已有的接口实现规范、入参出参格式、异常处理逻辑再仿照风格新增一个 XXX 接口。1.模板 2新增工具类 / 公共方法复制结合 codegraph 看项目现有工具类的设计风格在对应目录新增一个公共方法同时标注使用场景。1.五、专项单测 代码检查模板 1按逻辑生成单元测试复制用 codegraph 读取 XXX 方法的逻辑、入参分支、依赖项基于现有项目规范编写对应的单元测试用例。1.模板 2冗余 / 重复代码检查复制借助 codegraph 分析项目找出重复逻辑、冗余代码并给出合并优化建议。1.六、高阶强制 Agent 优先用图谱如果 AI直接读文件、不调用图谱在对话末尾加这句复制分析代码时优先使用 codegraph 获取符号、调用链、依赖关系不要直接批量读取文件。1.这句话相当于给 Agent 加硬约束适合老项目、超大仓。七、三条使用技巧团队常踩坑技巧 1关键词简写对话里直接写codegraph一般即可触发对应 MCP 能力不必背工具全名。技巧 2改完代码记得同步索引代码有较大变动后执行复制codegraph sync1.再提问避免图谱还是旧结构。技巧 3大项目先「影响分析」再改优先用第二节模板 1追踪方法 影响面再进入实现。 能显著降低「改 A 坏了 B」的线上风险。八、推荐工作流非常简单复制提问带 codegraph ↓ 图谱结构 / 调用链 / 影响面 ↓ Agent方案 or 补丁小步 ↓ 你Review 测试 ↓ 大改后codegraph sync小结从「读文件摸黑」到「先问图谱再动手」以前现在让 AI 扫一堆文件让 AI 查调用链、依赖、影响面改完才发现牵连广改前先列受影响文件新人三周摸结构模板 1 半天出架构图式说明