开发者：旧项目重构实战

场景背景

你接手了一个两年前写的 Express.js 后端项目。代码没有类型检查、路由全堆在一个文件里、错误处理靠 try-catch 套娃、没有测试。领导说"先别加新功能，把代码整理一下"。

你打算用 Claude Code 来辅助重构——让它分析问题、制定计划、逐步执行，同时用检查点保护每一步的成果。

你将学到： 如何用 CLAUDE.md 传递项目上下文、用 Plan Mode 制定重构策略、用检查点安全回滚、用 Claude Code 执行结构化重构。

前置准备

• 已安装 Claude Code
• 有一个需要重构的项目（本案例以 Express.js 为例）
• 了解基本的 Git 操作

第一步：用 /init 创建 CLAUDE.md

进入项目目录，启动 Claude Code：

cd ~/projects/my-express-app
claude

在 Claude Code 中输入：

> /init

你会看到什么： Claude 会扫描项目结构，自动生成一个 CLAUDE.md 文件，里面包含项目的技术栈、目录结构、常用命令等信息。

为什么这样做： CLAUDE.md 是项目的"说明书"。有了它，Claude 每次启动都能快速理解这个项目是做什么的、用了什么技术、有哪些约定。这比每次对话都重复解释项目背景高效得多。

现在补充一些重构相关的上下文：

> 在 CLAUDE.md 里加上以下信息：
  - 这是一个需要重构的老项目
  - 重构目标：路由模块化、添加统一错误处理、逐步引入 TypeScript
  - 重构原则：每次只改一个方面，改完跑测试
  - 不要修改 API 的对外行为，只改内部实现

Claude 的回复（模拟）：

我来更新 CLAUDE.md，加入重构相关的规则和约束。

修改 CLAUDE.md...

已添加以下内容：
- 「重构目标」一节：路由模块化 → 统一错误处理 → TypeScript
- 「重构原则」一节：单一职责、不改对外行为、每步测试验证
- 「禁止事项」一节：不修改 API 入参和出参格式

为什么这样做： 把重构规则写进 CLAUDE.md，可以防止 Claude 在后续对话中"跑偏"——比如在你只想整理路由时，它顺手把数据库层也改了。