用 Claude Code 重构：先计划、小步走、测试保持通过

重构：Claude Code 能做什么

• 小步推进重构待办，每一步都是单独的 pull request。
• 每一步前后都运行测试，测试失败就停下。
• 做迁移中机械性的部分：跨代码库重命名、API 升级、换用新的库。
• 删除死代码和重复逻辑，并说明每一处删除的理由。

重构：Claude Code 的相关功能

重构：怎么设置 Claude Code

1. 连接工具

   没有需要连接的东西。让重构安全的是一个 Claude 能运行的测试命令，以及每一步的大小限制，所以把这两样都写进 CLAUDE.md，并从一个 worktree 开始。

   # 在单独的 worktree 里开始重构
   claude --worktree billing-async
   
   # 在任何编辑之前，先就计划达成一致
   /plan Move the billing module from callbacks to async/await

2. 把规则写进 CLAUDE.md

   Claude Code 在每次会话开始时都会读取 CLAUDE.md，claude -p 运行也一样。把这项工作的规则写在这里；规则很长的话，放进 .claude/skills/ 下的一个 skill。见 CLAUDE.md 指南。

   ## 重构规则
   - 不改变行为。如果某个测试不得不改，停下来问。
   - 开始前和每一步之后都运行 `npm test`。
   - 每个 pull request 只做一步，改动不超过 400 行。
   - 保持 REFACTOR.md 最新：勾掉做完的，
     补上新发现的。
   - 未经询问，不碰 migrations/、生成的文件或公开 API。

3. 不打开交互界面运行

   claude -p 运行一个任务后就退出，所以 cron、CI 或别的工具都能启动它。用 --allowedTools 或 --permission-mode 决定它不经询问可以做什么；--output-format json 会连同花费一起返回结果。

   # 每天从 REFACTOR.md 的待办里做一步
   claude -p "做 REFACTOR.md 里下一个没勾选的项，并保持测试通过" \
     --allowedTools "Bash(npm test),Read,Edit"

4. 设成定时运行

   用 /schedule 做成云端定时任务（Pro、Max、Ultra、Team 和 Enterprise 可用），或者用桌面定时任务，会话开着时也可以用 /loop。见如何让 Claude Code 主动工作。

来源：Claude Code 文档

局限与安全

• 没有测试，它就分不清重构和行为变化。先给这块代码补上测试。
• 一次性的大重写很难审查。小步推进、每步都合并，更安全，最终也更快。
• 它不知道哪些奇怪的代码是故意这么写的。用注释或在规则里标出这些地方。
• 从 Claude Code v2.1.302 起，claude -p 以 Manual 模式启动：需要批准的操作，除非有规则允许，否则一律拒绝。只放行这项工作需要的工具。

重构，用 Claude Code 还是 Codex？

规则可以通用。只在 AGENTS.md 里写一次，再在 CLAUDE.md 里放一行 @AGENTS.md，两个 agent 读的就是同一个文件。

另一个 agent 的分步做法：Codex 重构。

重构，交给专人负责

命令只在有人记得时才会运行。Crewmark 把你自己的 Claude Code 变成一个 AI 员工，有岗位、量化目标、工作时间和心跳，工作就会按时完成，并出现在看板上。

1. 从岗位开始

   AI 软件工程师，岗位说明里写上这些规则。

2. 把工作放到它的看板上

   把这项工作加成周期 issue。员工按心跳醒来，做完后在评论里汇报。

3. 相关内容

   代码审查会在每一步合并前检查它。

常见问题