工程 · Codebase Onboarding · 2026-06-15

一分钟读懂一个陌生的代码库

让 Claude Code 跑一遍 `/init`,自动绘出 50 万行项目的架构图、技术栈与关键模块。新人第一天不再"憋着不敢问"。

$ claude /init

→ Scanning 1,247 files across 12 packages...

→ Detecting framework: React 18 + Vite + TypeScript

→ Entry points: src/index.tsx, src/excalidraw-app/

→ Key modules: element/, scene/, renderer/, history/

✓ CLAUDE.md generated · 4,210 tokens

进新项目最难熬的是前三天:你不知道文件在哪、目录为什么这么分、哪个 service 是主干。以前靠 wiki 靠同事,现在我第一件事是让 Claude Code 跑一遍 /init。

它到底做了什么

Claude Code 会遍历仓库,识别语言与框架、找出 entry point、把关键目录的作用讲清楚,产出一份 CLAUDE.md。这个文件会成为后续所有对话的"背景介绍"。

不只是新人。老项目每半年跑一次也很有用——因为很多目录你以为你懂了,其实你早就忘了 6 个月前的自己为什么这么组织的。让 AI 重新给你讲一遍,会发现遗忘和误解。

"读代码"这件事以前是把大脑当解压器,现在可以先让 AI 把外壳拆开,大脑只看重点。
— 一次实操后的感想