想搞懂 AI Agent 到底在干嘛，先看这 100 行 while 循环：NamiAgent 的 11 节课

NamiAgent 是作者 aa1143 自己一步步学习、动手后整理出来的教程，代码用 MIT 协议，文档用 CC BY-NC 4.0（非商用署名）。它有两层身份：一套从零手写 Agent 的课程，也是一个能在本地跑起来的 Agent。

01课是怎么排的

前 7 课手写核心：最小循环（三个工具加一个 while 循环）、工具系统、权限、上下文管理、Skills、接入聊天软件（Telegram）、定时任务与心跳。后 4 课补主流能力：MCP、子 Agent、计划、记忆。每课在 lessons/ 下有一个目录，是学完这一课时的完整代码，可以直接运行，也能和相邻两课对照差异，看这一课到底加了什么。

第 12 到 18 课只有文章没有新代码，分别拆解 Claude Code、Codex、Pi、Grok Bot、DeepSeek Harness、OpenClaw 与 Hermes，最后一篇是总对照表。作者标明这部分写的是 2026 年 10 月的情况，产品更新快，细节请以各家官方文档为准。

02没有 API Key 也能先看

它只依赖 openai 这一个 Python 包，不用任何 Agent 框架，默认接 DeepSeek，换成别的 OpenAI 兼容模型只要改两个环境变量。从第 3 课起每课都带测试，第 11 课共 49 个，用的是“假模型”，也就是预先写好回答的替身，所以跑测试不花钱。

网页端也有演示模式，同样不需要密钥：左边看 Agent 每一步怎么想、调了什么工具，右边看每次发给模型的完整上下文，能直观看到上下文怎么一圈圈变长。

03按官方 README 走一遍

需要 Python 3.10 以上。下面是 README 里的快速开始，第 3 课起 Agent 只能操作你指定的那个工作目录，写文件、跑命令前都会先问你：

git clone https://github.com/aa1143/NamiAgent.git
cd NamiAgent
pip install -r requirements.txt

export API_KEY=你的模型密钥
export NAMI_WORKSPACE=~/agent-workspace
mkdir -p $NAMI_WORKSPACE

cd lessons/lesson-05
python agent.py

只想看效果，不想配密钥的话，用 python web/app.py --demo 打开网页端的演示模式；想只跑测试，进到 lessons/lesson-11 目录执行 pytest -q。以上命令整理自仓库 README，核对于 2026-11-05。

04适合谁，不适合谁

适合会一点 Python、想搞明白“Claude Code 这类工具里面到底发生了什么”的人。如果你的目标是直接做生产环境的产品，这个项目不合适：作者在 README 里明确写了这是教学代码，不是生产级框架。我的建议是先把第 1、2 课读完，再去看第 12 课拆解 Claude Code，对照着读，概念会清楚很多。