AgentIndex icon
AgentIndex
ToolsMCP ServersHOTCategoriesTrendingNewBest ListsCompareGuides
Submit Tool
ToolsMCP ServersHOTCategoriesTrendingNewBest ListsCompareGuides
Home/
Code Assistant/
learn-claude-code
learn-claude-code logo

learn-claude-code

Active·★ 80.7k·MIT·Updated 2026-11-15
★ Most Popular★ Trending

learn-claude-code is an open course from shareAI-lab that teaches "harness engineering" by building a small Claude Code–like coding agent from scratch in Python. Its starting premise is that agency comes from the model, while a working agent product is the model plus a harness: the loop, tools, permissions, context management and coordination around it. The course builds that harness one mechanism at a time.

It suits developers who want to understand how coding agents work rather than just use them. The current track has 17 progressive lessons, each adding one mechanism with runnable code: the core agent loop with a single bash tool, adding tools, permission boundaries, hooks, planning with to-do lists, subagents, on-demand skill loading, context compaction, memory, a file-backed task graph, background jobs, scheduling, agent teams, MCP, an integrated runtime, resumable workflows and goal-driven continuation. Lessons have English, Chinese and Japanese text, and a web platform presents the course with source, simulator and architecture views. The course also takes a strong stance against drag-and-drop "agent" builders, which readers may or may not share.

Getting started: clone the repository, `pip install -r requirements.txt`, copy `.env.example` to `.env` with your `ANTHROPIC_API_KEY`, and run `python s01_agent_loop/code.py`. The web version runs with `npm install && npm run dev` in the `web` folder.

This write-up is based on the project's README and public repository data. We have not hand-tested the tool. Data as of 2026-11-07.

License
MIT
Latest release
No GitHub releases
Last commit
2026-10-27
Contributors
62
Forks
12,800
Open issues and PRs
58
First published
2025-06-29

Source: GitHub, npm and PyPI public APIs.

#AI Agents#Claude#Python#Bash Scripting#Agent Skills
$ Install
$ pip install -r requirements.txt
↗ Visit site★ GitHub
01

Features

01Understand the core Agent Loop pattern
02Learn effective Tool Design for AI interaction
03Implement Explicit Planning for predictable AI behavior
04Manage context and memory with Subagent Isolation
05Inject domain expertise on-demand using Skills
02

Why choose it

+Clear, incremental structure: each lesson adds exactly one mechanism with runnable code.
+Covers the full set of modern coding-agent mechanisms, from the basic loop to teams, MCP and goal loops.
+Available in English, Chinese and Japanese, with an interactive web version.
+MIT licensed and very widely followed.
03

Trade-offs

!It is a course, not a production tool; the example agent is meant for learning.
!The current and legacy lesson tracks are numbered differently, which can confuse readers following older links.
!Examples are built around Anthropic's API, so you need an Anthropic API key to run them as written.
05

Maintenance check

ActiveChecked: 2026-11-05
Last commit
2026-10-27
Commits, last 90 days
63
Releases, last 90 days
0
Latest release
—
Open issues
58
Recent issues with at least one comment
4/20
Commits per week, last 12 weeks
Commits per week, last 12 weeks: 8, 10, 0, 0, 0, 0, 2, 0, 0, 0, 13, 0

Oldest week on the left; the latest four weeks are orange. Source: GitHub commit activity.

Status rule: archived on GitHub = Archived; last commit within 90 days = Active; 91 to 365 days = Slowing; older = Stale. All figures come from the GitHub API on the date shown.

Most discussed open issues

  • #290 关于context offloading/compac 上下文卸载/压缩 中的问题10 comments · 2026-05-19
  • #338 感谢大佬的教程,学完后自己做了一个乐高式组装harness的项目,分享出来共同学习4 comments · 2026-06-01
  • #234 s09_agent_teams执行流程疑问4 comments · 2026-04-16
  • #349 建议每节课只展示新代码,旧代码用 import 引用3 comments · 2026-06-05
  • #65 Windows 11 support: changes needed for all agent files3 comments · 2026-03-09

Issue titles are quoted from GitHub. Open the link to check whether a problem still applies to the version you use.

04

Who it fits

Pick it if
  • You want to understand how modern coding agents like Claude Code work under the hood from first principles (from basic bash loop to multi-tool calling).
  • You prefer hands-on, progressive tutorials where each lesson introduces a single mechanism with working, digestible code.
