Learn Claude Code 智能体框架工程
一个从零构建的极简 Claude Code 风格智能体框架(Agent Harness),用 Python 实现,教你理解模型与工具、知识、权限等如何协作,适合想深入 Agent 底层原理的开发者。
爱鲜报评分
0.0
0 人评分
78k
星数
是
中文
Python
主语言
是
活跃
50
贡献者
人工分析
EDITORIAL推荐理由
该项目以「模型提供智能,框架提供环境」为核心思想,清晰区分了训练模型与构建框架的边界,帮助开发者摆脱对提示词编排的迷信。代码从 0 到 1 实现,结构简洁,配有完整教程和中文文档,是学习 Agent 工程化的优质教材。
适用场景
- 学习 Agent 底层原理与架构设计
- 构建自定义的代码助手或自动化工具
- 作为教学示例用于 AI 课程或工作坊
- 快速搭建可扩展的 Agent 原型
- 理解 Claude Code 等产品的内部机制
优点
- 从零实现,代码透明,易于理解和修改
- 强调 Harness 工程思维,而非简单的提示词拼接
- 提供中文文档和教程,对中文开发者友好
- 设计模式通用,可迁移到其他领域
- MIT 协议,可自由用于商业项目
缺点
- 需要一定的 Python 和 LLM 基础知识
- 功能相对基础,生产环境需自行扩展
- 依赖外部 LLM API,可能产生费用
- 文档和示例仍在完善中
上手难度
进阶
Learn Claude Code 智能体框架工程
项目简介
这是一个从零开始构建的极简「智能体框架」(Agent Harness),模仿 Claude Code 的设计,用 Python 实现。项目核心观点是:智能来自模型训练,而框架负责提供模型运行所需的环境。
核心思想
- 智能体 = 模型 + 框架
- 模型是驾驶员,框架是车辆。
- 框架包含:工具、知识、观察、行动接口、权限。
框架组成
Harness = Tools + Knowledge + Observation + Action Interfaces + Permissions
- 工具:文件读写、Shell 执行、网络请求等
- 知识:产品文档、API 规范、风格指南
- 观察:git diff、错误日志、浏览器状态
- 行动:CLI 命令、API 调用、UI 交互
- 权限:沙箱隔离、审批流程、信任边界
为什么值得学习
- 摆脱提示词编排的误区:很多所谓的 Agent 平台只是把 LLM 调用串起来,而本项目教你构建真正的运行环境。
- 从 0 到 1 实现:代码简洁,便于理解每个模块的作用。
- 通用设计模式:虽然面向编码场景,但模式可迁移到其他领域。
适用人群
- 想深入理解 Agent 工作原理的开发者
- 需要构建自定义代码助手或自动化工具的工程师
- 对 AI 智能体架构感兴趣的学生和研究者
快速开始
项目提供中文文档和示例,建议先阅读 README-zh.md 了解整体设计,再逐步运行代码。
注意:运行需要配置 LLM API 密钥,请参考文档中的环境变量设置。
评论
- 暂无评论,来写第一条吧。