# Master Claude Code: The Complete Guide from Beginner to Power User
> **Transform Anthropic's AI coding CLI into your superpower.** 8500+ lines covering installation, agents, MCP servers, hooks, skills, and CI/CD integrationβpresented as a learning journey, not a reference manual.
[](https://creativecommons.org/licenses/by-sa/4.0/)
[](https://github.com/FlorianBruniaux/claude-code-ultimate-guide/stargazers)
[](https://zread.ai/FlorianBruniaux/claude-code-ultimate-guide)
**By [Florian BRUNIAUX](https://github.com/FlorianBruniaux)** | Founding Engineer [@MΓ©thode Aristote](https://methode-aristote.fr) | [Connect on LinkedIn](https://www.linkedin.com/in/florian-bruniaux-43408b83/)
---
## Why This Guide Exists
**The Problem**: Most Claude Code resources are either scattered blog posts or dense reference manuals. You're left piecing together workflows, guessing at best practices, and discovering critical concepts too late.
**Our Solution**: A structured learning journey that takes you from installation to advanced orchestration in hours, not weeksβwith ready-to-use examples you can deploy immediately.
### What Makes This Different
| Traditional Docs | This Guide |
|------------------|------------|
| Lists features | Teaches workflows |
| Reference lookup | Progressive mastery |
| Theoretical concepts | Production-ready patterns |
| "Figure it out" | "Here's exactly how" |
**Your Investment**: 45 minutes to productivity. 2 hours to mastery. 8500+ lines organized by learning path, not alphabetically.
> **If this guide saves you hours of trial-and-error, please star it.** Your support helps others discover this resource and motivates continued updates.
### Prerequisites
- **Node.js 18+** (or use the [shell installer](./english-ultimate-claude-code-guide.md#11-installation) on macOS/Linux)
- **Anthropic API key** β [Get one here](https://console.anthropic.com/)
- **~$5-20/month** typical usage cost (varies with usage intensity)
---
## Start Here: Choose Your Path
### π Quick Start (15 minutes)
**Goal**: Be productive immediately.
```bash
# Install (all platforms)
npm install -g @anthropic-ai/claude-code
# Start coding
cd your-project
claude
```
**Learn**: [Installation Guide](./english-ultimate-claude-code-guide.md#11-installation) β [First Workflow](./english-ultimate-claude-code-guide.md#12-first-workflow) β [Cheat Sheet](./cheatsheet-en.md)
### π§ Not Sure Where to Start?
| If you... | Start here | Time |
|-----------|------------|------|
| Just installed Claude Code | [Quick Start](#-quick-start-15-minutes) | 15 min |
| Want to understand core concepts | [Junior Path](#-by-role-tailored-learning-paths) | 45 min |
| Already use AI coding tools | [Senior Path](#-by-role-tailored-learning-paths) | 40 min |
| Need to configure a team setup | [Power User Path](#-by-role-tailored-learning-paths) | 2h |
| Need to evaluate/approve adoption | [PM Path](#-by-role-tailored-learning-paths) | 20 min |
| Want to check your current setup | [Audit Your Setup](#-audit-your-setup) | 2 sec |
| Want AI assistants to know Claude Code | [LLM Reference](#-llm-reference) | 1 curl |
| Want personalized recommendations | [Deep Audit](#-deep-audit-personalized-recommendations) | 30 sec |
| Want to test your knowledge | [Knowledge Quiz](#-knowledge-quiz) | 10 min |
| Want a guided tour | [Personalized Onboarding](./personalized-onboarding-prompt.md) | ~15 min |
### β‘ Audit Your Setup
Already have Claude Code installed? Scan your configuration in 2 seconds:
```bash
curl -sL https://raw.githubusercontent.com/FlorianBruniaux/claude-code-ultimate-guide/main/examples/scripts/audit-scan.sh | bash
```
**Instant checks**: Config files, tech stack, extensions, security hooks, MCP servers, CLAUDE.md quality
**Want deeper analysis?** Use [`claude-setup-audit-prompt.md`](./claude-setup-audit-prompt.md) for personalized recommendations (~3 min).
### π€ LLM Reference
Give any AI assistant instant Claude Code expertise (~2K tokens):
```bash
curl -sL https://raw.githubusercontent.com/FlorianBruniaux/claude-code-ultimate-guide/main/claude-code-reference.yaml
```
**Use cases**: Paste output into ChatGPT/Claude/Gemini, add to system prompts, or reference in Claude Code with `@claude-code-reference.yaml`
**What's inside**: Decision trees, command reference, context zones, MCP servers, agent templates, troubleshootingβoptimized for machine consumption. Points to line numbers in the [full guide](./english-ultimate-claude-code-guide.md) for deep dives.
### π¬ Deep Audit (Personalized Recommendations)
Get a comprehensive, **context-aware** audit that analyzes your project's README, CLAUDE.md files, and business domain to provide tailored recommendations:
> π **Privacy**: Everything runs locally on your machine. The script only downloads reference files from this repoβyour project files (README, CLAUDE.md) are read locally and sent only to your own Claude CLI. Nothing is sent back to this repository or any third party.
**Quick Version** (~10 sec):
```bash
curl -sL https://raw.githubusercontent.com/FlorianBruniaux/claude-code-ultimate-guide/main/examples/scripts/audit-scan.sh | bash -s -- --json | claude -p "Analyze this Claude Code setup. Give: 1) Health score 0-100 2) Top 3 quick wins 3) CLAUDE.md template for detected stack. Be concise."
```
**Full Audit with Context** (~30 sec, recommended):
```bash
# Claude Code Deep Audit - Context-Aware Version
# Downloads reference files, reads YOUR local files, analyzes with Claude
REF=$(curl -sL https://raw.githubusercontent.com/FlorianBruniaux/claude-code-ultimate-guide/main/claude-code-reference.yaml)
SCAN=$(curl -sL https://raw.githubusercontent.com/FlorianBruniaux/claude-code-ultimate-guide/main/examples/scripts/audit-scan.sh | bash -s -- --json 2>/dev/null)
README_CONTENT=$(head -100 README.md 2>/dev/null || echo "No README.md found")
CLAUDE_MD=$(cat CLAUDE.md 2>/dev/null || echo "No CLAUDE.md found")
LOCAL_CLAUDE_MD=$(cat .claude/CLAUDE.md 2>/dev/null || echo "No .claude/CLAUDE.md found")
claude -p "Reference:
$REF
Scan results:
$SCAN
Project README (first 100 lines):
$README_CONTENT
Project CLAUDE.md:
$CLAUDE_MD
Local .claude/CLAUDE.md:
$LOCAL_CLAUDE_MD
IMPORTANT: Focus on INCREMENTAL improvements to existing setup. Don't suggest creating things that already exist. If CLAUDE.md exists, suggest specific improvements to it rather than a full rewrite.
Based on ALL this context, provide:
1. Stack Recap: runtime, framework, test runner, bundler, database, key integrations detected
2. Health Score (0-100) - be strict: penalize missing SSoT pattern if >100 lines without @refs
3. Findings table: Priority|Element|Status|Action (only gaps, not what exists)
4. Top 3 quick wins (<5 min) - MUST be specific to THIS project's domain (not generic advice)
5. If CLAUDE.md exists: list 3-5 specific improvements (not a full template). If missing: provide ~100 line template
6. Suggested agents/commands/hooks that DON'T duplicate existing ones - check extensions count first
7. Ideas to leverage Claude Code for this specific domain and detected integrations"
```
**What you get**:
- **Stack recap**: Runtime, framework, test runner, bundler, database, and key integrations auto-detected
- Strict health score (penalizes large CLAUDE.md without @refs)
- **Incremental improvements**: Specific fixes for YOUR setup, not generic advice
- Domain-aware suggestions (e.g., EdTech β session planning agents, E-commerce β inventory commands)
- Non-duplicate suggestions: Only recommends agents/commands you don't already have
**Want maximum depth?** Use [claude-setup-audit-prompt.md](./claude-setup-audit-prompt.md) with `claude --ultrathink`
### π§ Knowledge Quiz
Test your Claude Code knowledge with an interactive CLI quiz. **159 curated questions** covering all 10 guide sections, with immediate feedback and documentation links.
```bash
# Quick start
cd quiz && npm install && npm start
# With options
node quiz/src/index.js --profile senior --topics 2,4,7 --count 10
```
Example Session (click to expand)
```
============================================================
CLAUDE CODE KNOWLEDGE QUIZ
============================================================
? Select your profile: Senior Developer (40 min to mastery)
? Select topics to quiz: All topics (recommended)
------------------------------------------------------------
Question 1/20 [Core Concepts]
At what context percentage should you use /compact?
A) 0-50%
B) 50-70%
C) 70-90%
D) Only at 100%
? Your answer: C
β CORRECT!
------------------------------------------------------------
Question 2/20 [Hooks]
What exit code should a PreToolUse hook return to BLOCK an operation?
A) 0
B) 1
C) 2
D) -1
? Your answer: A
β INCORRECT. The correct answer is C) 2
Explanation:
Exit code 2 blocks the operation. Exit code 0 allows it to proceed.
Other exit codes are treated as errors and logged but don't block.
See: english-ultimate-claude-code-guide.md#72-creating-hooks
------------------------------------------------------------
QUIZ COMPLETE
------------------------------------------------------------
Overall Score: 16/20 (80%)
By Category:
Core Concepts 6/7 (86%) [ββββββββββ]
Agents 5/7 (71%) [ββββββββββ]
Hooks 5/6 (83%) [ββββββββββ]
Weak Areas (< 75%):
- Agents: Review section 4 in the guide
? What would you like to do? Retry wrong questions only
```
| **Junior Developer** (45 min to productivity) 1. [Quick Start](./english-ultimate-claude-code-guide.md#1-quick-start-day-1) β Install & first workflow 2. [Essential Commands](./english-ultimate-claude-code-guide.md#13-essential-commands) β The 7 commands 3. [Context Management](./english-ultimate-claude-code-guide.md#22-context-management) β Critical concept 4. [Memory Files](./english-ultimate-claude-code-guide.md#31-memory-files-claudemd) β Your first CLAUDE.md 5. [Cheat Sheet](./cheatsheet-en.md) β Print this | **Senior Developer** (40 min to mastery) 1. [Core Concepts](./english-ultimate-claude-code-guide.md#2-core-concepts) β Mental model 2. [Plan Mode](./english-ultimate-claude-code-guide.md#23-plan-mode) β Safe exploration 3. [Agents](./english-ultimate-claude-code-guide.md#4-agents) β Custom AI personas 4. [Hooks](./english-ultimate-claude-code-guide.md#7-hooks) β Event automation 5. [CI/CD Integration](./english-ultimate-claude-code-guide.md#93-cicd-integration) β Pipelines |
| **Power User** (2 hours for full mastery) 1. [Complete Guide](./english-ultimate-claude-code-guide.md) β End-to-end 2. [MCP Servers](./english-ultimate-claude-code-guide.md#8-mcp-servers) β Extended capabilities 3. [Trinity Pattern](./english-ultimate-claude-code-guide.md#91-the-trinity) β Advanced workflows 4. [Audit](./claude-setup-audit-prompt.md) β Optimize setup 5. [Examples](./examples/) β Production templates | **Product Manager** (20 min overview) 1. [What's Inside](#-complete-toolkit) β Scope 2. [Golden Rules](#-golden-rules) β Key principles 3. [Core Concepts](./english-ultimate-claude-code-guide.md#2-core-concepts) β High-level 4. [Context Management](./english-ultimate-claude-code-guide.md#22-context-management) β Why it matters |