Agent 与 Harness：思想与 Python 实践

从一个具体问题开始：模型提出运行一段代码以后，谁真正执行，谁保存结果，又是谁决定下一步？这本小册从这些交接出发，逐步理解 Agent 的机制，并用 Python 写出自己的运行框架。

每课分成思想与实践两篇。思想篇用一个问题、分步图和短代码说明机制；实践篇沿同一个例子，只增加当前机制需要的实现。可以一课一课边理解边动手，也可以先读各课思想，再回来实践。

第一课从“运行 main.py，只报告结果”出发。思想篇追踪六次交接，实践篇写出有调用上限的循环。示例已通过离线响应与真实 Python 进程验证，并提供真实 Claude API 入口；在线模型尚未调用。后续各课逐步扩展独立 Python 实践仓库，不提前发布空章节。

本册参考社区课程 [Learn Claude Code](https://learn.shareai.run/zh/) 组织学习。实践代码由本册独立编写，Claude API 的协议要求与本册的设计选择分别说明。