50个文件批量重命名不崩溃：Claude Code 的工程级重构实战手册
✅ 第一步：一句话激活“全项目意识”
❌ 错误问法（只改当前文件）：
Rename getUserData to fetchUser
✅ 正确问法（让 Claude 真正“看到”整个项目）：
Rename getUserData to fetchUser across the entire codebase.
Search every .js and .ts file.
Update all imports, all call sites, all type definitions.
Show me a list of every file you changed.
👉 这不是“多说了几个字”，而是告诉 Claude：你不是编辑器插件，你是代码库管家。
✅ 第二步：用 CLAUDE.md 给它钉个“任务便签”
改大功能时，把它当成长期搭档。临时加一段说明，Claude 就不会中途忘掉你在干啥：
## 当前重构范围
- 重命名：getUserData → fetchUser
- 涉及目录：src/**/*.ts, tests/**/*.ts
- 排除目录：node_modules, dist, build
- 每改完一个文件，检查 import 是否还能正常编译
📌 改完就删——干净利落，不污染长期配置。
✅ 第三步：500+ 文件？别单线程硬拖，开 4 个“子工兵”
就像项目经理分派任务一样，让 Claude 同时派 4 个小队并行干活：
## 重构任务（并行模式）
请拆成 4 个子任务同步执行：
Subagent 1：负责 src/api/ 下所有 .ts 文件中的 getUserData → fetchUser
Subagent 2：负责 src/components/ 下所有 .ts 文件
Subagent 3：负责 src/utils/ 下所有 .ts 文件
Subagent 4：负责 tests/ 下所有测试文件
每个子任务必须：
1. 先列出它要修改的全部文件名
2. 再批量修改
3. 修改后明确报告：“Subagent X 完成 ✔️”
等全部 4 个都报告完成，再汇总结果。
⏱ 实测：500+ 文件重构从 18 分钟 → 压缩到 4 分半。
✅ 第四步：安全第一！每改 10 个文件就“踩一脚刹车”
破坏性重构（比如改 API 名、删字段），千万别一口气到底。用「检查点」兜底：
重构目标：getUserData → fetchUser
每处理完 10 个文件，请立即：
- 执行命令：tsc --noEmit（只检查类型，不生成代码）
- 如果报 TypeScript 错误：立刻暂停 + 把错误原样贴给我
- 不修复错误，绝不继续下一步
全部完成后：
- 自动运行：npm test 或 yarn test（按你项目实际命令）
- 最后输出：本次共修改 N 个文件 + git diff 统计摘要（如：+12 行，-8 行，0 个冲突）
🛡️ 这招能让你在“改崩第 11 个文件”时就停下，而不是在第 50 个才发现整个登录流程挂了。
✅ 第五步：动手前先让它“画张地图”——解释优先模式
尤其面对陌生项目或复杂导出链（比如 barrel 文件层层 re-export），务必先让 Claude 做功课：
在任何修改前，请先帮我搞清这 4 件事：
1. 所有含 getUserData 的文件路径（用 grep -r 输出）
2. 它被怎么调用的？是直接调用？解构赋值？还是通过 export * from 'xxx' 间接暴露？
3. 有哪些坑可能踩？比如某个 test 文件 mock 了旧名、或者某个 .d.ts 声明没同步？
4. 你建议按什么顺序改？（例如：先改类型定义 → 再改实现 → 最后改测试）
等我回复“OK，开始”之后，你才能动第一行代码。
🔍 我们真遇到过：函数被 3 个 barrel 文件分别 re-export，只改源文件会导致另外 2 处调用直接报错——这个“地图”提前 3 分钟就救了命。
✅ 终极省心模板：放进 CLAUDE.md，一劳永逸
我把这套流程固化成一个可复用协议，每次重构只要写一句 rename getUserData to fetchUser，它就自动走完整流程：
## 重构协议（全自动守则）
当我发出“rename X to Y”指令时，请严格按以下步骤执行：
1. 先运行：grep -r "X" src/ （只搜 src 目录）
2. 统计并告诉我：共 N 个文件匹配，列出全部路径
3. 暂停，等我回复“Proceed?”才继续
4. 批量修改所有匹配文件
5. 自动运行：tsc --noEmit 验证
6. 最终报告：“✅ 完成！共改 N 个文件；TypeScript 检查：通过”
⚠️ 规则铁律：
- 没我明确说“Proceed?”，绝不改任何一行代码
- 中途出错必须立刻中止 + 原样反馈错误，不尝试“猜着修”
💡 关于成本：别为 token 焦虑，换个接入方式更划算
批量读 50 个文件 + 写 50 个文件，token 消耗确实高。如果你用 Anthropic 官方按 token 计费（$0.015/千输入 token），一次大重构可能花 $3–8。
我的解法：换用 SimplyLouie（$2/月固定包）——
完全兼容 Claude 模型（包括最新 claude-sonnet-4-5），API 调用方式一模一样，只需改一行环境变量：
export ANTHROPIC_BASE_URL=https://api.simplylouie.com
✅ 效果：token 不计费、响应更快、重构想搞几次搞几次，毫无心理负担。
直达网址：https://simplylouie.com
