Claude Code 既有代码库地图: 45 分钟内读懂、修改并验证

为什么需要这套流程

Claude Code 在既有代码库里通常更有价值，因为上下文、组件和真实问题都已经存在。但第一次会话也更危险。如果一开始就要求大规模重构，最后得到的 diff 很难审查。更稳妥的做法是先做地图: 入口在哪里，哪些文件可以碰，哪些区域今天不要碰，以及哪个小改动可以立刻验证。

如果要补齐上下文，可以一起阅读 Claude Code 入门, harness engineering, 权限指南。

实际工作中的步骤

45 分钟循环包括五步: 记录状态、梳理文件、选择一个边界清楚的改动、运行一个验证命令、留下交接备注。对于内容站，还要把免费 PDF、Gumroad 商品、咨询 CTA 也纳入地图。

可以直接复制的最小套件

git status --short
rg --files | Select-Object -First 80
rg "TODO|FIXME|console\.log|throw new Error" -n site src scripts
cd site
npm.cmd run build

# CLAUDE.md

## Existing-codebase map
- entry points: site/src/pages, site/src/layouts, site/src/lib
- safe first task: update one CTA or one article
- risky areas: auth, billing, deploy scripts, secrets

## Definition of done
- small diff
- one proof command
- public URL or local preview checked
- next step written down

Read this repository as an existing codebase.
Return:
1. the three most important entry points
2. the safest first patch under 45 minutes
3. files that should not be touched today
4. the proof command
5. the handoff note format

三个真实使用场景

• 只调整一篇文章底部 CTA，确认免费 PDF 路径没有断。
• 在 CLAUDE.md 中加入安全命令、禁止区域和完成标准。
• 从热门文章增加一条到商品页的内部链接，并在公开 URL 上检查 h1 与 CTA。

失败案例与避免方法

常见失败是第一句就说“重构整个项目”。Claude Code 可以给出看似合理的改动，但范围太大后就无法信任。请先限制为一个文件、一个路径和一个验证命令。

免费 PDF、Gumroad 与咨询路径

如果还不熟悉，先用免费速查表跟着命令走。需要可复用的 CLAUDE.md、hooks、权限和团队规则时，Setup Guide 更合适。如果要设计团队落地或收入路径，就预约咨询。

• 免费 Claude Code 速查表
• Claude Code Prompt Templates
• Claude Code Setup Guide
• 商品列表
• 导入咨询

先用免费速查表建立基本习惯；当流程需要复用时购买 Gumroad 教材；如果涉及团队落地或收入路径设计，再预约咨询。

本文的验证记录

本文把 PowerShell 命令、可复用的 CLAUDE.md 片段和 CTA 验证清单分开，目的是让读者能直接放进真实仓库，而不是只得到一个笼统提示词。