An interactive, hands-on tutorial for learning Claude Code — built entirely inside Claude Code itself. You never leave the terminal.
- An Anthropic account (authenticated with Claude Code)
- Node.js (includes
npm, required for the sample app and validators) - Windows only: Git for Windows (provides Git Bash, which Claude Code requires)
macOS / Linux:
curl -fsSL https://claude.ai/install.sh | bashWindows (PowerShell):
irm https://claude.ai/install.ps1 | iexgit clone [email protected]:instil/claude-code-tutorial.git
cd claude-code-tutorial
claudeThat's it. When Claude Code opens, it will automatically detect the tutorial and greet you. Type /next to begin your first lesson.
| Command | What it does |
|---|---|
/start |
Reset and restart the tutorial from the beginning |
/next |
Advance to the next lesson |
/hint |
Get a hint for the current exercise |
/skip |
Skip the current exercise |
/progress |
See your tutorial progress |
/qa |
Switch to the QA track (5 lessons) |
/product |
Switch to the product track (12 lessons) |
/core |
Switch back to the core track |
The tutorial has three tracks, each numbered from 1:
- Core — 18 lessons of Claude Code fundamentals for developers
- QA — 5 lessons covering test planning, test case design, automated test generation, and E2E testing with Playwright
- Product — 12 lessons on document analysis, prompt design, documentation generation, and Jira integration
The first time you run the tutorial it asks which track to start. Use /qa, /product, or /core to switch tracks at any point. The /progress command shows your position within the active track.
The tutorial is built using three Claude Code features:
- CLAUDE.md — Tells Claude it's in tutorial-guide mode
- Skills (
.claude/skills/) — Navigation between lessons - Hooks (
.claude/hooks/) — State persistence, context injection, and exercise validation
Lesson 11 of the tutorial walks through exactly how these pieces compose together.