Claude Code: Everything You Need to Know

Learn Claude Code in three levels, from your first session to unattended multi-agent runs.

You learn by doing: every core lesson and capstone ends with a check you run in your own practice copy, and every one of them runs step by step in a terminal app beside Claude Code.
Try it now · Pick your level · Every page

Try it now

You need a paid Claude plan (Pro, Max, Team or Enterprise), a Claude Console account, or a supported cloud provider (Quickstart), plus Node.js LTS and git.

1. Make your practice copy: open claude-code-practice, select Use this template > Create a new repository, and clone your copy. Or open your copy in a Codespace, where Node.js and Claude Code come preinstalled.

2. In your copy, start the app:

   npm run learn
   

3. Open a second terminal in the same folder. The app tells you what to type there, starting with installing Claude Code, and checks your work as you go.

The app teaches every core lesson and capstone, at all three levels. It has no AI in it and changes none of your work.

If you prefer to read, every lesson works from its page alone. Each core lesson ends with a check you run from your practice copy, for example npm run check -- b-1: each item prints PASS or FAIL, with a hint for what to fix.

Help that fades as you learn

The help shrinks each time a skill comes back: GUIDED shows every command, HINTED gives the goal and a hint each time you press h, and CHALLENGE gives just the goal.

Beginner lesson 1, steps 1 and 10.

Pick your level

Beginner

For you if you're new to Claude Code and comfortable with a terminal and git.
You'll take one change from request to commit, safely, and give your project a memory. About 2½ hours: 5 lessons, a capstone and 3 Electives.
Start Beginner

Intermediate

Ready if you can plan a change in plan mode, review the diff and commit it, and keep a long session on track.
You'll shape Claude Code to your project with skills, hooks, subagents, MCP and plugins. About 3 hours: 8 lessons, a capstone and 4 Electives.
Start Intermediate

Advanced

Ready if you can write a project skill, enforce a rule with a hook, delegate to a subagent and connect an MCP server.
You'll run Claude Code in parallel, unattended in CI, and for a team, within limits you set. About 4 hours, plus run time: 7 lessons, a capstone and 5 Electives.
Start Advanced

Everything in the guide

Beginner: Level index · Install, sign in and look around · Permission modes and plan mode · Your first change, from request to commit · Keep a session on track · Project memory with CLAUDE.md · Capstone

Beginner Electives: IDE extensions · Screenshots and images · The built-in teachers

Intermediate: Level index · Turn a repeated workflow into a skill · Organize project memory and see what loaded · Pick the model and effort · Permissions, settings scopes and the sandbox · Enforce a rule with a hook · Delegate to a custom subagent · Connect a tool with MCP · Install and manage plugins · Capstone

Intermediate Electives: Skill patterns · Claude in Chrome · The status line · Fast mode

Advanced: Level index · Parallel sessions with worktrees · Choose an orchestration pattern · Run and save a dynamic workflow · Script Claude Code with claude -p · GitHub Actions · Share your setup with a team · Put bounds on autonomous runs · Capstone · Beyond this guide

Advanced Electives: Agent teams · Agent view · /loop and cloud scheduled tasks · Testing and publishing a plugin · Dev containers

Topics: All topics · Permissions and safety · Memory and context · Models, effort and cost · Skills · Hooks · Subagents and parallel work · MCP · Plugins · Automation

Reference: Reference index · Models and effort · Commands by level · Feature map · Further learning · Glossary · Changelog

Examples: How to use the examples

Maintainer configuration: Issue tracker · Triage labels · Domain docs

• Every lesson page carries a Stamp: the Claude Code stable version its claims were checked against, and the date (The stamp).
• The checks are tested too: in the practice template, CI shows every check failing on its main branch, where no exercise is done, and passing on its reference solutions (Assert checks).
• Scheduled checks keep watch between editions: external links and new stable releases weekly, expiry markers daily, and the app's quotes of the lessons weekly. Each opens a tracking issue (Maintainer routine).
• The examples are inert until you copy them into a project, and they follow a safety contract: local only (apart from the MCP lesson's pinned server), least privilege, and a smoke test that runs without Claude.

---

Found something stale? Report it with a source. Stuck on a lesson? Use the link at the bottom of that lesson. Claude Code is a product of Anthropic; this is an independent community guide, not affiliated with or endorsed by Anthropic.

If the guide helped you, a star helps other learners find it.

MIT License · Contributing · Changelog · Security

Mascot: assets/brand/claude-jumping.svg comes from shanraisshan/claude-code-best-practice, Copyright (c) 2025-2026 Shayan Rais, used under the MIT License.

The previous edition's README sections moved:

• SDLC, what LLMs and Claude Code are, setup, install, sign-in and your first prompt: moved to Install, sign in and look around.
• Prompt engineering, explore-plan-code-commit and test-driven work: moved to Your first change, from request to commit.
• Generating a CLAUDE.md: moved to Project memory with CLAUDE.md.
• Visual iteration with screenshots: moved to Give Claude a screenshot.
• The model lineup: moved to Models and effort.
• Effort levels: moved to Pick the model and effort.
• Commands and day-one essentials: moved to Commands by level.
• Custom slash commands and skills: moved to Turn a repeated workflow into a skill.
• The skills reference and skills in a workflow: moved to Turn a repeated workflow into a skill, which shows how to run a skill. The catalog of this repo's own skills and its workflow recipes were removed in edition v2026.10: see the .