Skip to content
Back to search

Claude-Code-Everything-You-Need-to-Know

SkillWorks with Claude CodeGitHub

A practical Claude Code guide with clear mental models and copy-paste examples — setup, prompt engineering, slash commands, skills, hooks, subagents, agent teams, and MCP servers. Beginner path to power-user depth. Featured in Awesome Claude Code.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/wesammustafa/Claude-Code-Quest with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/wesammustafa/Claude-Code-Quest'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/wesammustafa-claude-code-everything-you-need-to-know/badge.svg)](/listings/wesammustafa-claude-code-everything-you-need-to-know)

HTML

<a href="/listings/wesammustafa-claude-code-everything-you-need-to-know"><img src="/api/listings/wesammustafa-claude-code-everything-you-need-to-know/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

curl -fsSL https://claude.ai/install.sh | bash

> This is the recommended native install for macOS, Linux, and WSL, and it updates itself in the background. On Windows, use the PowerShell or CMD command from the [official install guide](https://code.claude.com/docs/en/setup). Alternatives: Homebrew, WinGet, and npm (`npm install -g @anthropic-ai/claude-code`, which [requires Node.js 22+](https://code.claude.com/docs/en/setup#install-with-npm)).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 205 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <a id="claude-code-everything-you-need-to-know-"></a>
  2. <div align="center">
  3. <!-- Rendered on 2026-11-05 from Pip's rig (quest/client/pip/pip.riv) in Claude Code Quest's web runtime: his Greeting, then a look down at the button below. -->
  4. <img src="assets/readme/pip-hello.gif" width="640" alt="Pip, Claude Code Quest's mascot, a small blocky orange robot with two antennas, waves hello under floating pixel crosses, then looks down at the Try it now button below him." />
  5. <a id="claude-code-everything-you-need-to-know"></a>
  6. # Claude Code Quest
  7. **Learn Claude Code by doing it, one small step at a time, with Pip cheering you on.**
  8. <a id="start-in-3-steps"></a>
  9. <a href="#try-it-now"><img src="assets/readme/try-it-now.svg" width="156" height="60" alt="Try it now" /></a>
  10. <sub><a href="#meet-pip">How it works</a> &nbsp;·&nbsp; <a href="#pick-your-level">The three levels</a> &nbsp;·&nbsp; <a href="#everything-in-the-guide">Every page</a></sub>
  11. </div>
  12. <a id="help-that-fades-as-you-learn"></a>
  13. ## Meet Pip
  14. Claude Code Quest opens in your browser, beside your terminal. Read a step, try it in Claude Code, and the app checks your work. When it passes, Pip cheers.
  15. <p align="center">
  16. <!-- Captured on 2026-11-02 from the Claude Code Quest app on its practice stream, against the guide baseline Claude Code v2.1.309 (stable). -->
  17. <img src="assets/readme/pip-step-done.gif" width="640" alt="In Claude Code Quest, the Learner corrects the claim in step 9 of Beginner lesson 1: the step's check passes, its progress dash turns green, Pip, a small blocky robot with two antennas, throws his arms up with sparks around him, and his speech bubble says That step is done." />
  18. <br />
  19. <sub><b>Do a step, and when it passes, Pip cheers with you.</b></sub>
  20. </p>
  21. Miss one, and he encourages you to try again. The help fades as you get the hang of each skill, from every command, to hints, to only the goal, until you do it on your own.
  22. <a id="install"></a>
  23. ## Try it now
  24. You need a Claude subscription (Pro, Max, Ultra, Team or Enterprise), a Claude Console account, or access through a supported cloud provider ([Quickstart](https://code.claude.com/docs/en/quickstart)), plus Node.js LTS and git.
  25. 1. **Make your practice copy.** Open [claude-code-practice](https://github.com/wesammustafa/claude-code-practice), select **Use this template** > **Create a new repository**, and clone your copy. Or open your copy in a Codespace.
  26. 2. **Start the app** in your copy:
  27. ```bash
  28. npm run learn
  29. ```
  30. 3. **Keep a terminal beside it.** Claude Code Quest opens in your browser (in a Codespace, open the address it prints). It tells you what to type in the terminal and checks each step.
  31. Claude Code Quest has no AI in it and changes none of your work. Prefer to read? Every lesson works from its page alone.
  32. <a id="already-have-a-practice-copy"></a>
  33. <details>
  34. <summary>Already have a practice copy?</summary>
  35. If you made your copy before the app moved to the browser, run these in your copy's folder, in a terminal or in PowerShell. The fetch saves the template's latest version as [`FETCH_HEAD`](https://git-scm.com/docs/git-fetch), and [`--no-overlay`](https://git-scm.com/docs/git-checkout) replaces `checks/`, `capstone/` and `learn/` as wholes:
  36. ```shell
  37. git fetch https://github.com/wesammustafa/claude-code-practice main
  38. git checkout --no-overlay FETCH_HEAD -- checks capstone learn
  39. git checkout FETCH_HEAD -- .github/workflows/progress.yml .gitattributes
  40. node checks/upgrade.mjs
  41. ```
  42. The template's `progress.yml` workflow and `.gitattributes` replace yours. Your work moves into `project/`, with every file's contents kept (an untracked file left in `checks/`, `capstone/` or `learn/` moves to `.practice/upgrade-kept/`), and your saved progress stays where it is, so `npm run learn` opens where you left off. Run checks from `project/` now: `cd project`, then `npm run check -- b-1`. Review the change with `git status`, then commit it.
  43. </details>
  44. <a id="-choose-your-path"></a>
  45. ## Pick your level
  46. Three levels take you from your first session to a setup your team shares. Start where you are and climb: every core lesson earns a Badge, and each level ends with a capstone that puts it all together. Not sure where you fit? Each level page opens with a "You're ready for this level if you can" list.
  47. <!-- Pip's three portraits were rendered on 2026-11-05 from his rig (quest/client/pip/pip.riv) in Claude Code Quest's web runtime: Curious, Explaining and Success. -->
  48. <img src="assets/readme/pip-curious.png" align="left" width="88" height="88" alt="Pip tilts his head under a pixel question mark, curious." />
  49. ### Beginner
  50. **Start here if** you're new to Claude Code.<br clear="left" />
  51. **You'll learn to** start Claude Code safely, plan before it changes things, take one change from request to commit, and give your project a memory.\
  52. **You'll finish by** fixing a reported bug, from plan to commit.\
  53. **Badges:** Explorer&nbsp;· Planner&nbsp;· Builder&nbsp;· Navigator&nbsp;· Keeper&nbsp;· Beginner\
  54. <sub>5 lessons&nbsp;· a capstone&nbsp;· 3 Electives&nbsp;· about 2½ hours</sub>\
  55. **[Start Beginner](docs/beginner/README.md)**
  56. <img src="assets/readme/pip-explaining.png" align="left" width="88" height="88" alt="Pip points a little stick at the Intermediate level, explaining." />
  57. ### Intermediate
  58. **Start here if** you can do what Beginner teaches.<br clear="left" />
  59. **You'll learn to** shape Claude Code to your own project with skills, memory, permissions, hooks, subagents, MCP servers and plugins.\
  60. **You'll finish by** getting a repository ready for a new teammate.\
  61. **Badges:** Crafter&nbsp;· Organizer&nbsp;· Tuner&nbsp;· Guardian&nbsp;· Enforcer&nbsp;· Delegator&nbsp;· Connector&nbsp;· Curator&nbsp;· Intermediate\
  62. <sub>8 lessons&nbsp;· a capstone&nbsp;· 4 Electives&nbsp;· about 4 hours</sub>\
  63. **[Start Intermediate](docs/intermediate/README.md)**
  64. <img src="assets/readme/pip-success.png" align="left" width="88" height="88" alt="Pip throws both arms up in a burst of sparks." />
  65. ### Advanced
  66. **Start here if** you can do what Intermediate teaches.<br clear="left" />
  67. **You'll learn to** run sessions in parallel, run Claude Code unattended in scripts and CI, share a setup with your team, and keep autonomous runs within limits you set.\
  68. **You'll finish by** adding CI review your team can share.\
  69. **Badges:** Brancher&nbsp;· Strategist&nbsp;· Orchestrator&nbsp;· Scripter&nbsp;· Automator&nbsp;· Steward&nbsp;· Warden&nbsp;· Advanced\
  70. <sub>7 lessons&nbsp;· a capstone&nbsp;· 5 Electives&nbsp;· about 4 hours, plus run time</sub>\
  71. **[Start Advanced](docs/advanced/README.md)**
  72. <p align="center">
  73. <!-- Captured on 2026-11-02 from the Claude Code Quest app on its practice stream, against the guide baseline Claude Code v2.1.309 (stable); trimmed and re-encoded on 2026-11-05. -->
  74. <img src="assets/readme/pip-level-done.gif" width="320" alt="On Beginner level complete, Pip throws his arms up in a burst of sparks above the level's six badges and the Start the Intermediate level button." />
  75. <br />
  76. <sub><b>Finish a level, and Pip throws a party.</b></sub>
  77. </p>
  78. <a id="-whats-inside"></a><a id="-reading-tips"></a>
  79. ## Everything in the guide
  80. <details>
  81. <summary>Every page, by level</summary>
  82. **Beginner:** [Level index](docs/beginner/README.md) · [Install, sign in and look around](docs/beginner/01-install-and-look-around.md) · [Permission modes and plan mode](docs/beginner/02-permission-modes-and-plan-mode.md) · [Your first change, from request to commit](docs/beginner/03-first-change.md) · [Keep a session on track](docs/beginner/04-keep-a-session-on-track.md) · [Project memory with CLAUDE.md](docs/beginner/05-project-memory.md) · [Capstone](docs/beginner/capstone.md)
  83. **Beginner Electives:** [IDE extensions](docs/beginner/electives/ide-extensions.md) · [Screenshots and images](docs/beginner/electives/screenshots-and-images.md) · [The built-in teachers](docs/beginner/electives/built-in-teachers.md)
  84. **Intermediate:** [Level index](docs/intermediate/README.md) · [Turn a repeated workflow into a skill](docs/intermediate/01-first-skill.md) · [Organize project memory and see what loaded](docs/intermediate/02-organize-memory.md) · [Pick the model and effort](docs/intermediate/03-model-and-effort.md) · [Permissions, settings scopes and the sandbox](docs/intermediate/04-permissions-and-sandbox.md) · [Enforce a rule with a hook](docs/intermediate/05-hooks.md) · [Delegate to a custom subagent](docs/intermediate/06-subagents.md) · [Connect a tool with MCP](docs/intermediate/07-mcp.md) · [Install and manage plugins](docs/intermediate/08-plugins.md) · [Capstone](docs/intermediate/capstone.md)
  85. **Intermediate Electives:** [Skill patterns](docs/intermediate/electives/skill-patterns.md) · [Claude in Chrome](docs/intermediate/electives/claude-in-chrome.md) · [The status line](docs/intermediate/electives/status-line.md) · [Fast mode](docs/intermediate/electives/fast-mode.md)
  86. **Advanced:** [Level index](docs/advanced/README.md) · [Parallel sessions with worktrees](docs/advanced/01-parallel-sessions.md) · [Choose an orchestration pattern](docs/advanced/02-orchestration-patterns.md) · [Run and save a dynamic workflow](docs/advanced/03-dynamic-workflows.md) · [Script Claude Code with `claude -p`](docs/advanced/04-headless.md) · [GitHub Actions](docs/advanced/05-github-actions.md) · [Share your setup with a team](docs/advanced/06-share-your-setup.md) · [Put bounds on autonomous runs](docs/advanced/07-bounded-runs.md) · [Capstone](docs/advanced/capstone.md) · [Beyond this guide](docs/advanced/beyond-this-guide.md)
  87. **Advanced Electives:** [Agent teams](docs/advanced/electives/agent-teams.md) · [Agent view](docs/advanced/electives/agent-view.md) · [`/loop` and cloud scheduled tasks](docs/advanced/electives/goal-loop-routines.md) · [Testing and publishing a plugin](docs/advanced/electives/publish-a-plugin.md) · [Dev containers](docs/advanced/electives/dev-containers.md)
  88. **Topics:** [All topics](docs/topics/README.md) · [Permissions and safety](docs/topics/permissions-and-safety.md) · [Memory and context](docs/topics/memory-and-context.md) · [Models, effort and cost](docs/topics/models-effort-and-cost.md) · [Skills](docs/topics/skills.md) · [Hooks](docs/topics/hooks.md) · [Subagents and parallel work](docs/topics/subagents-and-parallel-work.md) · [MCP](docs/topics/mcp.md) · [Plugins](docs/topics/plugins.md) · [Automation](docs/topics/automation.md)
  89. **Reference:** [Reference index](docs/reference/README.md) · [Models and effort](docs/reference/models.md) · [Commands by level](docs/reference/commands.md) · [Feature map](docs/reference/feature-map.md) · [Further learning](docs/reference/further-reading.md) · [Glossary](docs/reference/glossary.md) · [Changelog](docs/reference/changelog.md)
  90. **Examples:** [How to use the examples](examples/README.md)
  91. </details>
  92. <a id="how-the-guide-stays-current"></a>
  93. [![Verified against Claude Code v2.1.308 (stable)](https://img.shields.io/badge/verified-v2.1.308_stable-2e6e57)](CHANGELOG.md#v202612---2026-11-01) [![Edition release date](https://img.shields.io/github/release-date/wesammustafa/Claude-Code-Quest?label=edition&color=2e6e57)](https://github.com/wesammustafa/Claude-Code-Quest/releases/latest) [![License: PolyForm Noncommercial 1.0.0](https://img.shields.io/badge/license-PolyForm_Noncommercial_1.0.0-5b6470)](LICENSE) [![Mentioned in Awesome Claude Code](https://awesome.re/mentioned-badge.svg)](https://github.com/hesreallyhim/awesome-claude-code)
  94. <details>
  95. <summary>How the guide stays current</summary>
  96. - Every lesson page carries a Stamp: the Claude Code `stable` version its claims were checked against, and the date ([The stamp](CONTRIBUTING.md#the-stamp)).
  97. - The checks are tested too: CI builds a fresh practice copy from this repo and shows every check failing on it and passing after a full replay of the lessons ([Guide checks](.github/workflows/checks.yml)).
  98. - Scheduled checks keep watch between editions: external links and new `stable` releases weekly, and expiry markers daily. Each opens a tracking issue ([Maintainer routine](CONTRIBUTING.md#maintainer-routine)).
  99. - The examples are inert until you copy them into a project, and they follow a [safety contract](CONTRIBUTING.md#adding-a-skill): local only (apart from the MCP lesson's pinned server), least privilege, and a smoke test that runs without Claude.
  100. </details>
  101. ---
  102. <div align="center">
  103. <!-- Rendered on 2026-11-05 from Pip's rig (quest/client/pip/pip.riv) in Claude Code Quest's web runtime: his Sleep mode. -->
  104. <img src="assets/readme/pip-asleep.gif" width="200" alt="Pip dozes, slumped low, his eyelids drooping halfway now and then while a small pixel z and then a big Z drift up above his head." />
  105. <sub>Leave Pip be for a few minutes and he dozes off. He's up the moment you're back.</sub>
  106. Found something stale? [Report it with a source](https://github.com/wesammustafa/Claude-Code-Quest/issues/new?template=stale-content.yml). Stuck on a lesson? Use the link at the bottom of that lesson.
  107. **If Claude Code Quest helped you, a star helps other learners find it.**
  108. [PolyForm Noncommercial License 1.0.0](LICENSE) · [Contributing](CONTRIBUTING.md) · [Changelog](CHANGELOG.md) · [Security](SECURITY.md)
  109. <sub>Independent community guide, not affiliated with or endorsed by Anthropic.</sub>
  110. </div>
  111. <a id="links-from-the-previous-edition"></a><a id="sdlc"></a><a id="what-are-llms-and-how-do-they-differ-from-ai-tools-like-claude-code"></a><a id="what-is-claude-code"></a><a id="claude-code-setup"></a><a id="1-install"></a><a id="2-authenticate"></a><a id="3-run-your-first-prompt"></a><a id="prompt-engineering-deep-dive"></a><a id="1-explore--plan--code--commit"></a><a id="2-test-driven-workflow-write-tests--code--commit"></a><a id="4-optional-generate-a-claudemd"></a><a id="3-visual-iteration-code--screenshot--iterate--commit"></a><a id="claude-opus-46-the-latest-powerhouse"></a><a id="claude-opus-47-the-latest-flagship"></a><a id="the-claude-5-era-todays-model-lineup"></a><a id="effort-levels"></a><a id="4-effort-levels--how-hard-claude-thinks"></a><a id="claude-commands"></a><a id="built-in-slash-commands"></a><a id="day-1-essentials"></a><a id="custom-slash-commands"></a><a id="claude-skills"></a><a id="your-first-skill-in-3-minutes"></a><a id="want-more-depth"></a><a id="what-are-skills"></a><a id="built-in-vs-custom-skills"></a><a id="skills-faq"></a><a id="creating-custom-skills"></a><a id="available-skills-reference"></a><a id="using-skills-in-workflow"></a><a id="troubleshooting-skills"></a><a id="skills-best-practices"></a><a id="hooks"></a><a id="setting-up-claude-hooks"></a><a id="setting-up-hooks"></a><a id="hook-events"></a><a id="hook-input"></a><a id="hook-output"></a><a id="security-considerations"></a><a id="hook-execution-details-and-debugging"></a><a id="execution--debugging"></a><a id="2-general-purpose-subagents--when-one-claude-isnt-enough"></a><a id="3-specialized-subagents--drop-in-role-prompts"></a><a id="ai-agents"></a><a id="running-agents-in-parallel"></a><a id="subagents--running-agents-in-parallel"></a><a id="orchestrating-specialists-from-the-main-session"></a><a id="1-git-worktrees--parallel-branches-parallel-sessions"></a><a id="agent-teams-experimental---2026"></a><a id="agent-teams-experimental"></a><a id="enable-it"></a><a id="the-example-that-justifies-the-cost"></a><a id="staff-a-team-with-the-role-prompts-you-already-have"></a><a id="three-things-that-catch-people-out"></a><a id="monitoring-and-the-naming-trap"></a><a id="best-practices"></a><a id="dynamic-workflows"></a><a id="try-it-in-2-minutes--no-script-required"></a><a id="starting-your-own"></a><a id="beyond-one-terminal--the-2026-automation-surface"></a><a id="model-context-protocol-mcp"></a><a id="the-nm-problem-mcp-solves"></a><a id="three-pillars"></a><a id="the-mcp-registry--self-discovering-agents"></a><a id="the-mcp-ecosystem-today"></a><a id="fast-mode"></a><a id="fast-mode-"></a><a id="beyond-your-own-skills--the-ecosystem"></a><a id="featured-mcp-servers"></a><a id="more-mcp-servers-worth-knowing"></a><a id="super-claude-framework"></a><a id="the-bmad-method--ai-agent-framework"></a><a id="updates--deprecations-february-2026"></a><a id="updates--deprecations"></a><a id="updates--deprecations-as-of-july-2026"></a><a id="faq"></a><a id="references"></a><a id="steal-this-setup"></a><a id="5-bonus-steal-this-repos-setup"></a><a id="-when-to-use-what"></a>
  112. <details>
  113. <summary>Followed a link from an earlier edition?</summary>
  114. The previous edition's README sections moved:
  115. - **SDLC, what LLMs and Claude Code are, setup, install, sign-in and your first prompt:** moved to [Install, sign in and look around](docs/beginner/01-install-and-look-around.md).
  116. - **Prompt engineering, explore-plan-code-commit and test-driven work:** moved to [Your first change, from request to commit](docs/beginner/03-first-change.md).
  117. - **Generating a CLAUDE.md:** moved to [Project memory with CLAUDE.md](docs/beginner/05-project-memory.md).
  118. - **Visual iteration with screenshots:** moved to [Give Claude a screenshot](docs/beginner/electives/screenshots-and-images.md).
  119. - **The model lineup:** moved to [Models and effort](docs/reference/models.md).
  120. - **Effort levels:** moved to [Pick the model and effort](docs/intermediate/03-model-and-effort.md).
  121. - **Commands and day-one essentials:** moved to [Commands by level](docs/reference/commands.md).
  122. - **Custom slash commands and skills:** moved to [Turn a repeated workflow into a skill](docs/intermediate/01-first-skill.md).
  123. - **The skills reference and skills in a workflow:** moved to [Turn a repeated workflow into a skill](docs/intermediate/01-first-skill.md), 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 [CHANGELOG](CHANGELOG.md#removed-live-config).
  124. - **Skills troubleshooting and best practices:** moved to [Skill patterns](docs/intermediate/electives/skill-patterns.md).
  125. - **Hooks:** moved to [Enforce a rule with a hook](docs/intermediate/05-hooks.md).
  126. - **General-purpose and specialized subagents:** moved to [Delegate to a custom subagent](docs/intermediate/06-subagents.md). The drop-in role prompts were removed in edition v2026.10: see the [CHANGELOG](CHANGELOG.md#removed-listings).
  127. - **AI agents and running agents in parallel:** moved to [Choose an orchestration pattern](docs/advanced/02-orchestration-patterns.md).
  128. - **Git worktrees:** moved to [Parallel sessions with worktrees](docs/advanced/01-parallel-sessions.md).
  129. - **Agent teams:** moved to [Agent teams](docs/advanced/electives/agent-teams.md).
  130. - **Dynamic workflows:** moved to [Run and save a dynamic workflow](docs/advanced/03-dynamic-workflows.md).
  131. - **The automation surface:** moved to [Feature map](docs/reference/feature-map.md).
  132. - **Model Context Protocol (MCP):** moved to [Connect a tool with MCP](docs/intermediate/07-mcp.md).
  133. - **Fast mode:** moved to [Fast mode](docs/intermediate/electives/fast-mode.md).
  134. - **The skills ecosystem:** moved to [Install and manage plugins](docs/intermediate/08-plugins.md). The skills ecosystem catalog was removed in edition v2026.10: see the [CHANGELOG](CHANGELOG.md#removed-listings).
  135. - **MCP server lists:** moved to [Connect a tool with MCP](docs/intermediate/07-mcp.md). The MCP server tables were removed in edition v2026.10: see the [CHANGELOG](CHANGELOG.md#removed-listings).
  136. - **Super Claude and the BMAD method:** removed in edition v2026.10: listings no lesson uses. See the [CHANGELOG](CHANGELOG.md#removed-listings).
  137. - **Updates and deprecations:** removed in edition v2026.10: the guide's summaries of Claude Code releases. See the [CHANGELOG](CHANGELOG.md#removed-changelog-mirror).
  138. - **FAQ:** moved to [FAQ](docs/reference/faq.md), which says where each answer went.
  139. - **References:** moved to [Further learning](docs/reference/further-reading.md).
  140. - **Steal this setup:** moved to [Share your setup with a team](docs/advanced/06-share-your-setup.md).
  141. - **When to use what:** moved to [When to use what](docs/intermediate/README.md#when-to-use-what).
  142. </details>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.