Appearance
学习路径
从 Agent 循环到多 Agent 协作，每次只加一个机制
这是什么
这是一份基于 Claude Code v2.1.88 真实源码的 Harness Engineering 架构解读教程。面向 Agent 开发者，帮助你理解当前第一梯队 AI Agent 的工程架构，并将这些设计思想用于自己的 agent 开发。
不是使用教程 —— 不教你怎么用 Claude Code，而是教你它是怎么建的，以及为什么这样建。
本教程 vs 其他资源
- vs shareAI-lab/learn-claude-code：那个偏动手从零构建，本教程偏源码级架构解读
- vs Anthropic Academy：官方视角 vs 社区驱动的源码深度分析
- vs 逆向博客 (kirshatrov.com, sabrina.dev)：散点分析 vs 16 课系统体系
教程特色
- Harness 视角：以"模型之外的一切工程基础设施"为主线，揭示 Claude Code 的真正竞争力
- Python 伪代码：每课附 Python 参考实现，无需 TypeScript 基础
- 源码映射：每个概念标注真实源码路径，可自行深入
- 设计决策：对比 OpenCode / Cursor 的不同工程选择，理解 trade-off
- Context Engineering 框架：用 Write / Select / Compress / Isolate 四策略串联全部课程
六层架构
学习路线
根据你的背景和目标，选择合适的路线：
| 路线 | 时间 | 课程 | 适合人群 |
|---|---|---|---|
| 速览路线 | 2-3h | s00 → s01 → s02 → s07 → s16 | 想快速了解整体架构 |
| 完整路线 | 2-3 天 | s00 → s01 → ... → s16 | 想系统掌握 Harness 设计 |
| 安全专项 | 半天 | s04 → s05 → s06 | 关注权限和安全机制 |
| 上下文专项 | 半天 | s03 → s07 → s09 | 关注 Context Engineering |
| 多 Agent 专项 | 半天 | s11 → s12 → s13 → s14 | 关注多 Agent 编排 |
课程总览
| 课 | 标题 | Motto | Context 策略 | 关键源码 |
|---|---|---|---|---|
| s00 | Harness Engineering | The harness is 99% of the code | 全部 | — |
| s01 | Agent 循环 | One loop is all you need | — | QueryEngine.ts, query.ts |
| s02 | 工具系统 | Tools are the hands of the agent | — | src/tools/, commands.ts |
| s03 | 系统提示词 | Every token has a price tag | Select | context.ts, claude.ts |
| s04 | 权限系统 | Trust, but verify | — | utils/permissions/ |
| s05 | Hooks | Don't just react, automate | Select | utils/hooks/ |
| s06 | 设置层级 | Configuration is a contract | Write | utils/settings/ |
| s07 | 上下文压缩 | Forget wisely, remember what matters | Compress | services/compact/ |
| s08 | Memory 系统 | An agent without memory is a stranger | Write | memdir/ |
| s09 | Skills | Know what's available; load how on demand | Select | skills/ |
| s10 | Plan 模式 | Measure twice, cut once | — | EnterPlanModeTool/ |
| s11 | 任务系统 | Plan the work, work the plan | Write | tasks/ |
| s12 | 子 Agent | Clean context per subtask | Isolate | tools/AgentTool/ |
| s13 | Agent 团队 | More than the sum of its agents | Isolate | TeamCreateTool/ |
| s14 | Worktree | Tasks manage WHAT, worktrees manage WHERE | Isolate | utils/worktree.ts |
| s15 | MCP 集成 | Only as powerful as the tools it can reach | — | services/mcp/ |
| s16 | 全景架构 | See the forest, then the trees | — | cli.tsx, main.tsx |
学习建议
- 先读 s00 导论：建立 Harness Engineering 和 Context Engineering 的整体框架
- 按层推进：每层解决一类问题，层内的课程有内在联系
- 先读伪代码：Python 伪代码能快速建立心智模型，再看源码映射深入
- 关注设计决策：这是本教程最有价值的部分 —— 不仅知道"怎么做"，更知道"为什么"
- 动手试试：每课末尾有练习建议，建议用 Python 实现一遍
前置知识
- Python 编程基础
- 了解 LLM API 调用（如 OpenAI/Anthropic API 的 messages 格式）
- 基本的 git 操作
- 不需要 TypeScript 基础（但能读更好）