Skip to main content
Code Guide

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

stars 1337 templates 232 quiz 271 questions awesome featured mcp npx ready
Personalized Learning

Start With Interactive Onboarding

Claude asks 2-4 questions about your profile, then guides you through personalized content

1

Choose your language
English or French

2

Select your goal
Learn, audit setup, or explore

3

Pick your level
Junior, Senior, or Power User

4

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

Claude AI

You write, think, search.

Generalist conversational assistant. Zero config, multimodal, available on web and mobile.

📝 Writing & editing
💡 Brainstorming
🔍 Research & synthesis
✓ Zero setup, works instantly
✓ Multimodal (images, PDFs, voice)
✗ No system access
✗ Limited memory between sessions
Ideal for Writer · Consultant · Student · Manager
Desktop app · macOS

Claude Cowork

You automate without code.

Agentic desktop app for knowledge workers. Accesses local folders and apps — no terminal required.

🗂️ Bulk file organization
📊 PDF → spreadsheet extraction
🔄 Cross-app workflows
✓ No code required
✓ Works with your existing apps
✗ macOS only, still in beta
✗ Limited customization
Ideal for Ops · Assistant · SMB non-tech
💡 These three tools are complementary, not competing. All included in the $20/mo Pro plan.

Whitepapers & Recap Cards

11 whitepapers · 472 pages · PDF + EPUB · FR + EN — from foundations to AI budget justification for decision-makers

11 whitepapers FR + EN PDF + EPUB
  • 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
Browse all ebooks →
57 CARDS Recap Cards FR · EN coming

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
Browse all recap cards →

MCP in Action

Query the guide directly from Claude Code. Real outputs, live search, source links on every result.

install 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.

/ccguide:daily
# 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.

/ccguide:examples
# 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.

/ccguide:topics
# 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.

/ccguide:release
# 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.

get_threat / list_threats
# 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
# 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

1

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.

1.75x more logic errors ACM 2025
2

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.

15 vulnerabilities 655 malicious skills
3

Context Pressure Changes Behavior

At 70% context usage, Claude starts losing precision. Run /compact at 70%, /clear at 90%. Monitor with /status.

70% = precision loss /compact at 70%
4

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.

2-week test period 4-phase adoption
5

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.

TDD / SDD / BDD Choose by context

Secure Your Setup

36.82% of AI agent skills have measurable security flaws. Understand the threat landscape before it becomes your problem.

534
Critical-Risk Skills
15
Vulnerabilities Tracked
655
Malicious Skills
Supply Chain Attacks
Malicious MCP servers on PyPI & npm with embedded reverse shells
Credential Theft
Skills that read .env files and POST secrets to attacker webhooks
Prompt Injection
Hidden instructions in SKILL.md that hijack agent behavior

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 →

Star on GitHub

If this guide saved you time, show your support.

GitHub Repository →
Florian BRUNIAUX - Claude Code Guide author, Founding Engineer at Methode Aristote

By Florian BRUNIAUX

Founding Engineer @ Methode Aristote

11+ years in tech as CTO, VP Engineering & Founding Engineer. Fullstack developer (TypeScript, Ruby, Python) with a passion for solving problems through technology. Leadership driven by transparency, building teams with loyalty, ambition & benevolence.