适合哪些场景

以下是 Claude Code 上线以来被反复验证的六类真实场景。每一类都给一个 mini 例子，你可以照着改成自己的项目。

1. 大范围重构

跨几十上百个文件的重命名、API 迁移、组件替换，是 Claude Code 最舒服的场景。它可以先扫一遍代码建立索引，再按 batch 修改，中间自动跑测试确认没搞崩。

claude "把项目里所有 axios 调用改成 fetch，保持错误处理语义一致，改完跑 npm test"

它会先列出改动清单（多少个文件、每处大致改什么），等你放行后再动手。中途遇到测试失败会自己回头修，不需要你反复复制错误信息。

提示

重构类任务开始前，先让它输出一个改动清单，你审一遍再放行，避免它自作主张改动无关文件。加一句 只改 src/ 下的文件，别动 tests/ 也能有效收敛范围。

2. 修 bug 从复现到测试

复现、定位、修、补测试，这四步是 Claude Code 最标准的闭环。你甚至可以只丢一个错误日志给它，让它自己去搜代码定位。

claude -p "$(cat error.log)

复现这个错误，找到根因，修好后加一个回归测试。"

它会读日志堆栈，grep 相关文件，写一个复现脚本，改代码，再跑测试确认从红变绿。整个过程你只需要在关键节点点确认，不用手动切换十几个终端窗口。

3. 读大代码库

刚接手一个陌生项目，通常要花一两天读代码。Claude Code 能把这个过程压缩到一次晚饭的时间。

cd unknown-project
claude
> 这个项目是干什么的？主入口在哪？给我画一张主要模块的依赖关系

它会按目录扫描 README、package.json、路由文件、核心模块的 import 关系，输出一份可读的架构小结。适合入职第一天、code review 老代码、评估要不要 fork 一个开源库。

4. 写 CI / CD 脚本

GitHub Actions、GitLab CI、Dockerfile、docker-compose，语法琐碎又要严格对齐环境。Claude Code 会直接读你项目现有配置，改起来不会想当然。

claude "给这个 Node 项目加一个 GitHub Actions，跑 lint 和 test，PR 时输出覆盖率变化"

它会看 package.json 猜测测试命令，参考现有的 .github/ 布局，写完之后建议你先在一个 branch 上跑一次再合并。这类活手工写又慢又容易踩缩进坑，交给它效率提升非常明显。

5. 写文档和教程

文档最容易过期，因为改代码的人不写文档，写文档的人不看代码。让 Claude Code 一边改代码一边同步文档，能大幅拉齐两者。

claude "刚才改了 src/api/user.ts，把 docs/api.md 里 user 相关部分同步更新，加一个 curl 例子"

写系列教程时也很好用：让它按现有代码结构生成章节大纲，你审一遍，再一节一节让它填充，风格保持一致。本教程站的初稿也是这么产出的。

6. 数据一次性任务

日志分析、CSV 清洗、JSON 结构转换、按规则批量重命名文件，这类写完就扔的活儿最适合 -p 一次性完成。

# 分析 nginx 日志异常来源
tail -1000 /var/log/nginx/access.log | claude -p "找出返回 5xx 的请求，按 IP 聚合，输出前 10 名"

# 批量重命名截图
ls *.png | claude -p "读文件名里的日期，按 YYYY-MM-DD 格式重命名"

不用再翻 awk / jq / sed 的语法手册，也不必为一次性活写一个正式脚本。Claude Code 把命令行的表达力发挥到了极致。

什么场景不适合

注意

Claude Code 不是万能药。以下几类活先想清楚再上：

• 强性能敏感的核心算法：LLM 写出的实现通常正确但不够快，最好由你写关键部分，让它辅助。
• 高安全边界：处理密钥、加密、鉴权协议时，必须人工审 diff，不要一键 accept all。
• 业务规则复杂但没写清楚：需求本身不确定时让 AI 猜，只会加剧混乱。先和产品对齐，再让它动手。

真正合适的姿势是：你定策略，它执行细节。策略越清晰，产出越可靠。掌握了什么该交给它、什么该自己盯，你就走完了新手期最难的一步。