模块 ② · 搭建 · Harness 五支柱

亲手造一个 mini Claude Code

简单任务用不上,复杂项目离不开

上一步你造出了第一个会干活的 agent。现在把它一步步升级成一个有工具箱、会规划、能派子智能体、会压缩记忆、有安全门的 mini Claude Code——只加 6 个想法。

为什么要升级?

「创建 hello.txt」这种小任务,一个基础 agent 就够了。但真实开发面对的是一个有很多文件、互相调用、还可能藏着 bug 的项目。下面这五个机制,恰恰只有在这种真实项目上才显出价值——简单任务用不上,复杂项目离不开。

Harness 的五根支柱(c0 → c5)

每一步只加一个想法。终点只有 ~35 行,却已经是真 Claude Code 的雏形。

c0

JSON 协议

把上一步的「命令:/完成:」文本,升级成结构化 JSON。为什么:机器读得准、前端好解析,不再靠猜。

c1

工具箱

不止能跑命令——加上 read_file / write_file,按名字派发。为什么:真实项目要读写很多文件,一个 bash 不够用。

c2

计划是工具(TodoWrite)

让 agent 先列出计划、边做边勾。为什么:多步骤任务不列计划,做着做着就乱、就漏。

c3

子智能体

派一个有独立上下文的子 agent 去干脏活,只拿回一句摘要。为什么:脏活塞主上下文会爆;也是「安全复核」的用法。

c4

上下文压缩

历史太长就自动折叠成摘要、重开窗口。为什么:长对话会撑爆上下文,压缩让它能一直干下去。

c5

权限门(Human-in-the-loop)

危险命令(删文件等)执行前先问你 y/n。为什么:放权给 AI,但高风险动作必须人点头——安全底线。

🐰 这五根支柱,就是真 Claude Code 的骨架。你亲手把它们一个个装上去,以后用真 Claude Code 时,你就知道它「里面在干什么」——这正是模块④「上线」时,你后端 agent 的地基。

demo_project:一个练手的「真项目靶子」

光在「创建 hello.txt」上练,你永远看不出这五个机制为什么存在。所以我们准备了一个麻雀虽小、五脏俱全的玩具笔记本 CLI(notes_app:多文件 + README + TODO + 一个故意藏起来的 bug)。c0–c5 的每个复杂例子和作业,都在这同一个靶子上跑——你会亲眼看到:哦,原来这一步是为了这个。

看懂了?现在轮到你动手

打开开源仓库,跟着 c0→c5 一步步把 mini Claude Code 造出来。你不用手写,让 Claude Code 帮你跑、你负责看懂每一支柱。卡住了叫爱兔宝。

打开 build-your-agents
爱兔宝
爱兔宝 🐰在线 · i2i 学习教练
🐰 爱兔宝会一步步带你走完这一节