learn-claude-code
Bash is all you need - A nano Claude Code–like agent, built from 0 to 1
A hands-on tutorial that teaches you how to build an AI coding assistant from scratch, step by step, across 12 progressive lessons covering the core agent loop and advanced patterns.
Learn Claude Code is a hands-on tutorial that teaches you how to build an AI coding assistant from scratch. Instead of just using a tool like Claude Code, this project walks you through creating a simplified version of one, step by step, so you understand exactly how it works under the hood.
The core idea is that every AI agent relies on a simple loop: you give the AI a task, it thinks, and if it needs to do something (like run a command or read a file), it uses a tool, gets the result, and loops back to think again. The project builds on this foundation across 12 progressive lessons. You start with a basic agent that can run commands, then layer in new capabilities one at a time — planning, breaking tasks into subtasks, managing context when conversations get too long, running background operations, and eventually coordinating multiple agents that can work together autonomously.
This is built for developers and builders who want to understand the mechanics behind AI coding agents. If you are a founder or PM wondering how tools like Claude Code or Cursor actually function, working through these lessons demystifies the whole process. You would use this to learn the patterns, then apply them to your own projects — or move on to the team's companion tools, which turn these concepts into shipping products.
What stands out is the teaching philosophy: each of the 12 sessions adds exactly one mechanism with a memorable motto, and the core loop never changes. The project is intentionally not a production tool — it omits security permissions, advanced session management, and other complexities. That is a deliberate tradeoff that keeps the focus on understanding the fundamental agent pattern, which the creators describe as giving the AI model tools and then staying out of its way.
The repo also includes a web-based learning platform with interactive visualizations and documentation in three languages. After finishing the 12 sessions, the project points you toward their open-source CLI and SDK for actually shipping agent capabilities in real applications.
Where it fits
- Learn how AI coding agents like Claude Code work under the hood by building one step by step.
- Understand patterns like planning, subtasks, context management, and multi-agent coordination.
- Apply learned agent patterns to your own projects after completing the 12 lessons.
- Transition to the companion open-source CLI and SDK to ship agent capabilities in real apps.