shareAI-lab

shareAI-lab / learn-claude-code

#12
17,9503,766+175 todayTypeScript

Bash 就是你的全部所需!仅用 16 行代码编写一个 Claude 程序

shareAI-lab/learn-claude-code 是一个使用 TypeScript 编写的教育性开源项目,旨在通过构建一个微型 AI 智能体来教授智能体开发的核心原理。该项目从零开始,通过 12 个循序渐进的会话,逐步将一个仅用 16 行 Bash 脚本实现的简单循环,演进成一个具备规划、隔离执行、状态管理和多代理协作等复杂功能的类 Claude Code 智能体。每个会话只引入一个核心机制,例如“先规划后行动”、“按需加载知识”和“通过任务ID协调”,并强调核心循环模式保持不变。这种设计使得开发者能够清晰地理解每个功能模块的作用,而不被复杂的生产级框架所困扰。该项目非常适合希望深入理解 AI 智能体底层工作机制,并动手实践从简单到复杂系统构建的学习者和教育者。

💡 应用场景

最适合从零学习Agent核心原理和快速构建轻量级自动化助手的教学与实践项目。

快速理解Agent核心

问题:想学习AI Agent开发但被复杂框架吓退,需要从零理解最核心的循环机制。

方案:通过12个渐进式会话,从最简单的bash循环开始,每步只添加一个机制,让你真正理解Agent如何工作。

示例:从s01的“bash + 循环 = 基础Agent”开始,逐步添加工具、规划、子代理等,避免一开始就面对复杂架构。

教学演示Agent原理

问题:需要向学生或团队成员讲解Agent工作原理,但现有框架过于复杂不适合教学。

方案:使用这个极简的16行核心循环作为教学示例,配合12个渐进式机制演示Agent的演化过程。

示例:在技术分享中展示s03的“先规划后执行”机制,用可视化的计划步骤说明Agent如何思考。

构建轻量级自动化

问题:需要快速构建一个能执行简单任务的自动化助手,不想引入重型Agent框架。

方案:基于项目的核心循环,添加必要的工具和规划能力,创建一个专注于特定任务的轻量级Agent。

示例:创建一个文件整理Agent,使用bash工具操作文件,通过规划机制决定整理策略,无需复杂配置。

实验Agent新机制

问题:想实验新的Agent机制(如状态管理、团队协作),但现有框架修改成本高。

方案:利用项目的模块化设计,在核心循环基础上快速添加和测试新机制,每个机制独立且可组合。

示例:实验s09的“异步邮箱”团队协作机制,验证多个Agent如何通过消息队列协同工作,不影响核心循环。

📊 项目信息

语言
TypeScript
Stars
17,950
Forks
3,766
今日新增
+175
排名
#12
收录
总榜
趋势日期
2026年2月25日
最后推送
2026/2/23

🏷️ 标签

TypeScriptBashAI代理开发教学教程渐进式学习轻量级初学者友好开发者学习

📸 截图

learn-claude-code screenshot 1