Vibe Coding 学习手册：从0基础到vibecoding大师
阅读说明
本书面向希望系统掌握 Vibe Coding 理念并熟练运用主流 AI 编程助手的读者。Vibe Coding 不是一种特定的技术，而是一种以直觉驱动、实时反馈、深度沉浸为核心的编程工作方式——让开发者进入“心流”状态，借助 AI 伙伴快速验证想法、迭代代码，同时保持对全局架构的掌控。
在 2026 年的开发者生态中，有三款工具共同定义了 Vibe Coding 的实践范式：
•
Codex（OpenAI 出品）——轻量、快速、深度集成于本地文件系统，擅长执行明确指令与自动化脚本，是“执行型”代表；
•
Claude Code（Anthropic 出品）——以强大的推理能力和长上下文闻名，擅长复杂问题分解、架构设计与计划生成，是“思考型”代表；
•
WorkBuddy（新兴的协作型 Agent）——主打多智能体编排与跨工具协同，能调度 Codex 和 Claude 完成复合任务，是“组织型”代表。
三者并非替代关系，而是互补关系。本书将围绕这三驾马车，从单工具入门到多工具协同，带您走出一条完整的 Vibe Coding 工程化进阶之路。
全书采用案例驱动，每章包含学习目标、操作案例、练习、检查清单和常见坑。您可以顺序阅读，也可按需跳读。初学者建议从第一部分到第二部分顺序学习，掌握基础后再挑战第三部分及之后的工程化与协作主题。
总目录
第一部分：认知篇 —— Vibe Coding 与三大工具
第 1 章 Vibe Coding 是什么
1.1 从“写代码”到“编代码”：心流编程的定义
1.2 Vibe Coding 的核心原则：直觉、反馈、节奏
1.3 为什么 AI 助手是 Vibe Coding 的催化剂
1.4 三种角色：执行者（Codex）、思考者（Claude）、组织者（WorkBuddy）
第 2 章 三驾马车全景对比
2.1 Codex vs Claude Code vs WorkBuddy：定位与能力矩阵
2.2 各自擅长场景与典型任务映射
2.3 如何根据任务选择工具或组合
2.4 生态兼容性：MCP、Skills、插件体系
第 3 章 环境准备与安装
3.1 Codex 安装（npm / Homebrew / 二进制）与认证
3.2 Claude Code 安装（npm / 桌面应用）与 API 配置
3.3 WorkBuddy 安装（Docker / 二进制）与初始配置
3.4 三工具共存的目录与 shell 环境设置
3.5 首次启动与健康检查
第二部分：基础篇 —— 核心操作与单工具实战
第 4 章 文件系统与工具能力
4.1 Codex 的文件读写、编辑与命令执行
4.2 Claude Code 的文件操作与沙盒策略
4.3 WorkBuddy 的工具注册与调用机制
4.4 权限模型对比（read‑only / workspace / full‑access）
第 5 章 交互模式与快捷键
5.1 Codex 的 TUI 与单次命令模式
5.2 Claude Code 的终端交互与 / 命令
5.3 WorkBuddy 的对话式编排界面
5.4 通用快捷键速查（Ctrl+C、Ctrl+L、Ctrl+G 等）
第 6 章 代码理解与项目地图
6.1 让 Codex 快速解读陌生仓库
6.2 用 Claude Code 生成架构概览与依赖图
6.3 WorkBuddy 聚合多源信息生成项目知识库
6.4 代码搜索、符号定位与调用链分析
第 7 章 Bug 定位与修复
7.1 将错误日志交给 AI 自主调试
7.2 Codex 的快速修复流程
7.3 Claude Code 的深度根因分析
7.4 WorkBuddy 并行运行多个调试策略并汇总
7.5 修复验证与回归测试
第 8 章 重构、测试与文档
8.1 用 Codex 批量重构遗留代码
8.2 Claude Code 设计重构计划与测试策略
8.3 WorkBuddy 编排重构、测试、文档生成流水线
8.4 代码覆盖率分析与提升建议
8.5 自动生成并维护项目文档
第三部分：进阶篇 —— 工程化实践与质量管控
第 9 章 项目规则文件 —— AGENTS.md / CLAUDE.md
9.1 规则文件的用途与格式
9.2 编写编码规范、测试命令、审查规则
9.3 让 Codex 和 Claude 自动遵循项目约定
9.4 WorkBuddy 跨项目规则继承与冲突处理
第 10 章 提示词工程基本功
10.1 高质量 Prompt 四要素：Goal、Context、Constraints、Done when
10.2 使用 @ 符号精准引用文件或符号
10.3 分阶段提示：计划→设计→实现→审查
10.4 针对不同工具的提示词风格调整
10.5 常见误区与避坑指南
第 11 章 计划模式与探索模式
11.1 计划模式（Plan Mode）的工作原理
11.2 Claude Code 的计划生成与审查要点
11.3 Codex 的探索模式（自由探索代码库）
11.4 WorkBuddy 在计划与执行之间的仲裁机制
11.5 如何选择何时使用哪种模式
第 12 章 上下文管理与长会话
12.1 各工具的上下文窗口与记忆机制
12.2 大型项目的上下文压缩与分段策略
12.3 线程 / 会话系统：跨任务保留上下文
12.4 置顶核心文件与长期记忆的使用场景
第 13 章 Token 节省与成本优化
13.1 各工具 Token 消耗对比（Codex ≈ 1/3 Claude）
13.2 启动大型仓库时的预热策略
13.3 模型选择（Haiku / Sonnet / Opus）与成本权衡
13.4 WorkBuddy 的任务路由优化（将简单任务分配给低成本模型）
第四部分：高级篇 —— 自动化、自定义与多 Agent 协作
第 14 章 Skills 基础与内置技能
14.1 Skill 的概念：Markdown 编写的“指令包”
14.2 全局技能库 vs 项目级技能
14.3 Codex 与 Claude 对 Skill 的发现机制
14.4 WorkBuddy 的技能编排与动态加载
14.5 常用内置 Skill 演示（测试生成、代码审查等）
第 15 章 自定义 Skill 开发
15.1 识别高频操作，抽象通用模板
15.2 编写 SKILL.md 的结构与最佳实践
15.3 添加参数校验与验证逻辑
15.4 实战：从零创建“React 组件迁移”Skill
15.5 在 WorkBuddy 中组合多个 Skill 形成工作流
第 16 章 MCP 集成与工具链扩展
16.1 MCP（Model Context Protocol）概述
16.2 将 Codex 和 Claude 注册为 MCP 服务器
16.3 通过 MCP 连接数据库、API 文档、图数据库等
16.4 上下文引擎与语义搜索增强
16.5 WorkBuddy 作为 MCP 客户端统一调度
第 17 章 多 Agent 协作
17.1 各工具对 SubAgent 的原生支持现状
17.2 通过 MCP 实现子代理并行执行
17.3 编排器模式：WorkBuddy 作为主控调度 Codex 和 Claude
17.4 实战：并行处理前端、后端、测试三路任务并汇总
17.5 结果冲突解决与人工兜底策略
第 18 章 从一次性问答到可复用工作流
18.1 识别日常开发中可自动化的工作流
18.2 将经验沉淀为 Skill、脚本或 WorkBuddy 模板
18.3 配置文件的默认行为管理（.codexrc, .clauderc, .workbuddy）
18.4 完整的工程化工作流案例：从需求到 PR 的全自动流水线
第五部分：专题篇 —— 实战场景与团队生态
第 19 章 桌面应用与 IDE 插件
19.1 Codex 桌面应用（任务工作台模式）
19.2 Claude Code 桌面版与 VSCode 插件
19.3 WorkBuddy 的 Web 仪表板与 Slack 集成
19.4 三种入口的选择策略（终端 / IDE / 独立应用）
19.5 图像生成与设计辅助（gpt‑image‑1.5 等）
第 20 章 CI/CD 与自动化集成
20.1 非交互模式：codex exec / claude exec / workbuddy run
20.2 在 GitHub Actions、GitLab CI 中嵌入 AI 任务
20.3 API Key 认证与环境变量管理
20.4 自动化最佳实践：幂等性、超时控制、日志持久化
20.5 避坑指南：避免无限循环与过度修改
第 21 章 团队协作与知识沉淀
21.1 共享 AGENTS.md 与团队编码规范
21.2 建立团队级 Skills 仓库与版本管理
21.3 利用 Codex + Claude 进行代码审查工作流
21.4 自动生成拉取请求描述与变更摘要
21.5 WorkBuddy 作为团队知识问答机器人
第 22 章 常见问题与排障指南
22.1 安装与认证失败排查
22.2 Windows / WSL2 踩坑汇总
22.3 权限与沙盒问题（文件无法写入、命令被拒绝）
22.4 性能优化与响应慢的应对（网络、缓存、并行度）
22.5 多工具协同时的冲突诊断
快速参考：本书各章既可顺序学习，也可按需跳读。建议初学者从第 1 章到第 8 章顺序学习，掌握单工具基础后再进入第三部分的工程化实践。第四、第五部分适合有一定经验的开发者，特别是团队负责人或技术架构师。每章末尾的“检查清单”和“常见坑”可以帮助您快速验证学习成果、规避典型错误。
第一章：Vibe Coding 是什么（完整示例）
本章学习目标
•
理解 Vibe Coding 的概念及其与 AI 的关系
•
区分“执行型”、“思考型”、“组织型”三种 AI 角色
•
建立适合自己的 Vibe Coding 工作姿态
1.1 从“写代码”到“编代码”：心流编程的定义
传统编程是线性的：需求分析 → 设计 → 编码 → 测试 → 修复。开发者大部分时间花在语法细节、API 调用、异常处理等“低层次”事务上，大脑难以进入沉浸的创造状态。
Vibe Coding 由开发者圈层在 2025 年末提出，强调用 “意图表述” 替代 “指令编写”。您不再逐行敲击实现细节，而是用自然语言描述目标、约束和验收标准，由 AI 助手生成候选方案，您则扮演导演和评审——把控方向，审查结果，快速迭代。这种模式让大脑始终处于“设计”和“决策”的高带宽状态，更容易进入心流。
1.2 Vibe Coding 的核心原则：直觉、反馈、节奏
•
直觉驱动：遇到问题，先凭经验说出“我觉得应该这么做”，而不是立即查文档。AI 会快速给出实现，验证您的直觉。
•
即时反馈：AI 在数秒内生成代码、运行测试、展示结果，缩短认知循环（＜30 秒），保持心流不中断。
•
可变节奏：您控制速度——在模糊需求时放慢（让 Claude 做计划），在明确任务时加速（让 Codex 批量执行），在复杂协作时切换至 WorkBuddy 协调多方。
1.3 为什么 AI 助手是 Vibe Coding 的催化剂
没有 AI 时，心流常被“卡点”打断——忘记 API 参数、找不到 bug 原因、不确定重构影响范围。AI 助手如同一个即时可用的副驾驶，帮您瞬间跨越这些障碍。更重要的是，AI 不会疲劳，且能记住整个项目上下文，这让您可以将注意力始终放在最核心的创意和架构决策上。
1.4 三种角色：执行者（Codex）、思考者（Claude）、组织者（WorkBuddy）
在 Vibe Coding 实践中，三款工具各司其职：
| | | |
| | | |
| | | |
| | | |
三者组合，形成“思考 → 分解 → 执行 → 验证”的完整闭环，这正是 Vibe Coding 的高阶形态。
练习（第一章）
回忆您最近一次被“卡住”的场景，思考如果用 Codex 或 Claude 能如何快速解决。
列出一个您日常开发中耗时最多的活动，判断它更适合“执行型”还是“思考型”工具。
尝试用一句话（Goal）描述您当前项目最想改进的一个点，并尝试分发给 Claude 做计划。
检查清单（第一章）
我能区分 Vibe Coding 与普通编程的思维方式
我了解 Codex、Claude、WorkBuddy 各自的定位
我能根据任务类型初步选择合适的工具
我已建立“先表述意图，再审查结果”的意识
常见坑（第一章）
•
坑 1：把 AI 当成“自动完成器”，不做审查直接采用代码 → 导致隐含 bug。对策：始终以“审查者”姿态阅读 AI 输出。
•
坑 2：同时使用三个工具但混乱无序 → 上下文丢失、重复劳动。对策：先用 WorkBuddy 做整体任务分解，再指派给具体工具。
•
坑 3：过度依赖 AI 而忽略自己的架构判断 → 代码风格杂乱。对策：在项目规则文件中明确编码规范（见第 9 章）。
其余章节按相同体例编写，每章均包含学习目标、核心内容、操作案例、练习、检查清单和常见坑。 本书持续更新，期待您在实践中创造属于自己的 Vibe Coding 节奏！