Look elsewhere if
  • You only want a ready-to-use coding assistant for daily dev tasks and do not care about internal mechanics (install official Claude Code or Aider directly).
  • You need an enterprise multi-agent production orchestration framework (CrewAI or MetaGPT are built for direct deployment).
06

How it differs

mini-swe-agent logovs mini-swe-agent★ 9.9k

learn-claude-code is an educational repository explaining agent internals step by step; mini-swe-agent is a compact baseline tuned for SWE-bench performance.

Full comparison →
MetaGPT logovs MetaGPT★ 71.4k

learn-claude-code dissects the core single-agent code-edit loop; MetaGPT simulates a full multi-agent software company with specialized roles.

Full comparison →
07

Compatibility

Claude (Models)
Supported
Verified via docs
Kode CLI
Supported
Verified via docs
Cursor
Supported
Verified via docs
Agent Skills Specification
Native Support
Verified via docs
08

Quick start

1
$ pip install -r requirements.txt
09

Use cases

↳Learning to build modern AI coding agents from scratch
↳Developing custom tools and skills for AI agents
↳Scaffolding new agent projects with varying complexity levels
10

Alternatives

⚡Top VS:
VSmini-swe-agent★9.9k→VSMetaGPT★71.4k→VSClaude-Command-Suite★1.4k→VSOpen Interpreter★68.9k→
mini-swe-agent logo
mini-swe-agent★ 9.9k
The 100 line AI agent that solves GitHub issues or helps you in your command line. Radically simple, no huge configs, no giant monorepo—but scores >74% on SWE-bench verified!
VSCompare→
MetaGPT logo
MetaGPT★ 71.4k
🌟 The Multi-Agent Framework: First AI Software Company, Towards Natural Language Programming
VSCompare→
Claude-Command-Suite logo
Claude-Command-Suite★ 1.4k
Professional slash commands for Claude Code that provide structured workflows for software development tasks including code review, feature creation, security auditing, and architectural analysis.
VSCompare→
Open Interpreter logo
Open Interpreter★ 68.9k
A coding agent for the terminal, optimized for low-cost and open models. Forked from OpenAI's Codex, it can emulate other agent harnesses and runs commands in a native sandbox.
VSCompare→
DeepCode logo
DeepCode★ 16.9k
DeepCode is an open-source coding agent from HKUDS for real software engineering: goal-driven loops, evidence-based verification, durable sessions, and Paper2Code research reproduction.
VSCompare→
PocketFlow-Tutorial-Codebase-Knowledge logo
PocketFlow-Tutorial-Codebase-Knowledge★ 12.8k
Pocket Flow: Codebase to Tutorial
VSCompare→
sleepless-agent logo
sleepless-agent★ 839
🤖 24/7 AI agent that maximizes Claude Code Pro usage via Slack. Auto-processes tasks, manages isolated workspaces, creates Git commits/PRs, and optimizes day/night usage thresholds.
adk-python logo
adk-python★ 22.3k
An open-source, code-first Python toolkit for building, evaluating, and deploying sophisticated AI agents with flexibility and control.
VSCompare→
See all alternatives →

Comments

Log in to leave a comment

No comments yet. Be the first!

On this page
01Features02Why choose it03Trade-offs05Maintenance check04Who it fits06How it differs07Compatibility08Quick start09Use cases10Alternatives
shareAI-lab /
learn-claude-code
↗

Open course: build a Claude Code-like agent from scratch

80.7k13kMIT
Last commit1w ago
StatusActive
CategoryCode Assistant
Contributors62
Links
Documentation↗Discussion↗Issues↗Releases↗
Cloud Infrastructure
Ad

Deploy on DigitalOcean

Host your MCP servers, Docker containers, and AI agents with $200 free credit over 60 days.

Claim $200 Free Credit
© 2026 AgentIndex.app|Built by a 10-year iOS Developer.
Best by use caseAboutContactAdvertisePrivacy PolicyTerms of UseQYSGitHubBuy me a coffee ☕

Browse by Category

MCP ServersCode AssistantWorkflow AutomationRAG / Knowledge BaseMulti-AgentBrowser AutomationLLM InfraDev ToolingObservability

Not affiliated with Anthropic, OpenAI or Microsoft.