夜雨聆风
系列：《AI Agent 编码实战》系列，共 10 篇 + 配套实战视频
目标：用一个真实项目的完整过程，展示如何以 Claude Code 为主力工具，把软件开发的交付终点从"上线"推进到"变成 Agent"——不是教怎么入门，是教怎么真正跑起来。
适合：一是有技术背景但离代码有段距离的人——技术管理者、架构师、产品经理，想重新捡起来但不想从零学；二是已经在用 AI 写代码但停留在"试过"阶段的开发者，想把它真正用进正式项目；三是想做 Agent 交付而不只是做软件交付的人，不管是独立开发者还是小团队。
先说几个最近发生的事。
扎克伯格在 LlamaCon 上说，未来一年，Meta 超过一半的代码将由 AI 来写。《金融时报》报道，他本人每周花 5-10 小时做 Vibe Coding。Meta 内部，产品经理们已经在用 AI 在几小时内做出原型，直接拿给他和领导层看。
英伟达把 OpenAI 的 Codex 部署给了全公司超过 1 万名员工。黄仁勋说了一句话：「Human is the new programming language.」
Anthropic 的 CEO 在 Code with Claude 开发者大会上被问到，一个人独立做出来的独角兽公司什么时候会出现，他直接回答：「2026 年。」事后接受媒体追问，他把这个概率修正为 70-80%。
Karpathy 在 2025 年 2 月 2 日发了一条推特，说了「Vibe Coding」这个词。那条推特被看了超过 450 万次，然后这个词引发了一场产业风口——Vibe Coding 赛道中，仅 Lovable 一家公司的估值就已达到 66 亿美元。
现在，在活跃使用 AI 编程工具的开发者中，AI 已经在写 46% 的代码（GitHub 数据）；从全行业看，这个比例约为 41%。Claude Code 公开发布后三个月内，使用量增长了 10 倍。
我做了十几年技术管理，有几年没怎么写代码了。
不是不会写，是没必要写——团队有人做，我的时间应该花在更重要的事上。这是大多数走到技术管理位置的人的状态：离代码越来越远，离会议越来越近。
去年开始用 Claude Code，有一天我突然意识到，有什么事情变了。
不是「写得更快」这种感觉。是另一种感觉：
以前需要一个小组才能推动的事，现在一个人可以推。
不是因为我写得更快，是因为我指挥 Agent 的效率，比指挥一个不了解业务的工程师高得多。
角色没有降级。是杠杆变了。
所以我重新开始——重新做架构师真正该做的事：定方向、划边界、做决策，让 Agent 执行，审每一行代码，对所有结果负责。
Vibe Coding 现在不需要解释了。海淀的小学生都开始了，63% 的用户根本不是开发者出身。你肯定也试过。
但「试过」和「真的用到正式项目里」之间，还差着一段距离。这个系列不讲怎么开始，讲怎么用 Claude Code 作为主力，把它跑到正式项目里——从写代码到交付 Agent 的完整路径。Codex 在需要的地方出现，作为补充。
三周时间，我用 Claude Code 重构开发一套无人机管理系统。
三周后，这套系统里多了一个 Agent，它能根据自然语言——「帮我安排明天早上 6 点的晨检任务」——自动查可用无人机、配航线、建任务、下发执行、生成报告。
262 次提交。8 个模块。32 个工具定义。5 个 Skill。
我没有「更快地完成软件开发」。我做的事情比这更根本：
软件交付的终点变了。
这个系列，记录这件事的完整来龙去脉。
这个系列包含什么？
10 篇图文 + 每篇配套实战视频。
图文讲思路和决策，视频演示操作和踩坑。Claude Code 配置、hooks 调试、worktree 操作、Agent 工具生成……这些用文字描述会绕，跟着视频过一遍就清楚了。
第 1 篇｜你用 AI 写代码，效率为什么还是没提升？
不是 prompt 写得不好，也不是模型不够强。
根本原因只有一个：Agent 每次启动都是新人——不知道你的系统有哪些模块，不知道上周踩了什么坑，不知道这个项目的接口怎么认证。能力很强，但对你的项目一无所知。
Claude Code 的 hooks、worktree、知识注入机制，就是专门解决这个问题的。这篇先把问题讲清楚。
配套视频：演示同一个任务在「Agent 有知识」和「没知识」两种状态下的差异。
第 2 篇｜Vibe Coding 不是把任务丢给 AI——我的 5% 代码做了什么
「你的项目 95% 是 AI 写的？那你做了什么？」
架构怎么拆、边界怎么划、Agent 跑偏了怎么拉回来、bug 先自己查清楚再交给 Claude Code 还是直接扔过去——这些是人的活，而且比写代码重要得多。Vibe Coding 不是偷懒，是角色切换：从执行者变成决策者。
配套视频：还原一次真实的协作过程，我说了什么，Claude Code 干了什么，我在哪里介入。
第 3 篇｜Claude Code 深度指南：hooks、worktree、agents 三件套
Claude Code 大多数人只用到了 10%。
真正让它好用的三个机制：hooks（自动触发，不靠 prompt 提醒）、worktree（每个模块独立 session，互不干扰）、agents（专项 agent 比通用 agent 靠谱得多）。一次讲清楚，包括一个让 hooks 悄悄失效半个月的配置错误——我是怎么发现的，怎么修的。
这是整个系列最重要的一篇，后续所有实战都建立在这三件套上。
配套视频：从零开始配置 hooks、创建第一个 worktree、设置专项 agent 的完整操作。
第 4 篇｜Codex 200 刀消耗了一半：它擅长什么，不擅长什么
Claude Code 是主力，但有些任务 Codex 更合适。
我用 Codex 做了另一个项目：Java 终端 Agent CLI，200 刀消耗了一半。有些问题必须自己先搞清楚再交给 Codex——它缺一块「在眼前直接调试」的能力，排查过程只能靠人。深挖了一个底层库的源码之后才搞定。
这篇写清楚 Codex 的边界：在哪里它比 Claude Code 顺手，在哪里别指望它。
配套视频：Codex 实际操作演示，和 Claude Code 使用体验的直接对比。
第 5 篇｜Claude Code 主力 + Codex 辅助：我的实际工作流
两个工具不是竞争关系，是分工关系。
Claude Code 做有上下文积累、需要持续迭代的模块开发。Codex 做独立探索、快速验证、一次性任务。切换的判断标准是什么，token 成本怎么控制，这篇讲真实的工作流。
配套视频：一个完整任务在Claude Code + Codex两个工具之间的切换过程。
第 6 篇｜让 Claude Code 越用越强：我设计这套知识框架的完整思路
每开始一个新模块，都要重新告诉 Claude Code 项目规范、接口约定、上次踩的坑——这不对。
MAC 框架的设计：三层知识（通用 + 项目 + 模块）、session 启动自动读档、踩坑经验变成下一个模块的起点。知识越积越厚，Claude Code 越用越顺，新模块开始时不再从零开始。
配套视频：session-start 自动注入效果演示，有无知识库的启动差异对比。
第 7 篇｜MAC 框架开源：8 次推倒重来，它现在长这样
这个框架经历了 8 次迭代——从臃肿的多平台系统，到删掉 14 个文件反而好用了，到 Claude Code hooks 静默失效半个月，到在真实项目里发现一个核心设计根本没落地。
每次「为什么推倒」都写进去了。走弯路的部分比最终结果更值得看。框架开源，可以直接用。
配套视频：MAC 安装配置 + 在新项目里用 Claude Code 跑通第一个 worktree。
第 8 篇｜3 周 262 次提交：用 Claude Code 开发无人机系统的完整过程
8 个模块，并行推进，全程 Claude Code 主力驱动。
模块怎么划分、关键决策在哪里、真实遇到了哪些麻烦，以及每个模块的 git 数据。不是成功学，是过程，包括卡住的地方和怎么想清楚的。
配套视频：多 worktree 并行管理的实际操作，Claude Code 在各模块间的切换方式。
第 9 篇｜32 个工具定义是怎么从系统里生成出来的
系统写完之后多做了一件事：把系统接口转成 Agent 可以直接调用的工具。
Claude Code 在写代码的过程中已经生成了完整的 API 文档。32 个工具定义从这份文档转换而来，5 个 Skill 把工具组合成可以对话触发的能力。接口返回 32 条真实数据验证跑通。
为什么用 Claude Code 写的系统在这一步有天然优势——这篇讲清楚。
配套视频：/export-mcp 实际运行，从 API 文档到工具定义的全过程。
第 10 篇｜软件交付的终点不是上线，是变成 Agent
客户以后买的不是管理系统，而是一个会帮他们干活的 Agent。系统是 Claude Code 写的 → Claude Code 最懂这个系统 → 基于这套系统的 Agent 最能帮客户用好它。这个闭环，传统开发方式做不到。
对开发者意味着什么，对软件公司意味着什么，想走这条路的人起点在哪里。
配套视频：完整演示无人机 Agent 的对话交互全过程——从一句自然语言指令，到无人机任务自动下发、执行、报告生成。
关于素材的真实性
所有数据来自真实项目的 git 记录：
262 次提交，三周，全程 Claude Code 驱动 8 个模块并行：数据标注、智能识别、运维中心、障碍物规避…… Agent 分支：30+ tools 定义，10+ skills创建，调用生产接口返回真实数据 MAC 框架：8 个版本迭代，最早那个版本现在看起来像反面教材
弯路写进去了，失败写进去了，推倒重来也写进去了。
最有参考价值的，从来不是成功的结论，而是在哪里卡住、怎么想清楚的过程。
系列：《AI Agent 编码实战》系列，共 10 篇 + 配套实战视频
目标：用一个真实项目的完整过程，展示如何以 Claude Code 为主力工具，把软件开发的交付终点从"上线"推进到"变成 Agent"——不是教怎么入门，是教怎么真正跑起来。
适合：一是有技术背景但离代码有段距离的人——技术管理者、架构师、产品经理，想重新捡起来但不想从零学；二是已经在用 AI 写代码但停留在"试过"阶段的开发者，想把它真正用进正式项目；三是想做 Agent 交付而不只是做软件交付的人，不管是独立开发者还是小团队。
系列：《AI Agent 编码实战》系列，共 10 篇 + 配套实战视频
目标：用一个真实项目的完整过程，展示如何以 Claude Code 为主力工具，把软件开发的交付终点从"上线"推进到"变成 Agent"——不是教怎么入门，是教怎么真正跑起来。
适合：一是有技术背景但离代码有段距离的人——技术管理者、架构师、产品经理，想重新捡起来但不想从零学；二是已经在用 AI 写代码但停留在"试过"阶段的开发者，想把它真正用进正式项目；三是想做 Agent 交付而不只是做软件交付的人，不管是独立开发者还是小团队。
先说几个最近发生的事。
扎克伯格在 LlamaCon 上说，未来一年，Meta 超过一半的代码将由 AI 来写。《金融时报》报道，他本人每周花 5-10 小时做 Vibe Coding。Meta 内部，产品经理们已经在用 AI 在几小时内做出原型，直接拿给他和领导层看。
英伟达把 OpenAI 的 Codex 部署给了全公司超过 1 万名员工。黄仁勋说了一句话：「Human is the new programming language.」
Anthropic 的 CEO 在 Code with Claude 开发者大会上被问到，一个人独立做出来的独角兽公司什么时候会出现，他直接回答：「2026 年。」事后接受媒体追问，他把这个概率修正为 70-80%。
Karpathy 在 2025 年 2 月 2 日发了一条推特，说了「Vibe Coding」这个词。那条推特被看了超过 450 万次，然后这个词引发了一场产业风口——Vibe Coding 赛道中，仅 Lovable 一家公司的估值就已达到 66 亿美元。
现在，在活跃使用 AI 编程工具的开发者中，AI 已经在写 46% 的代码（GitHub 数据）；从全行业看，这个比例约为 41%。Claude Code 公开发布后三个月内，使用量增长了 10 倍。
我做了十几年技术管理，有几年没怎么写代码了。
不是不会写，是没必要写——团队有人做，我的时间应该花在更重要的事上。这是大多数走到技术管理位置的人的状态：离代码越来越远，离会议越来越近。
去年开始用 Claude Code，有一天我突然意识到，有什么事情变了。
不是「写得更快」这种感觉。是另一种感觉：
以前需要一个小组才能推动的事，现在一个人可以推。
不是因为我写得更快，是因为我指挥 Agent 的效率，比指挥一个不了解业务的工程师高得多。
角色没有降级。是杠杆变了。
所以我重新开始——重新做架构师真正该做的事：定方向、划边界、做决策，让 Agent 执行，审每一行代码，对所有结果负责。
Vibe Coding 现在不需要解释了。海淀的小学生都开始了，63% 的用户根本不是开发者出身。你肯定也试过。
但「试过」和「真的用到正式项目里」之间，还差着一段距离。这个系列不讲怎么开始，讲怎么用 Claude Code 作为主力，把它跑到正式项目里——从写代码到交付 Agent 的完整路径。Codex 在需要的地方出现，作为补充。
三周时间，我用 Claude Code 重构开发一套无人机管理系统。
三周后，这套系统里多了一个 Agent，它能根据自然语言——「帮我安排明天早上 6 点的晨检任务」——自动查可用无人机、配航线、建任务、下发执行、生成报告。
262 次提交。8 个模块。32 个工具定义。5 个 Skill。
我没有「更快地完成软件开发」。我做的事情比这更根本：
软件交付的终点变了。
这个系列，记录这件事的完整来龙去脉。
这个系列包含什么？
10 篇图文 + 每篇配套实战视频。
图文讲思路和决策，视频演示操作和踩坑。Claude Code 配置、hooks 调试、worktree 操作、Agent 工具生成……这些用文字描述会绕，跟着视频过一遍就清楚了。
第 1 篇｜你用 AI 写代码，效率为什么还是没提升？
不是 prompt 写得不好，也不是模型不够强。
根本原因只有一个：Agent 每次启动都是新人——不知道你的系统有哪些模块，不知道上周踩了什么坑，不知道这个项目的接口怎么认证。能力很强，但对你的项目一无所知。
Claude Code 的 hooks、worktree、知识注入机制，就是专门解决这个问题的。这篇先把问题讲清楚。
配套视频：演示同一个任务在「Agent 有知识」和「没知识」两种状态下的差异。
第 2 篇｜Vibe Coding 不是把任务丢给 AI——我的 5% 代码做了什么
「你的项目 95% 是 AI 写的？那你做了什么？」
架构怎么拆、边界怎么划、Agent 跑偏了怎么拉回来、bug 先自己查清楚再交给 Claude Code 还是直接扔过去——这些是人的活，而且比写代码重要得多。Vibe Coding 不是偷懒，是角色切换：从执行者变成决策者。
配套视频：还原一次真实的协作过程，我说了什么，Claude Code 干了什么，我在哪里介入。
第 3 篇｜Claude Code 深度指南：hooks、worktree、agents 三件套
Claude Code 大多数人只用到了 10%。
真正让它好用的三个机制：hooks（自动触发，不靠 prompt 提醒）、worktree（每个模块独立 session，互不干扰）、agents（专项 agent 比通用 agent 靠谱得多）。一次讲清楚，包括一个让 hooks 悄悄失效半个月的配置错误——我是怎么发现的，怎么修的。
这是整个系列最重要的一篇，后续所有实战都建立在这三件套上。
配套视频：从零开始配置 hooks、创建第一个 worktree、设置专项 agent 的完整操作。
第 4 篇｜Codex 200 刀消耗了一半：它擅长什么，不擅长什么
Claude Code 是主力，但有些任务 Codex 更合适。
我用 Codex 做了另一个项目：Java 终端 Agent CLI，200 刀消耗了一半。有些问题必须自己先搞清楚再交给 Codex——它缺一块「在眼前直接调试」的能力，排查过程只能靠人。深挖了一个底层库的源码之后才搞定。
这篇写清楚 Codex 的边界：在哪里它比 Claude Code 顺手，在哪里别指望它。
配套视频：Codex 实际操作演示，和 Claude Code 使用体验的直接对比。
第 5 篇｜Claude Code 主力 + Codex 辅助：我的实际工作流
两个工具不是竞争关系，是分工关系。
Claude Code 做有上下文积累、需要持续迭代的模块开发。Codex 做独立探索、快速验证、一次性任务。切换的判断标准是什么，token 成本怎么控制，这篇讲真实的工作流。
配套视频：一个完整任务在Claude Code + Codex两个工具之间的切换过程。
第 6 篇｜让 Claude Code 越用越强：我设计这套知识框架的完整思路
每开始一个新模块，都要重新告诉 Claude Code 项目规范、接口约定、上次踩的坑——这不对。
MAC 框架的设计：三层知识（通用 + 项目 + 模块）、session 启动自动读档、踩坑经验变成下一个模块的起点。知识越积越厚，Claude Code 越用越顺，新模块开始时不再从零开始。
配套视频：session-start 自动注入效果演示，有无知识库的启动差异对比。
第 7 篇｜MAC 框架开源：8 次推倒重来，它现在长这样
这个框架经历了 8 次迭代——从臃肿的多平台系统，到删掉 14 个文件反而好用了，到 Claude Code hooks 静默失效半个月，到在真实项目里发现一个核心设计根本没落地。
每次「为什么推倒」都写进去了。走弯路的部分比最终结果更值得看。框架开源，可以直接用。
配套视频：MAC 安装配置 + 在新项目里用 Claude Code 跑通第一个 worktree。
第 8 篇｜3 周 262 次提交：用 Claude Code 开发无人机系统的完整过程
8 个模块，并行推进，全程 Claude Code 主力驱动。
模块怎么划分、关键决策在哪里、真实遇到了哪些麻烦，以及每个模块的 git 数据。不是成功学，是过程，包括卡住的地方和怎么想清楚的。
配套视频：多 worktree 并行管理的实际操作，Claude Code 在各模块间的切换方式。
第 9 篇｜32 个工具定义是怎么从系统里生成出来的
系统写完之后多做了一件事：把系统接口转成 Agent 可以直接调用的工具。
Claude Code 在写代码的过程中已经生成了完整的 API 文档。32 个工具定义从这份文档转换而来，5 个 Skill 把工具组合成可以对话触发的能力。接口返回 32 条真实数据验证跑通。
为什么用 Claude Code 写的系统在这一步有天然优势——这篇讲清楚。
配套视频：/export-mcp 实际运行，从 API 文档到工具定义的全过程。
第 10 篇｜软件交付的终点不是上线，是变成 Agent
客户以后买的不是管理系统，而是一个会帮他们干活的 Agent。系统是 Claude Code 写的 → Claude Code 最懂这个系统 → 基于这套系统的 Agent 最能帮客户用好它。这个闭环，传统开发方式做不到。
对开发者意味着什么，对软件公司意味着什么，想走这条路的人起点在哪里。
配套视频：完整演示无人机 Agent 的对话交互全过程——从一句自然语言指令，到无人机任务自动下发、执行、报告生成。
关于素材的真实性
所有数据来自真实项目的 git 记录：
262 次提交，三周，全程 Claude Code 驱动 8 个模块并行：数据标注、智能识别、运维中心、障碍物规避…… Agent 分支：30+ tools 定义，10+ skills创建，调用生产接口返回真实数据 MAC 框架：8 个版本迭代，最早那个版本现在看起来像反面教材
弯路写进去了，失败写进去了，推倒重来也写进去了。
最有参考价值的，从来不是成功的结论，而是在哪里卡住、怎么想清楚的过程。
