learn-claude-code 开源项目解析：AI Agent 原理与实战入门

git clone https://github.com/shareAI-lab/learn-claude-code
cd learn-claude-code
pip install -r requirements.txt
cp .env.example .env
# 编辑 .env 填入你的 ANTHROPIC_API_KEY
python agents/s01_agent_loop.py          # 从这里开始
python agents/s12_worktree_task_isolation.py # 完整递进终点
python agents/s_full.py                  # 总纲：全部机制合一

这个项目是可运行的 Coding Agent 简化实现，需要配置你自己的 API Key，才能观察完整交互过程。

为什么要 cp .env.example .env？

• .env.example 是模板文件，可以提交到仓库。
• .env 通常在 .gitignore 中，会在 Git 推送时被忽略。
• 这样能避免 API Key 泄露。

所以，把你的密钥和配置写进 .env 即可。

如果运行时报错，优先检查环境变量是否配置正确。多数初始问题都来自这里。

跑通脚本后，你可以直接在终端里和智能体对话；一边跑、一边看源码，理解速度会快很多。

再用 Web 可视化加深理解

CLI 适合实操，Web 页面更适合建立整体认知。项目提供了交互式可视化、分步动画、源码查看器，以及每节课的配套文档。

cd web && npm install && npm run dev  # http://localhost:3000

命令执行后，在浏览器打开对应地址即可进入学习页面。

每节课都能看到动画演示、学习材料、模拟过程和源码，还能进一步做深入探索。

你可以在这个交互页面按章节学习，也可以回到终端直接和对应章节的 Agent 对话。

每个章节都明确标注了相对前一章的变化点，这对建立'演进视角'非常有帮助。

从智能体循环、TODO 子智能体，到 Skills、任务系统、上下文压缩、Agent 团队、自主协作与用户隔离，这套内容覆盖得很完整。

总结

如果你想真正理解 AI Agent 的工作原理，而不只是停留在'会用工具'，这个项目是很好的切入点：

• 循序渐进：12 节课，每节只加一个机制，学习负担可控。
• 可运行代码：不是纸上谈兵，代码能跑、能调试、能改。
• 可视化学习：交互式页面把抽象循环变得可感知。
• 生产级思维：任务拆分、上下文管理、多 Agent 协作都贴近真实系统设计。

无论你是想从零搭建一个 Agent，还是想深入理解 Claude Code 这类工具背后的设计逻辑，这个项目都值得系统过一遍。

仓库地址：https://github.com/shareAI-lab/learn-claude-code