第11章实战案例

约 2768 字大约 9 分钟

2026-06-07

这一章来分享几个我实际用过的案例，看完你就能感受到 Claude Code 到底能帮你干啥了。不扯虚的，都是真实场景。

案例1：从零搭一个个人博客网站

事情是这样的

假设你想做一个简单的个人博客，要包含首页、文章列表、文章详情三个页面。

怎么做？

第1步：建个文件夹

# 建一个项目文件夹并进入，就像盖房子先找块地
mkdir my-blog && cd my-blog

第2步：启动 Claude Code

# 启动 Claude，就像叫了个助手过来帮忙
claude

第3步：告诉 Claude 你想要什么

帮我从零创建一个个人博客网站。要求：
1. 用纯 HTML + CSS + JavaScript，不用框架
2. 包含三个页面：首页、文章列表页、文章详情页
3. 用简约的黑白风格
4. 文章数据先用一个 JSON 文件模拟
5. 支持响应式布局，手机端也能看

第4步：让 Claude 先规划一下

Claude 会分析你的需求，然后给出一个方案：

Claude：计划这样实现：
1. 创建项目结构：
   - index.html（首页）
   - blog.html（文章列表）
   - post.html（文章详情）
   - css/style.css（样式）
   - js/main.js（交互逻辑）
   - data/posts.json（模拟文章数据）
2. 首页包含个人介绍和最新文章推荐
3. 文章列表页展示所有文章的卡片
4. 文章详情页根据 URL 参数加载对应文章

看着没问题的话，让 Claude 开始干活就行。

第5步：看看效果，调整细节

Claude 做完之后，打开浏览器看看：

打开浏览器看看效果

觉得哪里不满意就继续调：

把标题颜色改成深灰色，行间距调大一点

给文章卡片加上圆角和阴影效果

提示

第一次做出来的东西不太满意很正常，关键是跟 Claude 说清楚哪里要改。比如"把标题改成深灰色"比"颜色不对"有效得多。

这个案例涉及哪些能力

能力	对应前面聊过的
启动 Claude Code	第2章
用大白话描述需求	第3章
查看文件内容	第3章
一步步调整到满意	第2章

我觉得最大的收获

Claude 真能从零给你搭出一个完整的项目
你不需要记住 HTML/CSS 的写法，只要描述你想要什么效果
别想着一次搞定，分步调整反而更快

案例2：程序报错了，看不懂怎么办

事情是这样的

Python 程序跑着跑着报了一堆错，看半天也不知道问题在哪。

怎么做？

第1步：在项目文件夹里启动 Claude Code

# 先进到项目目录，再启动 Claude
cd /你的项目路径
claude

第2步：把报错信息直接贴给 Claude

运行 python main.py 时报错了，错误信息如下：

Traceback (most recent call last):
  File "main.py", line 42, in <module>
    result = calculate_average(scores)
  File "main.py", line 28, in calculate_average
    return sum(numbers) / len(numbers)
ZeroDivisionError: division by zero

第3步：Claude 帮你分析

Claude 会告诉你问题出在哪：

问题在 main.py 第28行：当 scores 是空列表时，len(numbers) 为 0，
导致除以零报错。

修复方案：在除法前检查列表是否为空。

第4步：让 Claude 帮你修

帮我修复这个问题

Claude 会直接改好代码，加上空列表的检查。

第5步：再跑一次确认

再跑一次看看

这个案例涉及哪些能力

能力	对应前面聊过的
贴报错信息描述问题	第3章
读取和分析代码	第3章
编辑文件修复问题	第3章
跑命令验证	第4章

我觉得最大的收获

遇到报错就把完整的错误信息贴给 Claude，比自己瞎搜快多了
Claude 能精准定位到哪一行出了什么问题
修完之后让它再跑一遍，确认真的好了

还有别的用法

# 不只是报错，结果不对也能问
这个函数的输出不对，当输入是 [1, 2, 3] 时应该返回 6，
但实际返回了 0。帮我看看哪里有问题。

# 看不懂的错误也能问
不理解这个错误是什么意思，帮我解释一下：
TypeError: cannot unpack non-iterable NoneType object

案例3：让 Claude 帮忙写测试

事情是这样的

有个工具模块写好了，但从来没写过测试，想让 Claude 帮忙补上。

怎么做？

第1步：启动 Claude Code

# 进入项目目录，启动 Claude
cd /你的项目路径
claude

第2步：告诉 Claude 你要什么

帮我给 utils.py 这个文件写单元测试。要求：
1. 使用 pytest 框架
2. 每个公共函数都要测试
3. 包含正常输入、边界情况、异常输入的测试
4. 测试文件放在 tests/ 目录下

第3步：Claude 自己读代码然后写测试

Claude 会先读一遍 utils.py，搞清楚每个函数是干什么的，然后自动生成测试文件。

第4步：跑一下测试

运行测试看看通过率

