Claude Code 架构精读:从 30 行循环到独立判断器
精读开源项目 shareAI-lab/learn-claude-code 的三个核心 session。
关键字:Agent Loop / Integrated Harness / Goal Loop / 独立判断器 / Hooks / 权限边界。
系列位置:9-16 Harness 工程 → 9-17 AI Coding 工程 → 9-18 Agent Loop → 9-20 Harness 全家福 → 本文(读别人的 harness 实现)。
📌 写在前面:这次讲什么,怎么讲
前 4 篇 Harness 系列是我自己搭的。这一次不一样 —— 我在读一个把 Claude Code 剥到只剩骨架的开源项目,442 个文件,17 个 session,中文文档齐全。
我挑了三个 session 精读:
| Session | 代码量 | 一句话 |
|---|---|---|
| s01 Agent Loop | 120 行 | 一个 while True + 一个 bash = 一个 Agent |
| s15 Integrated Harness | 3326 行 / 158 函数 | 26 个工具 + 15 个机制,全挂在同一个循环上 |
| s17 Goal Loop | 903 行 | 模型说停不算停,独立判断器说了算 |
讲法我改了:前几篇我是"先讲架构,再举例"。这次反过来 —— 先说你在什么处境下会需要它,再给能直接抄的样例,最后才拆架构。
因为 11 年经验的人不需要"这是什么",需要的是"这玩意解决我什么问题、我什么时候用、怎么用"。
2026年10月8日...大约 30 分钟