learn-claude-code

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

开源 🏷️完全免费 ✅ 目前可打开 智能体 🍴 复刻 12817 🐛 待处理 57 👀 关注 307
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 80115
维护状态 较活跃
是否开源 开源
定价模式 🏷️完全免费 开源项目,提供在线学习网站,完全免费,无付费版本。

项目预览

learn-claude-code 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类智能体
开发团队shareAI-lab
定价模式🏷️完全免费
价格说明开源项目,提供在线学习网站,完全免费,无付费版本。
访问状态✅ 目前可打开
是否开源是
开源协议MIT
主要语言Python
技术栈/模型agent,agent-development,ai-agent,claude,claude-code,educational,llm,python,teaching,tutorial
GitHub 星标★ 80115
上线时间2025-06-29 00:00:00
代码更新2026-10-27
仓库体积6.0 MB
本站数据更新2026-11-09
维护状态较活跃
收录时间2026-08-09
浏览次数10

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 80115

使用教程

⚠ 本教程由 AI 依据该项目 README 整理;原始文档不完整,部分步骤为通用流程推断,实际安装请以项目官方文档为准。

难度:进阶 约 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

上一篇:orca

下一篇:cherry-studio

同类项目推荐

arsumbris 开源

搭一个懂你行业的智能体工作区,把知识活自动化

A workspace and framework to build domain-specific systems for agentic knowledge wor···

★ 270 2026-10-13
ue5-mcp-bridge 开源

把 AI 接入 UE5 编辑器,用自然语言驱动游戏开发

MCP server bridging AI assistants to Unreal Engine 5 editor

★ 66 2026-08-09
Hopet 开源

把终端 AI 变成桌面像素宠物,实时同步状态

A macOS desktop AI pet that mirrors your Claude Code & Codex CLI session state in re···

★ 63 2026-08-09
openseek 开源

在终端里用多模型 AI 编程,Plan/Agent/YOLO 模式随心切换

OpenSeek - 广度求索: open-source TUI coding agent with multi-provider routing, MCP, ···

★ 208 2026-08-09
codexloom 开源

把零散 AI 对话变成可复用的领域专家团队

Turn Codex threads into an organization of long-lived domain agents.

★ 391 2026-08-09
kubeopencode 开源

把 AI 编码代理跑在 K8s 上,弹性调度、集中管理。

Run OpenCode Agent on Kubernetes

★ 121 2026-08-09
papa-ts 开源

浏览器里跑私有 AI,离线也能聊

This library exposes PAPA, your Personal Assistant powered by Private AI, which can ···

★ 58 2026-08-09
agent-file 开源

把智能体存成一个文件,随时分享、回滚、换框架。

Agent File (.af): An open file format for serializing stateful AI agents with persis···

★ 1216 2026-10-19
Orkas 开源

对话组建AI团队,自动拆解任务并行干活

Orkas is an open-source (MIT), local-first AI team for your desktop: a Commander tur···

★ 9131 2026-08-09