第5步：有没通过的？让 Claude 修

有两个测试失败了，帮我修复

Claude 会分析为啥失败，然后帮你修好。

这个案例涉及哪些能力

能力	对应前面聊过的
读取源代码	第3章
创建测试文件	第3章
跑测试命令	第4章
分析失败原因并修复	第3章

我觉得最大的收获

明确告诉 Claude 用什么测试框架，它会按你的要求来
说清楚要覆盖哪些场景，它写得更全面
让 Claude 自己跑测试并处理结果，省了很多事
不过测试代码也可能有问题，还是要自己验证一下

提示

让 Claude 写测试的时候，说清楚"边界情况"很重要。比如：空列表、null 值、超长字符串这些，不然它可能只写正常场景的测试。

案例4：让 Claude 帮忙检查代码质量

事情是这样的

写完了一段新功能，想让 Claude 帮忙看看代码有没有问题，再帮忙提交。

怎么做？

第1步：在项目文件夹里启动 Claude Code

cd /你的项目路径
claude

第2步：让 Claude 帮你检查

帮我审查一下最近修改的代码，关注以下几点：
1. 是否有安全漏洞
2. 代码逻辑是否正确
3. 是否有性能问题
4. 命名是否规范

第3步：有问题就让它修

上面提到的第2个问题，帮我修复一下

第4步：帮写提交信息

帮我把改动提交，生成一个清晰的 commit message

Claude 会查看所有改动，理解你改了什么，然后生成一个合适的提交信息。

第5步：如果需要创建 PR

帮我创建一个 Pull Request

Claude 会用 gh 命令创建 GitHub PR，连标题和描述都帮你写好。

这个案例涉及哪些能力

能力	对应前面聊过的
读取和分析代码	第3章
编辑文件修复问题	第3章
执行 Git 命令	第4章
非交互模式也能用	第4章

一行命令搞定代码审查

# 审查暂存区的改动，-p 是非交互模式，--allowedTools 限制它只能用 git diff
claude -p "审查暂存区的代码改动，找出潜在问题" \
  --allowedTools "Bash(git diff*)"

案例5：让 Claude 帮你整理老旧项目

事情是这样的

接手了一个老项目，代码写得乱七八糟，想整理但不知道从哪下手。

怎么做？

第1步：让 Claude 先摸摸底

# 进入那个老项目目录
cd /你的老项目路径
claude

先帮我分析一下这个项目的结构和代码质量。告诉我：
1. 项目大概有多少文件、多少行代码
2. 代码结构是否合理
3. 最需要整理的部分是什么
4. 有哪些明显的问题（重复代码、过长函数、嵌套太深等）

第2步：制定整理计划

按照分析的结果，给一个整理计划。注意：
1. 每次只整理一个模块
2. 每次整理完都要确保功能不变
3. 先从最简单的开始

第3步：一步步来

Claude 给出计划后，一个模块一个模块推进：

从第一个模块开始整理

整理完了：

跑一下测试确认功能没变

没问题就继续：

继续整理第二个模块

第4步：看看总共改了啥

帮我总结一下这次整理做了哪些改动，列出要点

这个案例涉及哪些能力

能力	对应前面聊过的
分析项目结构	第3章、第5章
制定计划	第4章（Plan 模式）
一步步执行和验证	第3章
CLAUDE.md 记录决策	第5章

整理老项目的几个原则

小步前进 —— 每次改一点，改完验证
有测试才放心 —— 先确认有测试覆盖，再动手改
先分析再动手 —— 让 Claude 给方案，你看完觉得行再让它执行
随时问为什么 —— 不理解它为什么这么改，直接问

提示

整理老项目之前，强烈建议先让 Claude 師忙生成一份 CLAUDE.md，把项目的架构、约定、注意事项都记下来。这样后面不管是继续整理还是日常维护，Claude 都能更"懂"这个项目。

小结

跟 Claude 配合的好习惯

1. 说清楚你要什么（描述需求）
2. 让 Claude 先给方案（确认没问题再让它干）
3. 确认了再执行
4. 做完之后验证一下（跑测试、看效果）
5. 不满意就继续调（接着跟 Claude 聊）

怎么描述需求更有效？

不太好的说法	更好的说法
"帮我改一下代码"	"帮我把 utils.py 里的 formatDate 函数优化一下，当前输出格式不对"
"这里有问题"	"main.py 第42行报了 ZeroDivisionError，帮我修复"
"写个测试"	"用 pytest 给 calculator.py 的所有公共函数写单元测试，覆盖正常输入和边界情况"
"优化一下"	"这个函数在处理超过1000条数据时很慢，帮我优化性能"

提示

一句话总结：越具体越好。 告诉 Claude 文件在哪、问题是什么、你期望的结果是什么。

下一章来聊聊一些进阶玩法和我踩过的坑，帮你少走弯路：第12章一些进阶玩法和踩坑经验

第11章 实战案例

第11章实战案例