接手陌生代码库第一天问哪五个问题

官方文档的建议是「把 Claude 当资深同事问」,不需要特殊 prompt 技巧;本页把这个建议编排成第一天就能执行的五问清单,每问一个目的,问完顺手沉淀进 CLAUDE.md。

一句话结论

做法步骤

1. 准备:进入项目根目录跑 claude,按 Shift+Tab 切到 plan mode(状态栏显示 ⏸ plan mode on),Claude 只读文件不做修改,适合第一天纯探索。官方官方推荐「explore first」并从宽泛问题开始、逐步收窄。参见 D5 · plan mode。
2. 问题一 · 架构总览:先要一份鸟瞰图——仓库做什么、分几个模块、什么技术栈和架构模式。官方这是官方文档「Understand new codebases」的第一步,原句 prompt 就是 give me an overview of this codebase,再追问 explain the main architecture patterns used here。预期得到模块清单和它们的职责。
3. 问题二 · 入口与数据流:程序从哪启动、一次典型请求走过哪些层。官方官方 recipe:trace the login process from front-end to database——换成你项目里最核心的一条链路。预期得到带文件名的调用路径。
4. 问题三 · 构建测试跑法:怎么装依赖、怎么本地跑起来、怎么跑测试和 lint。本站观点把命令要到手并当场跑一遍,是第一天最实在的验收——跑不通的项目文档等于没有。
5. 问题四 · 约定与雷区:这个项目哪些做法和默认习惯不一样。官方官方 tips 明确建议「ask about coding conventions and patterns used in the project」并「request a glossary of project-specific terms」。预期得到术语表 + 差异化约定清单。
6. 问题五 · 最近在改什么:让 Claude 读 git 历史,总结活跃分支和高频改动文件。官方best practices 的「Point to sources」模式:与其问「这个 API 为什么这么怪」,不如让它 look through the git history and summarize。你会知道团队正在推进什么、哪些区域是雷区。
7. 收尾 · 沉淀:跑 /init,它会分析代码库探测构建系统、测试框架与代码模式,生成一份初始 CLAUDE.md;把今天五问里的关键结论(命令、约定、雷区)补进去,用 /context 确认它已被加载。官方CLAUDE.md 每次会话都会读,只放普适内容、保持精简。参见 D4 · CLAUDE.md 与 rules。

本站观点大仓库里问题一、二容易读进大量文件挤爆上下文:让 Claude「用 subagent 去调查」,只把结论带回主会话(参见 D10 · Subagents);两问之间上下文变脏就 /clear。

可直接抄的 prompt

我今天刚接手这个代码库,请在只读前提下按顺序帮我回答五个问题,每答完一个停下来等我确认:
1) 架构总览:这个仓库做什么?分几个模块,各自职责是什么?用了什么技术栈和架构模式?
2) 入口与数据流:程序从哪里启动?挑一条最核心的链路,给出从入口到落库(或输出)的完整调用路径,带文件名。
3) 构建与测试:本地怎么装依赖、怎么跑起来、怎么跑测试和 lint?把命令逐条列出来。
4) 约定与雷区:这个项目有哪些和默认做法不同的编码约定、命名习惯?整理一份项目专有术语表,并指出新人容易踩的坑。
5) 最近在改什么:读最近 30 条 git log 和活跃分支,总结团队正在推进什么、哪些文件改动最频繁。
探索大目录时用 subagent,别把文件内容全读进主上下文。
最后把 1–4 的结论压缩成要点清单,我会用它补充 CLAUDE.md。

问完后运行 /init 生成 CLAUDE.md,再把上面的要点清单让 Claude 合并进去。

来源与最后核实日期

• 官方Common workflows · Understand new codebases,抓取于 2026-08-05。
• 官方Best practices for Claude Code(/init、CLAUDE.md、plan mode、subagents、Point to sources),抓取于 2026-08-05。
• 最后核实:2026-08-05 · volatility:low(五问是方法论;涉及的 /init /context plan mode 为现行产品行为)。