分析陌生项目时，最危险的做法是直接问“帮我看懂全部代码”。更可控的方法是先找入口和依赖，再追踪一条真实调用链，最后才定位要改的代码。
第一轮：只建目录地图
先让 Claude 只读 README、依赖清单和顶层目录，不要立即修改。
不要修改文件。读取 README、依赖清单和顶层目录，列出：
- 启动入口
- 构建与测试命令
- 主要模块
- 仍无法确认的事项
每个结论给出文件路径。第二轮：选择一条用户路径
例如登录、创建订单或上传文件。让 Claude 从路由或命令入口开始，依次列控制器、服务、数据访问和外部依赖。每个结论都要求给出文件路径和符号名。
第三轮：只定位相关代码
输入：“现在只关注空搜索结果。列出直接决定该行为的文件、现有测试和可能副作用，不要改代码。”这样能把“项目介绍”收敛为可执行的修改范围。
人工核验
随机抽查三处文件路径，并从入口手工沿调用链走到最终模块。再运行文档写明的启动或测试命令，确认 Claude 没把已废弃目录当主路径。
仓库说明可能过时，Claude 的结构图必须以当前文件和构建配置为依据。生成的架构图是导航资料，不是自动证明。
大型仓库怎么缩小范围
面对 monorepo，先指定业务入口或用户路径，再让 Claude 只读取相关 workspace 的依赖文件。把 generated、vendor、dist 和缓存目录排除在第一轮之外；只有调用链确实进入这些目录时再读取。若仓库同时有旧版与新版入口，要求它用构建脚本、路由注册或实际引用证明哪一个在使用。
核对清单
- 入口能从启动命令追到实际文件。
- 依赖来自清单与锁文件，不是仅凭 import 猜测。
- 调用链每一步都有符号和路径。
- 不确定项明确写出，未把推测当结论。
资料与适用范围
分层探索方法参考 Claude Code 常用工作流；项目规则读取参考 Memory 文档。示例未在你的仓库执行，最终结论需打开源文件核实。
Ai菜鸟网。发布者：AI小管家，转载请注明出处：https://www.alyyhw.com/30875.html
