【learn-claude-code】从零手把手教你造一个会写代码的 AI 助手，12 步拆解 Claude Code 的核心逻辑

作者提米哥

这是一个面向学习者的教学型项目，它用 12 个渐进式实践环节，带你从最基础的“一次循环 + Bash 命令”出发，亲手构建一个具备真实能力的轻量级 AI 编程助手——不依赖黑盒框架，不跳过关键设计决策，只讲清楚“为什么这样设计”。

项目的主要特性（按学习路径组织）：
– ✅ 极简但完整的智能体循环：基于 stop_reason == "tool_use" 的标准响应判断，实现“调用工具 → 获取结果 → 追加到对话历史 → 继续推理”的最小闭环。
– ✅ 可插拔的工具系统：每新增一个工具，只需注册一个 handler 函数，主循环逻辑完全不变。
– ✅ 分阶段增强能力：从任务规划（s03）、子代理隔离（s04）、按需加载知识（s05）、上下文压缩（s06），到持久化任务图（s07）、后台异步执行（s08）、多智能体协作（s09–s11），再到工作目录级隔离（s12）。
– ✅ 配套交互式学习平台：内置 Next.js 开发的 Web 界面，支持可视化流程图、逐行代码讲解、文档对照与实时演示。
– ✅ 开箱即用的完整示例：提供 s01_agent_loop.py（起点）和 s_full.py（集大成版）等可直接运行的参考实现。

安装与快速上手： 

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  # 运行第一个会调用 Bash 的智能体

Web 学习平台启动： 

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

这个项目最适合以下场景和人群：
– AI 工程师 / LLM 应用开发者：想深入理解“AI 编程助手”底层运行机制，而非仅调用封装好的 SDK；
– 高校教师与课程设计者：需要结构清晰、原理透明、可拆解的教学材料，用于讲授智能体架构；
– 动手型学习者：反感概念堆砌，偏好“写一行、跑一次、看效果、懂原理”的渐进式实践路径；
– 技术布道者与开源协作者：项目采用多语言文档（中/英/日）、ASCII 示意图优先、心智模型驱动讲解，便于本地化与二次传播。

总结：它不是一个开箱即用的生产力工具，而是一份“可执行的教科书”——把 Claude Code 类智能体的核心范式，拆解为 12 个有 motto、有代码、有演进逻辑的原子单元。如果你曾困惑于“Agent 到底怎么一步步变聪明”，那么这 12 步就是最扎实的答案。建议访问其主页获取更详细信息。

作加

类似文章