learn-claude-code（shareAI-lab/learn-claude-code）是一个教学型项目，从 0 到 1 教你构建一个「nano 版 Claude Code 式」的 Agent harness（智能体外壳/运行框架），口号「Bash is all you need」。它的核心观点是：智能体的「能动性（agency）」来自模型训练本身，而一个可用的 Agent 产品 = 模型 + harness——模型是驾驶员，harness 是车；本仓库教你造这辆车。内容偏「Harness Engineering」（运行框架工程），用 Python 实现一个最小化的编码代理。MIT 许可，约 62,323 stars，主语言 Python，多语言 README，定位教育/教学。
来源：README.md（标题、Agency 论述、Harness Engineering）；GitHub 仓库元数据（stars=62323、language=Python、license=MIT、topics educational/tutorial） 查看 GitHub 仓库 →很多人想理解「Claude Code 这类编码代理到底怎么工作」，但商业产品是黑盒。learn-claude-code 用从零构建的最小实现 + 清晰论述（区分「模型提供能动性」与「harness 提供运行环境」）来教学，帮助读者从代理产品的「使用者」变成「构建者」，话题性强、教学价值高，因而 star 快速增长。需说明：它是教学/最小实现（nano），目标是讲清原理而非做生产级产品；要在真实环境运行最小 harness 时，注意它会执行命令（Bash），应在受控/沙箱环境中谨慎使用。截至数据采集约 62,323 stars。
来源：README.md（标题、Agency 论述）；GitHub 仓库元数据（stars=62323、pushed_at 2026-05、topics teaching）用 Python 从 0 到 1 实现一个 nano 版 Claude Code 式的智能体运行框架。
来源：README.md（标题、Harness Engineering）清晰阐述能动性来自模型训练、可用 Agent = 模型 + harness 的核心理念。
来源：README.md（Agency Comes from the Model）以「Bash is all you need」为思路，给模型一个执行工具/命令的感知-推理-行动循环。
来源：README.md（标题 Bash is all you need）面向教学，配历史案例论证与多语言 README，帮助从使用者变为构建者。
来源：README.md（多语言、教育定位、Agency 论述）项目以 Python 实现一个极简的「Claude Code 式」agent harness，核心思想是「Bash is all you need」——给模型一个能执行 shell/工具调用的循环（感知→推理→行动），让模型驱动任务完成，而把编排、工具执行、上下文管理等放在 harness 层。README 用大量历史案例（DQN、OpenAI Five、AlphaStar 等）论证能动性源自训练而非外部编排，引出「模型 + harness」的产品观，然后带读者从 0 到 1 搭建这个最小运行框架。它是教学代码 + 讲解，强调理解原理与亲手实现。
来源：README.md（标题、Agency 论述、Where Agency Comes From）；GitHub 仓库元数据（language=Python）中心为项目本体，内环 = 核心功能模块，外环 = 关键技术依赖；按 deep.json 中的 core_features 与 tech_stack.key_deps 自动生成
LLM（提供能动性的模型）Shell/Bash 工具执行最小化编排与上下文管理适合想真正理解编码代理（如 Claude Code）工作原理的开发者与学习者：通过亲手实现最小 harness，理解「模型 + harness」如何协作、工具/命令执行循环如何驱动任务，从代理的使用者成长为构建者；也适合作为 agent 开发的教学材料或自研 harness 的起点。它是教学项目，不面向直接生产部署。
来源：README.md（Agency 论述、教育定位）本页无版本号；这是持续更新的教学项目，更新体现在教程与最小实现的完善。仓库最后更新约在 2026 年 5 月，维护活跃。
来源：README.md（教育定位）；GitHub pushed_atlearn-claude-code 是一个高人气的教学项目：从 0 到 1 教你构建一个 nano 版 Claude Code 式的 agent harness，并清晰阐述「能动性来自模型训练、可用 Agent = 模型 + harness」的核心理念，用极简「Bash is all you need」的实现帮助读者真正理解编码代理如何工作、从使用者变为构建者，教学价值高、论述清晰、MIT 开源。要清楚它是教学/最小实现而非生产产品、harness 会执行命令需在受控/沙箱环境谨慎运行、能力上限取决于所用模型、落地需自行扩展。作为理解与自研 agent harness 的入门项目，简洁、深刻、上手友好。
来源：综合 README.md 的定位、核心理念、最小实现与教学性质