Repolode
shareAI-lab

shareAI-lab/learn-claude-code

一套从零搭建类 Claude Code 智能体框架的 17 课 Python 教程,从单循环加 bash 开始。

可替代:Claude Code

Star
78,839
Fork
12,616
未关闭 Issue
70
最近提交
22天前

这是什么?

这是一门关于 harness 工程的教程,讲解如何为大模型编写工具、权限、上下文管理和协作等代码,使其能作为智能体工作。仓库的核心观点是:智能体的能力来自训练好的模型,而 harness 负责提供模型运行所需的环境、工具和边界。

课程共 17 章(s01 至 s17),每章聚焦一个机制,包括核心智能体循环、工具分发、权限系统、钩子、待办规划、子智能体、技能按需加载、上下文压缩、记忆、基于文件的任务图、后台任务、定时调度、绑定工作树的多智能体团队、MCP 工具接入、工作流运行时以及基于目标的循环控制。每章附带可运行的 code.py,第 15 章将各机制整合进同一个循环。

代码基于 Anthropic messages API,配置 API 密钥后用 Python 运行。仓库同时保留了旧版 12 课内容,并提供网页版课程界面。

核心功能

  • 01从单个 bash 工具起步,围绕 tool_use 块搭建智能体循环。
  • 02讲解权限规则、审批流程以及工具调用前后的钩子。
  • 03包含待办规划、消息列表隔离的子智能体和上下文压缩。
  • 04演示基于文件的任务图、后台执行和定时调度。
  • 05展示绑定工作树的多智能体团队以及 MCP 工具接入。
  • 06每章附带可独立运行的 code.py,并提供中文和日文版说明。

适用场景

  • 了解 Claude Code 等编程智能体的内部结构。
  • 参照课程中的机制模式,为特定领域搭建自定义智能体框架。
  • 在培训或课堂中讲解智能体设计概念。
  • 通过小型可运行示例,对比工具分发、上下文压缩和多智能体协作的设计方式。

快速上手

  1. 1

    克隆仓库

    git clone https://github.com/shareAI-lab/learn-claude-code
  2. 2

    打开第一课文件夹并按照其 README 操作

  3. 3

    运行该课程的代码文件

    python s01_agent_loop/code.py

使用前须知

  • README 没有给出安装命令,您需要自行配置 Python 依赖和 API 密钥。
  • 课程代码调用 Claude API,需要付费的 API 密钥。

标签

常见问题

learn-claude-code 是什么?
一套从零搭建类 Claude Code 智能体框架的 17 课 Python 教程,从单循环加 bash 开始。 这是一门关于 harness 工程的教程,讲解如何为大模型编写工具、权限、上下文管理和协作等代码,使其能作为智能体工作。仓库的核心观点是:智能体的能力来自训练好的模型,而 harness 负责提供模型运行所需的环境、工具和边界。
learn-claude-code 可以免费使用吗?用的什么许可证?
learn-claude-code 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
learn-claude-code 还在维护吗?
活跃维护中。learn-claude-code 最近一次提交是在 2026年9月28日。
learn-claude-code 适合用来做什么?
了解 Claude Code 等编程智能体的内部结构。 参照课程中的机制模式,为特定领域搭建自定义智能体框架。 在培训或课堂中讲解智能体设计概念。 通过小型可运行示例,对比工具分发、上下文压缩和多智能体协作的设计方式。
learn-claude-code 怎么安装和运行?
克隆仓库: git clone https://github.com/shareAI-lab/learn-claude-code 打开第一课文件夹并按照其 README 操作 运行该课程的代码文件: python s01_agent_loop/code.py
在哪里获取 learn-claude-code?
源代码和安装说明在 GitHub 上:https://github.com/shareAI-lab/learn-claude-code

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目