Claude Code + CodeGraph 入门：四大场景对话模板，复制就能用

如果团队已经接入 Claude Code + CodeGraph（MCP 代码图谱），可以换一套更省心的问法：提 codegraph，Agent 会优先走图谱分析，而不是盲扫全仓库。

前言

你是不是也这样用 AI 写代码：

• 一上来就让 Agent批量 Read 文件，token 烧得飞快
• 改一个方法，不知道还有谁在调用，默默奇妙就改出一堆的问题
• 新人接手老项目，代码不知道在哪里，看需求还在「找入口、找链路」

如果团队已经接入Claude Code + CodeGraph（MCP 代码图谱），可以换一套更省心的问法：提codegraph，Agent 会优先走图谱分析，而不是盲扫全仓库。

适用读者：用 Claude Code 的前端/后端/全栈同学、Tech Lead、刚接手老项目的开发者。

屎山代码维护者的福音，也可能是地狱。没人喜欢维护这种代码，就怕连锁反应，问题越改越多。

30 秒快速入门

三条技巧：对话里带codegraph；大改后跑codegraph sync；AI 不调用图谱时加「强制优先 codegraph」一句。

1）CodeGraph 解决什么问题？

传统方式里，Agent 靠Grep / Read / Glob摸项目结构，常见问题：

CodeGraph 会把代码解析成本地知识图谱（类、函数、调用关系、模块依赖等），通过MCP暴露给 Claude Code。 你不需要背一堆 MCP 工具名——在对话里写codegraph，Agent 会自动选用图谱能力。

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 sync

• 1.

再提问，避免图谱还是旧结构。

技巧 3：大项目先「影响分析」再改

优先用第二节模板 1（追踪方法 + 影响面），再进入实现。 能显著降低「改 A 坏了 B」的线上风险。

八、推荐工作流（非常简单）

复制

提问（带 codegraph） ↓ 图谱：结构 / 调用链 / 影响面 ↓ Agent：方案 or 补丁（小步） ↓ 你：Review + 测试 ↓ 大改后：codegraph sync

小结：从「读文件摸黑」到「先问图谱再动手」