
Learn Claude Code
github.com/shareai-lab/learn-claude-code- Category
- Education
- Rank
- No. 684Tools index
- Pricing
- Open Source
- Type
- TOOL
- Builder
- shareai-lab
- GitHub
- 76.9k stars
- Date
About
A 17-lesson course on harness engineering — the tooling, permissions, context management and task plumbing that surround a model rather than the model itself. Each lesson isolates one mechanism (agent loop, tool dispatch, permission boundaries, task persistence, background execution, agent teams, workflow orchestration, goal evaluation) and ships a standalone Python implementation plus a README in English, Chinese and Japanese. Its argument is that agency comes from model training, so the surrounding code's job is to build the world the model acts in.
What it does
A progressive, runnable course that starts with a basic model and tool loop, then adds planning, isolated workers, persistent task graphs, team messaging, permissions, memory, and external capability routing. Each lesson explains one mechanism with diagrams, code, and prompts to try.
Why it's ranked here
The project earns attention because it exposes concrete mechanics instead of stopping at agent terminology. Its strongest material shows how context isolation, dependency tracking, and asynchronous communication fit around a stable core loop. The opinionated framing is useful, though broader than the supplied implementations prove.
What's good
Lessons isolate one change at a time and explain the problem before showing the mechanism. Path checks demonstrate workspace containment. Subagents discard noisy histories and return summaries. Disk-backed dependency graphs survive context compression. Team examples make lifecycle states and mailbox communication tangible rather than abstract.
Tradeoffs
Two tutorial tracks coexist, and their chapter numbers do not always align. Readers must stay within one track. Several examples use deliberately simple controls: fixed iteration limits, threaded workers, file-based coordination, and mailboxes that empty when read. These choices teach clearly but leave reliability questions beyond the demonstrated scope.
How to use it well
Use it as a hands-on architecture course for developers building model-driven coding tools or similar operational environments. Follow the current lessons in order, run each example, and compare every added mechanism with the unchanged loop. It does not cover training models, and it should not substitute for production hardening guidance.
Technical notes+
README.md identifies root-level s01-s17 as the canonical track and docs/ plus agents/ as the legacy 12-lesson track. requirements.txt declares anthropic>=0.25.0, python-dotenv>=1.0.0, and pyyaml>=6.0. docs/en/s02-tool-use.md implements handler dispatch and resolved-path workspace checks. docs/en/s04-subagent.md gives child agents independent message histories and returns only final text. docs/en/s07-task-system.md persists one JSON file per task and clears dependency edges when tasks complete. docs/en/s09-agent-teams.md runs teammate loops in daemon threads, stores roster state in JSON, and uses drain-on-read JSONL inboxes.
Observed
- Primary language
- Python
- Install surface
- Python dependencies are declared in requirements.txt for installation with standard Python package tooling.
- Model interface
- Uses the Anthropic Python SDK, with a declared minimum dependency of 0.25.0.
- User interface
- Runnable command-line lesson programs accept prompts and expose commands for team and inbox inspection.
- Documentation languages
- English, Chinese, and Japanese documentation are provided.
- Repository structure
- A canonical 17-lesson track coexists with a preserved legacy 12-lesson track.
Read from README.md, requirements.txt, docs/en/s02-tool-use.md, docs/en/s04-subagent.md, docs/ja/s02-tool-use.md, docs/ja/s04-subagent.md, docs/zh/s02-tool-use.md, docs/zh/s04-subagent.md, docs/en/s03-todo-write.md, docs/ja/s03-todo-write.md, docs/zh/s03-todo-write.md, docs/en/s07-task-system.md, docs/en/s09-agent-teams.md, docs/ja/s07-task-system.md, docs/ja/s09-agent-teams.md.
Tags
Tech Stack
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.