learn-claude-code

手把手教你用 Python 从零写一个 AI 智能体

learn-claude-code 是一个教学型开源项目,旨在从零到一构建一个类似 Claude Code 的极简 AI 智能体框架(agent harness)。它用不到 2000 行 Python 代码,仅依赖 Bash 命令作为核心工具,展示了智能体如何通过循环调用 LLM、执行工具、处理结果来完成复杂任务。项目解决了初学者难以理解现代 AI 智能体内部机制的问题,将抽象概念具体化为可运行的代码。核心能力包括:定义工具函数、构建 agent 循环、与 Claude API 交互、解析模型输出并执行 Bash 命令等。它强调“Bash is all you need”的理念,用最简方式演示了 agent 的基本原理,适合开发者快速上手并动手修改,是理解 AI 智能体架构的绝佳入门教材。

开源 free 智能体
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 77444
维护状态 较活跃
是否开源 是
定价模式 free

项目数据

分类智能体
开发团队shareAI-lab
所属国家
定价模式free
价格说明开源项目,提供在线学习网站,完全免费,无付费版本。
访问状态
是否开源是
开源协议MIT
主要语言Python
技术栈/模型agent,agent-development,ai-agent,claude,claude-code,educational,llm,python,teaching,tutorial
GitHub 星标★ 77444
30天Star增速
HF 下载量
上线时间2025-06-29 00:00:00
最近更新2026-09-22 00:00:00
维护状态较活跃
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-09
浏览次数7

使用教程

难度:进阶 约 15 分钟 部署方式:本地安装 6 步

⚠ 该项目 README 未提供完整安装说明,以下步骤为通用流程,请以官方文档为准。

环境要求

  • Python 运行环境(项目为纯 Python 实现,README 未指定具体版本)
  • 可执行 Bash 命令的类 Unix 环境(项目核心理念为 Bash is all you need)
  • Claude API 访问凭证(项目需与 Claude API 交互)
  • Git(用于克隆 GitHub 仓库)
  • 可访问 GitHub 与 Claude API 的网络环境

安装与启动步骤

  1. 1克隆项目仓库

    从 GitHub 拉取教学项目源码到本地,地址取自项目 GitHub 主页。

    git clone https://github.com/shareAI-lab/learn-claude-code.git
  2. 2进入项目目录

    切换到克隆下来的仓库根目录,后续操作均在此进行。

    cd learn-claude-code
  3. 3阅读 Quick Start

    README 中的 Quick Start 章节是唯一动手入口,节选里未展开,需打开仓库原文查看。

  4. 4查阅官方教程

    官网提供逐步讲解,可与仓库代码对照学习智能体循环的构建过程。

  5. 5准备 Python 环境

    项目为 Python 实现,建议先建独立虚拟环境再按 Quick Start 安装依赖,避免污染全局。

    python -m venv .venv
    source .venv/bin/activate
  6. 6配置 Claude API 凭证

    项目要调用 Claude API,需自备密钥;README 节选未给出变量名,请以 Quick Start 或官网说明为准。

如何确认成功

按仓库 Quick Start 运行示例代码,能成功调用 Claude API 并由智能体执行 Bash 工具即算跑通。

常见问题

Q:这个项目需要什么前置知识?

A:需具备 Python 基础并了解 LLM API 调用。README 强调 agency 来自模型训练,harness 只是承载模型运转的载体,先理解这一理念再看代码会更顺。

Q:安装依赖的命令是什么?

A:README 节选只出现 Quick Start 标题、未列出依赖清单和安装命令,本教程不代为编造,请打开仓库 README 的 Quick Start 章节查看实际步骤。

Q:为什么部署教程这么简略?

A:仓库内容以智能体原理讲解为主,实操说明集中在 Quick Start 与官网 learn.shareai.run,建议两者结合阅读。

Q:必须用 Bash 吗?

A:是,项目刻意只把 Bash 作为核心工具,用来演示最简的智能体工具调用链路,换成其他工具会偏离教学目的。

注意事项

  • 本教程依据 README 节选与仓库地址推断,README 未给出确切安装命令,实际步骤请以仓库最新 Quick Start 和官网为准。
  • 项目仅约 2000 行 Python,定位是教学示例,不建议直接用于生产环境。
  • 智能体会真实执行 Bash 命令,运行时注意权限与安全边界,建议在隔离环境或容器中试验。

核心亮点

  • 代码极简,仅用少量 Python 行实现核心 agent 循环,易于通读和理解
  • 以 Bash 为唯一工具,降低复杂度,突出 agent 核心逻辑而非工具生态
  • 教学导向,配套教程和注释,适合作为 AI 智能体开发的入门实践

不足之处

  • 功能过于简化,仅支持 Bash 工具,无法直接用于生产级复杂任务
  • 文档/社区待观察

适用场景

  • 学习 AI 智能体内部原理,作为个人或团队的技术培训教材
  • 快速原型验证,用最小成本测试 agent 与 LLM 的交互逻辑
  • 作为基础框架,自行扩展工具集和功能,构建定制化 agent

替代项目

Claude Code、OpenAI Agents SDK、LangChain

项目介绍

learn-claude-code 是智能体领域的开源项目,由 shareAI-lab 开发,2025 年首次发布。

在全站 13,109 个收录项目中,它的 GitHub 星标数(77,444)位列前 1%,在智能体分类的 2,520 个项目里位列前 1%。

近 42 天,它的 GitHub 星标从 73,966 增加到 77,444,净增 3,478。

项目保持着较活跃的维护节奏,最近一次代码更新于 2026-09-22。提供在线学习网站,完全免费,无付费版本。从国内网络环境看,可直接访问。

它主要面向的使用场景是:学习AI智能体内部原理,作为个人或团队的技术培训教材。同类可对比的替代方案包括 Claude Code、OpenAI Agents SDK、LangChain。

上一篇:orca

下一篇:cherry-studio

同类项目推荐

xinchao-dynamic-mind 开源

给 AI 装上疲惫和欲望,让交互更真实

独立、可自托管的 AI 动态心智状态引擎:驱动力、念头池、疲惫、睡眠与意图。

★ 199 2026-08-09
deepseek-harness 开源

把 AI 能力拆成乐高积木,拼出你的专属智能体。

DeepSeek Harness: Everything is a Plugin.

★ 233327 2026-08-15
AutoGPT 开源

开箱即用的 AI 员工,交代任务就自己干完

AutoGPT is the vision of accessible AI for everyone, to use and to build on. Our mis···

★ 187492 2026-08-09
EvoAgentX 开源

让 AI 智能体自己迭代变强,越用越聪明

EvoAgentX: Building a Self-Evolving Ecosystem of AI Agents

★ 3351 2026-09-12