Claude Code实战:从Vibe Coding入门到智能体工程电子书

内容简介

前言

第1篇 入门：让Claude Code跑起来

第1章 初识Claude Code：5分钟跑通对话式编程

1.1 Claude Code的安装与登录

1.2 初次使用的三个常见误区

1.3 第一个真实任务

1.4 对话即开发环境

1.5 基本命令与快捷键

1.6 第一个调试场景

1.7 Claude Code帮不上忙的情况

小结

第2章 需求表达的艺术：怎样让Claude Code准确理解意图

2.1 为什么模糊的需求会产生错误的结果

2.2 需求落地的四要素

2.3 可直接复用的高质量提示词模板

2.4 经典对照案例

2.5 渐进式需求：从模糊到精确的对话策略

2.6 提需求的常见错误模式

2.7 让Claude Code帮忙厘清需求

小结

第3章 Superpowers：为Claude Code装上专家级工作流

3.1 为什么需要可复用的工作流

3.2 触发方式

3.3 五个核心Superpowers技能

3.4 技能链：规划→实现→验收

3.5 /loop和/schedule：后台持续工作

小结

第4章 掌控对话：理解执行流与精准导航

4.1 Claude Code的执行全链路

4.2 Plan Mode：先看计划，再开始执行

4.3 四个关键控制点

4.4 何时不该介入

4.5 精准导航：@引用与探索策略

4.6 项目地图与大型项目分层导航策略

小结

第5章 走出官方的限制：用CC Switch接入国产模型

5.1 Claude Code的可扩展架构

5.2 认识与安装CC Switch

5.3 添加提供商与日常切换

5.4 国产模型与官方模型的混合使用策略

5.5 模型评估与多项目配置

5.6 多模型协作的一天

5.7 不止于模型切换

小结

第2篇 熟练：从能用到用得稳

第6章 上下文管理：决定能走多远的关键技能

6.1 上下文：Claude Code的工作记忆

6.2 识别污染：四个症状

6.3 三个核心命令

6.4 主动预防：在污染发生前进行控制

6.5 一次完整的工作对话

小结

第7章 CLAUDE.md：为项目建立长期记忆

7.1 CLAUDE.md的三层体系

7.2 项目CLAUDE.md：写什么，不写什么

7.3 两个真实项目的CLAUDE.md拆解

7.4 CLAUDE.md的实际效果：有和没有的对比

7.5 如何为新项目创建第一个CLAUDE.md

7.6 团队协作中的CLAUDE.md

7.7 CLAUDE.md的三个常见误区

7.8 维护CLAUDE.md：保持地图和现实同步

小结

第8章 调试与纠偏：当Claude Code走错路时怎么办

8.1 Claude Code常见的三类错误

8.2 实时发现错误：在对话里设置检查点

8.3 跳出修改循环：最难处理的情况

8.4 undo时光机：当改动已经走偏太多时

8.5 ccundo：精细化撤销Claude Code的改动

8.6 按错误类型“对症处理”

8.7 一个完整的纠偏案例

8.8 规避问题的前期设计

8.9 和Claude Code建立“纠错共识”

小结

第9章 与Git协作：把版本控制变成开发安全网

9.1 为什么AI辅助开发需要更严格的Git工作纪律

9.2 标准开工动作：建立安全基线

9.3 Git的提交节奏

9.4 自动提交信息

9.5 用Claude Code生成PR描述

9.6 创建PR请求前的自检清单

9.7 中途换需求：使用暂存（stash）

9.8 用Claude Code处理Git合并冲突

9.9 用git bisect定位问题引入时间

9.10 配合Claude Code的Git工作流总结

9.11 快速选择表

小结

第3篇 精通：从用得稳到做得好

第10章 大任务拆解：复杂需求的分解策略

10.1 先判断规模：三路决策框架

10.2 为什么不能把大任务直接交给Claude Code

10.3 纵切：按功能层次拆解

10.4 横切：按模块批量处理

10.5 原型先行：先做能跑的版本，再迭代

10.6 三种拆解方法的选型指南

10.7 一个完整的大任务拆解示例

小结

第11章 OpenSpec：规格驱动开发

11.1 为什么需要规格文档

11.2 OpenSpec的核心流程

11.3 进阶技巧：让规格文档的价值最大化

11.4 规格演进：需求发生变化了怎么办

11.5 什么时候用、什么时候不用

小结

第12章 重构：Claude Code最被低估的能力

12.1 重构的核心原则：保持行为，改变结构

12.2 上帝函数拆分

12.3 将嵌套CompletableFuture改写为现代异步模式

12.4 遗留Java代码现代化：从Java 7/8到Java 17

12.5 重构任务的工作流建议

12.6 综合重构场景：多问题并存时怎么处理

小结

第13章 测试：用Claude Code写出真正有效的测试

