用 Claude Code 沿一条功能路径读懂代码

选择一个可以追踪的动作

第一次接触仓库时，“解释整个项目”往往范围过大。先选一个具体动作，例如点击保存草稿、提交搜索或刷新列表。你的目标是找出入口、数据经过的位置、失败怎样出现，以及最后如何确认结果。Claude Code 官方文档包含代码库概览与功能追踪示例；下面将它具体化为阅读清单。

第一步 明确这次只读

说明本轮只阅读和解释，不修改文件、不安装依赖、不发起生产请求。先查看项目自带的说明、目录结构及运行入口，再要求 Claude 列出与该功能有关的少量文件。仓库中可能有密钥或个人数据，只应处理获得授权的内容；在受保护的副本中探索更容易控制范围。

第二步 从界面事件逐段往下找

以下路径是虚构教学示例，并不表示你的项目一定采用这些文件名：Editor 页面触发 useDraft，后者请求 /api/drafts，服务端再调用 draftRepository 保存数据。对每一段都要求给出真实文件位置、函数或组件名，以及发现这个连接的证据。

不要只看命名相似就画箭头。要检查事件绑定、函数调用、路由注册或依赖传入。假如发现页面只把内容放进浏览器状态，就不能写“已保存到数据库”。如果某一段通过动态配置才能确定，应标注“需要运行环境确认”。

第三步 同时追踪失败路径

正常流程之外，再问三个问题：输入在哪里验证；网络或存储失败由谁处理；界面什么时候显示成功。沿着同一条路径看错误是否被捕获、忽略或替换成默认值。看到注释写“稍后重试”时，还需要找到重试实现，不能把注释当作实际行为。

交付一份短地图即可：用户动作、关键步骤、文件与符号、已知证据、未解决问题。源码行号会随改动变化，因此可以同时记录本次查看的提交标识。对敏感路径不要在公开教程中贴出真实配置或内部地址。

最后回到实际文件核对

检查清单：每条调用关系是否有证据；界面缓存与持久存储是否分开；同步与异步边界是否清楚；异常分支是否覆盖；哪些判断依赖尚未读取的外部服务。挑一个关键节点自己打开文件复核，再决定是否进入修改任务。

静态阅读适合建立初步理解，不能证明线上请求实际走过某条路径。需要运行确认时，应先约定测试环境、允许的请求与可观察日志。读懂代码和授权修改是两步，调查结果可以作为下一次任务的背景，不应自动变成执行许可。