18 · 入门实战：30 分钟单会话

📚 系列导航：前面 17 篇把各个功能点讲透了。这一篇把它们串起来——30 分钟，用 Claude Code 从零完成一个最小项目。

---

01 目标与准备

项目：一个命令行任务清单工具（todo-cli），数据存本地 JSON 文件。

前置条件：Claude Code 已装好、已登录。

准备：

mkdir todo-cli && cd todo-cli && git init

---

02 第一步：立项（5 分钟）

claude

/init

预期：Claude 扫描空项目，生成 CLAUDE.md 草稿。

接着手动补一条规矩：

在 CLAUDE.md 里加一条：每加一个功能都要配 unittest 测试，改完跑 python3 -m unittest 验证

---

03 第二步：搭骨架（10 分钟）

在 todo.py 里实现一个 Todo 类，用 JSON 文件做持久化。
要求：
1. 数据存到项目根目录的 todos.json
2. 支持 add_task(text) 和 list_tasks() 两个方法
3. 任务结构：{"id": int, "text": string, "done": bool}
4. 实现后跑测试验证

预期：Claude 写 Todo 类 + 测试文件，跑测试通过。

---

04 第三步：加功能（10 分钟）

给 todo.py 加上 done 命令：mark_done(task_id) 把对应任务标记为已完成。
并补上对应的测试，跑一遍确认通过。

TIP

每完成一个功能就让它跑测试验证，不给验收标准它就「看着对」就收工。

---

05 第四步：收尾（5 分钟）

帮我把改动提交，commit message 用中文，说清加了什么功能

看一眼现在的项目结构，确认 todos.json 的读写逻辑都走同一个文件

---

06 关键体验

你不是在写代码，是在「验收」Claude 写的代码。你的工作是：

1. 说清楚要什么
2. 看 diff 确认它理解对了
3. 让它跑测试自证通过了
4. 提交

---

07 小结

阶段	时间	做了什么
立项	5 分钟	/init + 补 CLAUDE.md 规矩
搭骨架	10 分钟	写 Todo 类 + JSON 持久化 + 测试
加功能	10 分钟	加 mark_done + 补测试
收尾	5 分钟	提交 + 检查结构

NOTE

下一篇：19 Capstone 综合实战：跨会话、接 MCP、派 Subagent——从零到交付的完整工程流。