Claude Code 架构分析

用 Claude Code 梳理代码库结构、模块边界、数据流、架构决策和重构风险，把大需求拆成可验证的小计划。

架构分析是“我有一个功能想法”和“让 Claude Code 开始改文件”之间的关键步骤。它的目标不是先画一张漂亮图，而是先理解当前系统，找出高风险边界，并把大改动拆成可审查、可验证的小计划。

先做代码地图

进入一个项目后，先让 Claude Code 检查仓库，而不是马上设计新系统：

请梳理这个代码库：入口文件、主要模块、数据流、构建命令、测试命令，以及改动风险较高的区域。不要编辑文件。

如果已经有明确功能，就把范围缩小：

请找出订阅升级流程涉及的文件，解释前端流程、服务端校验、支付服务调用、数据库写入和错误处理。

这一步的重点是建立可靠的系统认知。图可以后面画，但不能替代代码检查。

范围	要回答的问题
模块边界	UI、业务逻辑、数据访问、后台任务和外部 API 分别由哪些模块负责？
数据流	数据从哪里进入，在哪里校验，最终写到哪里？
权限	哪些角色、API key、token 或 MCP 工具能触达这条路径？
状态	状态分别存在数据库、缓存、客户端、队列还是第三方服务里？
失败模式	网络调用、支付、任务或迁移失败时，系统会如何处理？
测试	现有测试覆盖了哪里，还需要补哪些回归测试？

架构类任务建议先进入 Plan Mode：

claude --permission-mode plan

然后要求它给出可审查的计划：

请分析当前 billing 架构，并提出增加年度订阅的最小安全方案。需要包含影响文件、数据模型变化、支付服务调用、测试命令和回滚步骤。

只有当计划和当前代码、业务约束一致时，再批准进入实现。

如果方案里有取舍，要求 Claude Code 输出简短的架构决策记录：

请为这个方案写一份简短 ADR，包含背景、决策、备选方案、影响和需要运行的检查。

需要长期复用的约束，可以放进项目文档或精简后的 CLAUDE.md，避免每次会话重复解释。

如果探索会产生大量日志和文件内容，可以把研究任务交给 subagent：

请使用 subagent 调查 reporting 模块如何生成 dashboard 指标。只返回相关文件、流程摘要、风险点和建议测试。

Subagents 适合做上下文很重的探索，但最终实施计划仍然建议回到主会话里统一审查。

当 Claude Code 已经检查过相关文件后，再让它生成轻量图：

请基于你已经检查过的文件，生成 checkout 流程的 Mermaid sequence diagram。无法确认的步骤请标注为假设。

图应该总结已验证的代码路径，而不是替代真实代码。

请分析当前 auth 架构，列出用户模型、session 流程、中间件、路由守卫和鉴权落点。不要编辑文件。

请比较两种增加 usage limits 的方案，必须基于现有数据库 schema 和服务边界来讨论。

编辑前请列出这次重构的最小改动集合，以及证明行为没有变化的具体命令。

下一步：上下文管理 - 让大项目会话保持聚焦。