learn-claude-code
learn-claude-code 是 shareAI-lab 推出的开放课程,通过用 Python 从零实现一个类似 Claude Code 的小型编程 Agent,来讲解“运行框架工程”(harness engineering)。它的出发点是:Agent 的能动性来自模型本身,而一个可用的 Agent 产品等于模型加上运行框架,也就是围绕模型的循环、工具、权限、上下文管理和协作机制。课程一次加入一种机制,逐步搭出这个框架。
它适合想弄清楚编程 Agent 工作原理、而不只是会用的开发者。当前版本共 17 节循序渐进的课程,每节加入一种机制并配有可运行的代码:只用一个 bash 工具的核心 Agent 循环、添加工具、权限边界、Hooks、用待办清单做规划、子 Agent、按需加载 Skills、上下文压缩、记忆、基于文件的任务图、后台任务、定时调度、Agent 团队、MCP、整合后的运行时、可恢复的工作流,以及目标驱动的持续执行。课程文字有英文、中文和日文版本,还有一个网页平台,提供源码、模拟器和架构视图。课程对拖拽式“Agent”搭建工具持鲜明的批评态度,读者未必都认同。
上手方式:克隆仓库,执行 `pip install -r requirements.txt`,把 `.env.example` 复制为 `.env` 并填入 `ANTHROPIC_API_KEY`,然后运行 `python s01_agent_loop/code.py`。网页版在 `web` 目录下运行 `npm install && npm run dev` 即可。
功能特性
为什么选择它
权衡点
维护状况检查
- 最近提交
- 2026-10-27
- 近 90 天提交数
- 63
- 近 90 天发布数
- 0
- 最新发布
- —
- 未关闭 issue
- 58
- 近期 issue 至少有一条评论的比例
- 4/20
最早的一周在左边,最近 4 周为橙色。数据来源:GitHub 提交统计。
状态规则:GitHub 上已归档 = 已归档;最近提交在 90 天内 = 活跃;91 到 365 天 = 放缓;更久 = 停滞。所有数字来自所示日期的 GitHub API。
讨论最多的未关闭 issue
- #290 关于context offloading/compac 上下文卸载/压缩 中的问题10 条评论 · 2026-05-19
- #338 感谢大佬的教程,学完后自己做了一个乐高式组装harness的项目,分享出来共同学习4 条评论 · 2026-06-01
- #234 s09_agent_teams执行流程疑问4 条评论 · 2026-04-16
- #349 建议每节课只展示新代码,旧代码用 import 引用3 条评论 · 2026-06-05
- #65 Windows 11 support: changes needed for all agent files3 条评论 · 2026-03-09
issue 标题引自 GitHub。请打开链接确认该问题是否仍适用于你使用的版本。
适合谁
- 你想从底层原理彻底搞懂类似 Claude Code 的现代自主编码 Agent 是如何工作的(从基础 Bash 循环到多工具调用与记忆系统)。
- 喜欢循序渐进、每一步都有可运行极简代码的实战教程,提供中、英、日三语教学内容与交互式学习版本。
- 你只想要一个安装即用的日常生产工具,并不想学习其底层实现原理(直接安装官方 Claude Code 或 Aider 即可)。
- 需要现成的企业级多 Agent 复杂协作平台(CrewAI、MetaGPT 更适合直接用于生产项目编排)。
与同类的区别
learn-claude-code 是以认知和工程教学为核心的教程代码库;mini-swe-agent 是面向 SWE-bench 基准验证、极度追求单文件性能的高效参考实现。
learn-claude-code 拆解的是单体 Coding Agent 的交互循环与命令执行;MetaGPT 则模拟多角色软件工程团队(产品经理、架构师、工程师)的多 Agent 协同系统。
兼容性
快速开始
使用场景
同类工具
评论
暂无评论,来发表第一条吧