Skip to content

Claude Code ​

“One loop & Bash is all you need”

这个模块做一件事:从零手写一个 Agent,一层一层叠加机制,最终变成一个能处理真实任务的 Coding Agent。

不调包,不用框架。每一章都是对上一章的一次有限扩展,代码始终可运行。


课程结构 ​

12 节课,分两段:

基础 Harness(s01–s06):从 Agent Loop 开始,逐步加入工具、规划、上下文等机制,构成基础 Harness;Loop 是其中的执行内核,不等于完整 Harness

章节机制核心思路
s01Agent Loopwhile True + stop_reason = 最小执行内核
s02Tool Usedispatch map,加工具不改循环
s03TodoWrite规划层,防止模型在长任务中迷路
s04Subagent上下文隔离,子任务不污染主对话
s05Skill Loading按需加载领域知识,节省 token
s06Context Compact三层压缩,换来无限会话长度

高级系统(s07–s12):让 Agent 能处理真实工程任务

章节机制核心思路
s07Task System磁盘持久化 DAG,任务依赖和阻塞
s08Background Tasks非阻塞工具执行,Agent 循环不卡住
s09Agent Teams文件消息总线,多 Agent 协作
s10Team Protocols请求-响应握手,结构化通信
s11Autonomous Agents自组织团队,成员自己认领任务
s12Worktree Isolation每个任务独立 Git worktree,并行不踩踏

设计哲学 ​

Agent 的复杂度应该随需求增长,而不是从一开始就引入。

s01 是 30 行。每一节只加必要的机制,解决前一节暴露出来的具体问题。读完之后你会发现,所有的“框架”都是这些机制的不同组合。

参考仓库:shareAI-lab/learn-claude-code(来源地址:https://github.com/shareAI-lab/learn-claude-code)


章节列表 ​

把零散知识,整理成可以反复走的路。