VISUAL GUIDE

Learn Claude Code

13 节递进课程,用可视化方式拆解 Claude Code 的 Harness 架构。
点击任意卡片进入对应课程。

基础循环
01
s01

Agent Loop

一个循环 + Bash = Agent

从零推导 Agent Loop 为什么存在、怎么工作。理解双层循环结构。

02
s02

Tool Use

加工具不改循环

Dispatch Map 模式:字典映射替代 if/elif 链。safe_path 路径沙箱。

03
s03

TodoWrite

先计划再动手

外部记忆 + Nag Reminder,让 Agent 在多步任务中不迷路。

04
s04

Subagent

外包脏活,隔离上下文

子 Agent 独立 messages,干完活只返回摘要,上下文不污染。

知识与上下文
05
s05

Skill Loading

按需加载知识

通过 tool_result 注入领域知识,不塞 system prompt。

06
s06

Context Compact

上下文要释放

三层压缩策略:microcompact + auto-compact + manual compact。

任务与团队
07
s07

Task System

任务持久化到磁盘

文件持久化的任务图,带依赖关系,为多 Agent 协作打基础。

08
s08

Background Tasks

慢操作丢后台

后台线程执行命令,完成时注入通知,Agent 不阻塞等待。

09
s09

Agent Teams

多 Agent 邮箱通信

异步消息传递,Agent 之间通过 inbox/outbox 协作。

隔离与治理
10
s10

Team Protocols

Plan Gate + Shutdown

Plan 审批流程 + 安全关闭 handshake。

11
s11

Autonomous Agents

自动领取任务

Agent 空闲时自动从任务池 claim 任务,实现自主持续工作。

12
s12

Worktree Isolation

Git Worktree 并行

每个 Agent 独立 git worktree,并行开发不冲突。

实战搭建
13
s13

Build Your Own

抄起键盘,从零搭建

将 s01-s12 所有层组装成可运行的 harness.py,跟着逐层写出你自己的 Agent 外壳。