13.1 测试覆盖的三大陷阱

13.2 如何让Claude Code写出有价值的测试代码

13.3 老项目补救式加测

13.4 TDD工作流：和Claude Code一起做测试驱动开发

13.5 测试异步代码

13.6 测试质量的自我检查

13.7 测试工程化：让测试持续可用

小结

第14章 文档与注释：边开发边产出

14.1 让人愿意标星的README文档

14.2 代码注释：什么时候写，写什么

14.3 从代码中提炼架构图

14.4 生成CHANGELOG和Release Notes

14.5 将文档更新纳入开发流程

14.6 快速选择表

小结

第4篇 扩展：从单点能力到系统化工程

第15章 自动化：用自定义命令与Hook把重复变成机制

15.1 什么值得自动化

15.2 自定义命令：手动触发的自动化

15.3 实用命令模板

15.4 Hook：事件驱动的自动化

15.5 三个核心Hook场景

15.6 完整的自动化链路

小结

第16章 MCP：让Claude Code连上整个工作世界

16.1 MCP是什么

16.2 配置MCP服务

16.3 GitHub联动实战

16.4 数据库联动实战

16.5 Figma联动：设计稿转代码

16.6 Sentry联动：把错误日志变成可操作的信息

16.7 Playwright联动：让Claude Code操作浏览器

16.8 中文生态：飞书与语雀

16.9 Context7：解决训练数据过时问题

16.10 多MCP服务联动：一条完整的工程链路

16.11 自建MCP服务：接入内部系统

16.12 MCP生态：更多现成服务与查找渠道

小结

第17章 Skill与子Agent：搭建一支AI工程小队

17.1 Skill：把专家流程沉淀为可复用技能

17.2 实战样本：gstack——用Skill搭起一支AI工程小队

17.3 子Agent存在的理由

17.4 Task工具与git worktree：机制层

17.5 给无上下文的Agent写任务书

17.6 经典模式一：并行多维代码审查

17.7 经典模式二：规格驱动的测试与实现并行

17.8 经典模式三：万行代码重构的分治

17.9 Agent之间的协调：用文件作中间层

17.10 选择框架

小结

第5篇 实战：端到端项目交付

第18章 实战一：开发一个Python CLI工具

18.1 项目背景：从一句话开始

18.2 用提示词生成产品方案

18.3 用提示词生成技术方案

18.4 用CLAUDE.md建立项目约束

18.5 从产品方案生成CLI接口

18.6 实现五节点流水线

18.7 主题系统与Pillow渲染

18.8 扩展成MCP Server

18.9 基于产品方案生成测试用例

18.10 自动化测试与人工验收

18.11 bug修复：描述现象，协作排查

18.12 打包发布到PyPI

小结

第19章 实战二：开发一个iOS App

19.1 项目背景：把视频变成Live Photo

19.2 方案决策

19.3 基于产品方案生成UI原型

19.4 Claude Code与Xcode的协作模式

19.5 核心视图层：从选视频到编辑

19.6 视频处理引擎：AVFoundation+Actor

19.7 Live Photo合成：Apple Metadata写入

19.8 测试与修正：从测试用例到bug修复

19.9 将Fastlane发布到App Store

小结

第20章 实战三：开发一个Web应用

20.1 项目背景：为什么要自己做

20.2 方案决策

20.3 基于产品方案生成UI规范

20.4 三层架构实现

20.5 IOPaint：为什么不能删

20.6 认证系统：JWT双轨验证

20.7 前端蒙版绘制：Canvas API

20.8 测试与修正：从测试用例到bug修复

20.9 Render部署+自定义域名+CI/CD

小结

第21章 实战四：发布一个开源项目

21.1 项目背景：AI社交媒体自动化的痛点

21.2 方案决策

21.3 基于产品方案展示UI

21.4 pnpm Monorepo结构

21.5 三进程架构实现

21.6 测试与修正：从测试用例到bug修复

21.7 开源必备文件

21.8 GitHub Actions CI/CD

21.9 GitHub Release发布

小结

第22章 实战五：用Claude Code处理非编程的日常工作

22.1 高确定性任务：交给Claude独立完成

22.2 中等确定性任务：人划定边界，Claude执行

22.3 不适合AI的任务：判断权不能外包

22.4 把重复任务变成自动化脚本

22.5 非编程任务的通用方法

22.6 AI辅助开发者的一天

小结

附录A 命令速查表

A.1 对话控制

A.2 文件引用

A.3 工作模式与CLI参数

A.4 Superpowers速查

A.5 ccundo命令

A.6 Git协作关键节奏

附录B MCP与插件速查表

B.1 高频MCP server

B.2 插件

B.3 IDE插件与模型管理

B.4 中文生态MCP

B.5 Skill社区资源

B.6 实战项目索引