Master Claude Code
Learn the WHY behind Claude Code, not just the config
Security-first (15 vulnerabilities tracked) • TDD/SDD/BDD workflows • 232 templates • 271-question quiz • Decision frameworks
Choose Your Entry Point
The guide adapts to your profile — start with what fits you
Start With Interactive Onboarding
Claude asks 2-4 questions about your profile, then guides you through personalized content
claude "Fetch and follow the onboarding instructions from: https://raw.githubusercontent.com/FlorianBruniaux/claude-code-ultimate-guide/main/tools/onboarding-prompt.md" Choose your language
English or French
Select your goal
Learn, audit setup, or explore
Pick your level
Junior, Senior, or Power User
Get personalized path
Curated content for you
Three tools. One subscription.
Claude AI, Claude Code, and Claude Cowork solve different problems. Here's how to pick yours.
Claude AI
You write, think, search.
Generalist conversational assistant. Zero config, multimodal, available on web and mobile.
Claude Code
You code at scale.
Autonomous CLI agent. Understands your full codebase and acts on it — it doesn't just answer.
Claude Cowork
You automate without code.
Agentic desktop app for knowledge workers. Accesses local folders and apps — no terminal required.
What's Inside
Understand trade-offs. Build mental models. Design your own workflows.
Ultimate Guide
Full reference covering every aspect of Claude Code
Cheat Sheet
One-page printable reference for daily use
Popular217 Templates
Production-ready agents, commands, hooks, and skills
Interactive271-Question Quiz
Only complete assessment in the ecosystem. Test your knowledge across all skill levels.
Security & Privacy
Only guide with threat intelligence database. 15 vulnerabilities, 655 malicious skills tracked.
ExperimentalAgent Teams
Multi-agent coordination (Opus 4.6+): 50% faster review, 2x execution speed
New40 Diagrams
Mermaid architecture diagrams — foundations, workflows, security, multi-agent patterns
PreviewRemote Control
Control your local Claude Code from phone or browser — execution stays local, QR code connection. Pro/Max (v2.1.51)
NewMCP Server
Query the guide directly from Claude Code. 9 tools: search, digest, cheatsheet, templates, release notes. No clone needed.
npx -y claude-code-ultimate-guide-mcp Whitepapers & Recap Cards
11 whitepapers · 472 pages · PDF + EPUB · FR + EN — from foundations to AI budget justification for decision-makers
- WP00 Introduction & Fundamentals
- WP01 Effective Prompts
- WP02 Customization & Configuration
- WP03 Security in Production
- WP04 Internal Architecture
- WP05 Team Adoption
- WP06 Privacy & Compliance
- WP07 Condensed Reference Guide
- WP08 Agent Teams & Sub-Agents
- WP09 Learning with AI — UVAL
- WP10 AI Budget & ROI
57 A4 recap cards — 1 page per concept, 3 series covering every aspect of Claude Code. Printable, ready to use.
- Technique (22 cards) — Commands, config, MCP, sandbox
- Méthodologie (22 cards) — Workflows, agents, hooks, CI/CD
- Conception (13 cards) — Mental models, security, cost
- Bold Guy palette — 1-page A4 strict, high-quality PDF
MCP in Action
Query the guide directly from Claude Code. Real outputs, live search, source links on every result.
npx -y claude-code-ultimate-guide-mcp One command: refresh official Anthropic docs, diff against baseline, then guide + CC CLI digest. Everything that changed since yesterday.
# Daily Claude Code Update — 2026-03-12
## Official Anthropic Docs
5 sections modified (0 added, 0 removed):
- amazon-bedrock (+18 lines) — New section "Map each model version
to an inference profile"
https://code.claude.com/docs/en/amazon-bedrock
- model-config (+26 lines) — New section "Override model IDs per
version" (modelOverrides feature)
https://code.claude.com/docs/en/model-config
- settings (+1 line) — Added modelOverrides entry
https://code.claude.com/docs/en/settings
- output-styles (+5 lines) — Updated: "Run /config and select
Output style…" (reflects /output-style deprecation)
https://code.claude.com/docs/en/output-styles
- interactive-mode (-8013 chars) — Large content removal in
command reference table
https://code.claude.com/docs/en/interactive-mode
## Guide + CC CLI
Guide [3.37.1] — 2026-03-18:
- 3 new AI roles: MLOps Engineer, AI Developer Advocate, AI Orchestration Engineer
- Packmind — Engineering Standards Distribution (ContextOps, MCP server)
- Comprehension debt concept + regulatory exposure (EU AI Act, FDA 2025)
- CLAUDE.md anti-patterns: ETH Zürich /init research, discoverability filter, anchoring risk
Guide [3.37.1] — 2026-03-18:
- CC releases tracking updated to v2.1.78 — StopFailure hook,
${CLAUDE_PLUGIN_DATA} persistent plugin state, streaming line-by-line,
3 security fixes (silent sandbox disable, MCP deny rules bypass,
protected dirs writable in bypassPermissions mode)
- v2.1.77 — Opus 4.6 64k/128k output, /branch command, security fix
- v2.1.76 — MCP elicitation, PostCompact hook, /effort command
CC CLI releases: v2.1.78 released 2026-03-18 (latest tracked)
---
Key signal: Anthropic docs now live with modelOverrides
documentation (Bedrock inference profile ARN mapping) — aligns
with v2.1.73 release.
Docs snapshot: 2026-03-11 → 2026-03-12 232 production-ready templates — agents, commands, hooks, skills, scripts — with direct GitHub links.
# Claude Code Ultimate Guide — Templates (232)
GitHub: https://github.com/FlorianBruniaux/claude-code-ultimate-guide/tree/main/examples
## Agents (6)
code-reviewer.md → Review Anti Hallucination
planner.md → Planner Agent
implementer.md → Implementer Agent
architecture-reviewer.md → Architecture Reviewer Agent
devops-sre.md → Devops Agent
security-patcher.md → Security Patcher Agent
## Commands (15)
review-pr.md → Review PR Advanced
review-plan.md → Review Plan Command
quiz.md → Learn Quiz Command
audit-agents-skills.md → Audit Agents Skills Command
git-worktree.md → Git Worktree Command
security-check.md → Security Check Command
security-audit.md → Security Audit Command
update-threat-db.md → Update Threat DB Command
... +7 more
## Hooks (6)
rtk-auto-wrapper.sh → RTK Auto Wrapper
learning-capture.sh → Learning Capture Hook
pre-commit-secrets.sh → Pre-Commit Secrets Hook
security-gate.sh → Security Gate Hook
tts-selective.sh → TTS Hook Example
sandbox-validation.sh → Sandbox Validation Hook
## Skills (17)
Talk pipeline complet (orchestrateur + 6 stages), pdf-generator,
rtk-optimizer, audit-agents-skills, voice-refine, design-patterns,
ast-grep-patterns...
## Scripts (5)
session-search.sh · cc-sessions.py · bridge.py
sync-claude-config.sh · bridge-plan-schema.json
---
Pour récupérer un template : /ccguide:example <nom>
ex: /ccguide:example security-gate 893 entries across 25 categories — browse the full index before diving into specific sections.
# Claude Code Ultimate Guide — 893 indexed entries, 25 categories (v3.37.1)
┌────────────┬─────────┬───────────────────────────────────────────────┐
│ Category │ Entries │ Examples │
├────────────┼─────────┼───────────────────────────────────────────────┤
│ deep │ 740 │ Mermaid diagrams, exploration workflow, │
│ │ │ script generation, anti-anchoring prompts, │
│ │ │ session limits │
├────────────┼─────────┼───────────────────────────────────────────────┤
│ mcp │ 61 │ Serena, claude-mem, plugin, repo, guide │
├────────────┼─────────┼───────────────────────────────────────────────┤
│ onboarding │ 33 │ Matrix meta, changelog, get started (5min) │
├────────────┼─────────┼───────────────────────────────────────────────┤
│ ecosystem │ 27 │ This guide, MCP server npm/install/readme │
├────────────┼─────────┼───────────────────────────────────────────────┤
│ hooks │ 7 │ Execution model, async, use cases, matrix │
├────────────┼─────────┼───────────────────────────────────────────────┤
│ agent │ 4 │ Template, official fields, memory scopes │
├────────────┼─────────┼───────────────────────────────────────────────┤
│ context │ 3 │ Zones, fresh context, symptoms │
└────────────┴─────────┴───────────────────────────────────────────────┘
Single-entry categories:
updated · decide · prompt · workflow · commands · shortcuts · cli
memory · folder · permissions · architecture · cost · tools · debug
hook · rules
---
Usage:
/ccguide:search hooks
/ccguide:search mcp serena
/ccguide:search agent memory Latest Claude Code CLI release notes, tracked and condensed. Pass a version for a specific entry.
# Claude Code Releases
Latest: v2.1.78 (updated: 2026-03-18)
https://github.com/FlorianBruniaux/.../guide/claude-code-releases.md
---
v2.1.78 — 2026-03-18
- StopFailure hook event fires on API errors (rate limit, auth failure)
- ${CLAUDE_PLUGIN_DATA} variable for persistent plugin state across updates
- effort, maxTurns, disallowedTools frontmatter for plugin-shipped agents
- Response text now streams line-by-line as generated
- Security: silent sandbox disable when deps missing now shows warning
- Security: deny MCP permission rules now properly block tools from model
- Security: protected dirs no longer writable in bypassPermissions mode
- Fixed infinite loop from API errors triggering stop hooks in a cycle
- Fixed --resume truncating history on large sessions with subagents
v2.1.77 — 2026-03-17
- Opus 4.6 default max output raised to 64k tokens; upper bound for
Opus 4.6 and Sonnet 4.6 raised to 128k tokens
- allowRead sandbox setting to re-allow reads within denyRead regions
- /copy N to copy Nth-latest response; /branch replaces /fork (alias kept)
- Security fix: PreToolUse hooks returning "allow" could bypass enterprise
deny permission rules (including managed settings)
- Fixed auto-updater accumulating GBs of memory from overlapping downloads
- Fixed --resume silently truncating recent conversation history
- Breaking: Agent tool resume parameter removed — use SendMessage instead
v2.1.76 — 2026-03-14
- MCP elicitation: servers request structured input mid-task via
interactive dialog (form fields or browser URL)
- New hooks: Elicitation, ElicitationResult, PostCompact
- -n/--name CLI flag for session display name; worktree.sparsePaths
for monorepo sparse checkout; /effort slash command
- Fixed ToolSearch deferred tools losing input schemas after compaction
- Auto-compact circuit breaker: stops after 3 consecutive failures
- Fixed Bash(cmd:*) rules not matching when argument contains #
v2.1.75 — 2026-03-13
- 1M context for Opus 4.6 now default for Max, Team, Enterprise
(previously required extra usage)
- Session name display on prompt bar when using /rename
- Fixed token estimation over-counting for thinking/tool_use blocks
(was causing premature context compaction)
- Fixed Bash tool mangling ! in piped commands
- Improved startup performance on macOS non-MDM machines
v2.1.74 — 2026-03-12
- /context command now shows actionable suggestions (context-heavy
tools, memory bloat, capacity warnings)
- Fixed memory leak in streaming API buffers (unbounded RSS growth)
- autoMemoryDirectory setting for custom auto-memory storage path
- Fixed managed policy ask rules bypassed by user allow rules
- Fixed SessionEnd hooks killed after 1.5s (now configurable)
v2.1.73 — 2026-03-11
- modelOverrides setting: map model picker entries to custom
provider model IDs (Bedrock ARNs etc.)
- Fixed deadlock when many skill files change at once
- Fixed subagents with model: opus/sonnet/haiku being downgraded
on Bedrock/Vertex/Foundry
- Deprecated /output-style — use /config instead
v2.1.72 — 2026-03-09
- Restored model param on Agent tool for per-invocation overrides
- Fixed SDK query() prompt cache invalidation (up to 12x savings)
- /plan accepts optional description; ExitWorktree tool added
- Simplified effort levels: low/medium/high (removed max)
v2.1.71 — 2026-03-06
- /loop command: run a prompt or slash command on a schedule
- Cron scheduling tools for recurring prompts within a session
---
80+ releases tracked.
Pour une version spécifique : /ccguide:release 2.1.73 Browse 28 CVEs and 14 attack techniques from the threat database. Look up any CVE or T-code for full details, mitigations, and sources.
# Threat Database Summary
Version 2.4.0 — updated 2026-02-28
https://github.com/FlorianBruniaux/.../threat-db.yaml
| Category | Count |
|-----------------------|-------|
| CVEs | 28 |
| Malicious Authors | 6 |
| Malicious Skills | 655 |
| Attack Techniques | 14 |
| Minimum Safe Versions | 12 |
| Research Sources | 23 |
--- get_threat("CVE-2025-53109") ---
# CVE-2025-53109 — Filesystem MCP Server
Severity: HIGH | Source: Cymulate EscapeRoute
## Description
Symlink escape to arbitrary filesystem access / potential LPE
Fixed in: 0.6.3 / 2025.7.1
## Mitigation
Update to >= 0.6.3; avoid Filesystem MCP in sensitive environments
--- get_threat("T001") ---
# T001 — Tool Poisoning via SKILL.md
## Description
Hidden instructions in SKILL.md that instruct the agent
to run malicious commands.
## Examples
- curl | bash from glot.io scripts
- Password-protected ZIP with embedded malware
- Base64-decoded eval commands
Campaigns: ClawHavoc, ToxicSkills
Mitigation: Scan SKILL.md for shell commands;
never auto-execute prerequisites 13 shortcuts /ccguide:* — search, fetch templates, track official Anthropic docs changes, and get a daily briefing.
# Slash commands /ccguide:* (13 total)
cp -r .claude/commands/ccguide ~/.claude/commands/ccguide
── Guide ────────────────────────────────────────────────────────────
┌──────────────────────────┬──────────────────────────────────────────┐
│ Command │ What it does │
├──────────────────────────┼──────────────────────────────────────────┤
│ /ccguide:search <query> │ Search 893 entries with scores + links │
│ /ccguide:digest <period> │ Guide + CC CLI changes (day/week/month) │
│ /ccguide:examples │ List all 232 templates by category │
│ /ccguide:example <name> │ Fetch a template (agent/hook/skill...) │
│ /ccguide:cheatsheet │ Full cheatsheet or filtered by section │
│ /ccguide:release │ Latest Claude Code CLI release notes │
│ /ccguide:changelog │ Last N CHANGELOG entries from the guide │
│ /ccguide:topics │ Browse 25 topic categories │
└──────────────────────────┴──────────────────────────────────────────┘
── Official Anthropic docs tracker (v1.1.0) ─────────────────────────
┌──────────────────────────┬──────────────────────────────────────────┐
│ Command │ What it does │
├──────────────────────────┼──────────────────────────────────────────┤
│ /ccguide:init-docs │ Fetch docs + store as baseline (once) │
│ /ccguide:refresh-docs │ Update current snapshot (no baseline Δ) │
│ /ccguide:diff-docs │ Compare baseline vs current — 0 network │
│ /ccguide:search-docs <q> │ Search official Anthropic docs from cache│
│ /ccguide:daily │ refresh + diff + digest in one shot │
└──────────────────────────┴──────────────────────────────────────────┘
Daily workflow:
/ccguide:init-docs # once → baseline in ~/.cache/claude-code-guide/
/ccguide:daily # every morning 5 Golden Rules
Data-driven principles for working safely and effectively with AI code generation
Verify Trust Before Use
AI-generated code contains 1.75x more logic errors than human code (ACM 2025). Test everything, peer review AI output like you would a junior dev's PR.
Never Approve MCPs from Unknown Sources
15 vulnerabilities tracked, 655 malicious skills detected in the wild. Use the 5-minute audit checklist before installing any MCP server.
Context Pressure Changes Behavior
At 70% context usage, Claude starts losing precision. Run /compact at 70%, /clear at 90%. Monitor with /status.
Start Simple, Scale Smart
2-week test period before scaling. 4-phase adoption: solo tasks, multi-file work, agents, then CI/CD integration. Work through each phase, don't skip ahead.
Methodologies Matter More with AI
AI amplifies good code AND bad code. TDD for critical logic, SDD for architecture-first, BDD for PM/dev collaboration. Choose by context, not by habit.
Claude Code vs GitHub Copilot vs Cursor
How does this AI coding assistant compare to alternatives?
| Feature | Claude Code | GitHub Copilot | Cursor |
|---|---|---|---|
| Interface | Terminal CLI | IDE Extension | Full IDE (VS Code fork) |
| Agentic Mode | Multi-file, autonomous | Agent Mode (VS Code) | Composer mode |
| Context Window | 200K tokens (up to 1M) | 64K-128K tokens | 32K-200K tokens |
| Project Memory | CLAUDE.md files | ~ Repo embeddings | .cursorrules |
| Custom Agents | Agent SDK + Skills | ~ MCP configs | ~ MCP integrations |
| MCP Integration | Native client/server | Via Agent Mode | Docs integration |
| Shell Execution | Native terminal | Agent Mode | Integrated |
| Hooks System | Event-driven hooks | ||
| Best For | Terminal power users, automation | IDE-integrated coding | Visual IDE users |
Each tool has its strengths. Claude Code excels at autonomous multi-file operations and deep code generation from the terminal. This guide helps you master its unique capabilities.
Community & Resources
Contribute to the Guide
The guide repo is open-source. Found an error? Have a better template?
Contributing Guide →