Claude Code Cheat Sheet

⌨ Raccourcis Clavier

Essentiels

EnterEnvoyer le message / valider EscAnnuler la saisie en cours Esc EscMenu rewind / résumé Ctrl+CAnnuler l'input ou la génération Ctrl+DQuitter Claude Code Shift+TabCycler les modes de permission (Auto inclus) Ctrl+BMettre la tâche en arrière-plan ←←Ouvrir l'Agent View NEW

Navigation & Affichage

Ctrl+RRecherche dans l'historique Ctrl+LEffacer l'écran (garde la conversation) Ctrl+OTranscript fullscreen — toggle thinking verbeux Ctrl+TAfficher/masquer la liste des tâches Ctrl+SStash le prompt en cours ↑/↓Naviguer l'historique des commandes ←/→Cycler les onglets / footer { / }Sauter entre prompts dans le transcript NEW

Édition & Modèle

\ + EnterSaisie multi-ligne Ctrl+GOuvrir dans un éditeur externe Ctrl+VColler image (screenshots, diagrammes) Ctrl+KSupprimer jusqu'à la fin de ligne Ctrl+USupprimer du curseur au début Ctrl+YColler le texte supprimé Ctrl+_Undo dernière action Alt+B / Alt+FReculer / avancer d'un mot Option+PSélecteur de modèle Option+TToggle thinking (sans effet sur Fable 5) NEW Alt+OToggle fast mode (Opus 4.8) ?Afficher tous les raccourcis Space (maintenu)Push-to-talk (si /voice activé) Ctrl+JNewline (séquence de contrôle) Option+EnterNewline (macOS) Ctrl+X Ctrl+KKill tous les agents en arrière-plan (×2) Ctrl+X Ctrl+EOuvrir dans l'éditeur externe (alias Ctrl+G)

Mode Vim

vVisual mode — sélection caractère VVisual-line mode — sélection ligne / (NORMAL)Recherche inverse d'historique (comme Ctrl+R) NEW EscRetour au mode normal

Préfixes rapides

/Commande slash ou skill !Mode Bash — ou job background dans l'Agent View NEW @Autocomplete fichier/dossier/agent

Dialogues de confirmation

Y / EnterConfirmer N / EscRefuser Ctrl+EToggle explication de permission Ctrl+DToggle debug info de permission

Tip : l'autocomplete des commandes slash remplit désormais la commande au lieu de la lancer — appuyez sur Enter pour exécuter (v2.1.162). /scroll-speed règle la vitesse de la molette NEW. /keybindings pour personnaliser (17 contextes).

⚡ Commandes Slash

Session & Contexte

`/clear`	Réinitialiser la conversation (alias: /reset, /new)
`/compact [focus]`	Compacter avec focus optionnel
`/resume [session]`	Reprendre par ID, nom ou URL de PR (alias: /continue)
`/rewind`	Checkpoint + « Summarize up to here » NEW
`/cd <path>`	Changer de cwd sans casser le prompt cache NEW
`/rename [name]`	Renommer la session
`/branch [name]`	Brancher la conversation (alias: /fork)
`/export [file]`	Exporter la conversation en texte
`/copy [N]`	Copier la réponse N dans le clipboard
`/cost`	Coûts + tokens + breakdown par modèle & cache-hit
`/context`	Grille colorée de consommation du contexte
`/tasks`	Lister et gérer les tâches en arrière-plan

Modèle & Configuration

`/model [name]`	Changer de modèle — fable, opus, sonnet, haiku NEW
`/effort [level]`	Slider — low/medium/high/xhigh/max + ultracode NEW
`/fast [on\|off]`	Mode sortie rapide — défaut Opus 4.8 ($10/$50) NEW
`/focus`	Vue condensée : dernier prompt + outils + réponse
`/tui`	Rendu fullscreen sans flicker (alt-screen)
`/config`	Panneau de config (Editor mode, thinking, model fallback) (alias: /settings)
`/permissions`	Gérer perms + onglet Recent (retry par `r`) (alias: /allowed-tools)
`/mcp`	Gérer les serveurs MCP & OAuth
`/hooks`	Voir les hooks configurés
`/theme`	Changer / créer un thème custom (~/.claude/themes/)
`/color [color]`	Couleur de la barre de prompt
`/sandbox`	Toggle mode sandbox
`/scroll-speed`	Régler la vitesse de scroll (preview live) NEW

Projet & Analyse

`/init`	Créer CLAUDE.md pour le projet
`/memory`	Éditer CLAUDE.md & mémoire, toggle auto-memory
`/add-dir <path>`	Ajouter un répertoire de travail
`/diff`	Diff interactif, vue détail scrollable (`j/k`, PgUp/PgDn) NEW
`/goal`	Définir une condition de fin — Claude itère jusqu'à l'atteindre NEW
`/code-review`	Bugs de correction (`--comment` PR, `--fix` applique) NEW
`/simplify`	Review cleanup-only (reuse, qualité) + applique les fixes NEW
`/security-review`	Scanner les vulnérabilités
`/ultrareview`	Flotte d'agents chasseurs de bugs dans le cloud NEW
`/workflows`	Gérer les dynamic workflows (orchestration multi-agents) NEW
`/insights`	Rapport HTML d'analyse d'utilisation
`/stats`	Usage quotidien, streaks, préférences
`/ultraplan`	Plan cloud, revue navigateur, exécution locale/distante
`/pr-comments [PR]`	Commentaires de PR GitHub
`/autofix-pr`	Réparer une PR depuis le terminal ou le web
`/plan [desc]`	Entrer en mode plan
`/batch [task]`	Changements parallèles dans les worktrees
`/debug [desc]`	Troubleshooting de session
`/advisor`	Modèle de second avis consulté mid-tâche

Extensions & Plugins

`/plugin [list]`	Gérer plugins — `list --enabled/--disabled` NEW
`/reload-plugins`	Recharger skills/agents/MCP sans restart
`/reload-skills`	Re-scanner les répertoires de skills sans restart NEW
`/agents`	Onglets Running (● N) + Library
`/skills`	Liste triée par tokens
`/chrome`	Configurer Claude in Chrome + « Select browser… » NEW
`/ide`	Gérer les intégrations IDE

Avancé & Remote

`/loop [interval]`	Répéter — omettre interval = self-pacing
`/schedule`	Tâches planifiées sur le cloud
`/btw`	Question rapide sans outils ni historique (`c` = copier) NEW
`/voice`	Dictée vocale push-to-talk
`/teleport`	Reprendre une session web en local
`/desktop`	Transférer vers l'app Desktop
`/web-setup`	Connexion GitHub App pour Claude Code on the web NEW
`/remote-control`	Rendre la session accessible depuis claude.ai
`/remote-env`	Configurer l'environnement remote par défaut

Système & Compte

`/help`	Aide et référence des commandes
`/doctor`	Vérifier l'installation, l'auth, le dernier update
`/status`	Version et infos du compte
`/usage`	Limites + breakdown skills/subagents/plugins/MCP NEW
`/extra-usage`	Configurer l'usage supplémentaire
`/feedback`	Rapport (peut inclure sessions 24h/7j) (alias: /bug)
`/release-notes`	Picker interactif de version
`/powerup`	Leçons animées pour apprendre Claude Code
`/team-onboarding`	Générer un guide ramp-up pour un coéquipier
`/login / /logout`	Connexion / Déconnexion
`/upgrade`	Passer au plan supérieur
`/privacy-settings`	Paramètres de confidentialité
`/keybindings`	Ouvrir le fichier de raccourcis
`/terminal-setup`	Configurer les keybindings terminal
`/statusline`	Config status line + `refreshInterval`
`/install-github-app`	Installer l'app GitHub Actions
`/install-slack-app`	Installer l'app Slack via OAuth
`/exit`	Quitter (alias: /quit)
`/mobile`	QR code pour l'app mobile (alias: /ios, /android)
`/passes`	Partager une semaine gratuite de Claude Code
`/stickers`	Commander des stickers Claude Code

🚀 CLI Launch Flags

Démarrage de session

`claude`	Session interactive
`claude "query"`	Démarrer avec un prompt initial
`claude -p "query"`	Mode print — résultat et exit
`claude -c`	Reprendre la dernière conversation
`claude -r "id"`	Reprendre par nom ou ID
`claude -n "name"`	Nommer la session
`claude -w branch`	Git worktree isolé
`claude --safe-mode`	Désactiver TOUTES les customisations (debug) NEW

Modèle & Raisonnement

`--model fable`	Claude Fable 5 — tâches longues & autonomes NEW
`--model claude-opus-4-8`	Opus 4.8 — nouveau défaut Max/API NEW
`--model best`	Fable 5 si dispo, sinon dernier Opus NEW
`--model opus[1m]`	Opus + contexte 1M (natif Opus 4.7/4.8)
`--effort {low..max}`	low / medium / high / xhigh / max
`--fallback-model a,b,c`	Chaîne de secours (max 3) — interactif aussi NEW
`--thinking disabled`	Désactiver le thinking (sans effet sur Fable 5) NEW

Contexte & Répertoires

`--add-dir ../path`	Répertoires supplémentaires
`--bare`	Skip hooks, plugins, MCP, CLAUDE.md
`--verbose`	Détail de chaque tour
`--debug "api,hooks"`	Debug par catégories
`--chrome / --no-chrome`	Activer/désactiver Chrome
`--ide`	Auto-connect IDE au démarrage

Permissions

`--permission-mode plan`	Mode lecture seule
`--permission-mode auto`	IA classifie les permissions (Pro+ )
`--allowedTools`	Outils auto-approuvés
`--disallowedTools`	Outils retirés du contexte
`--tools`	Restreindre les outils built-in
`--permission-prompt-tool`	MCP tool pour les permissions (headless)
`--dangerously-skip-permissions`	Équivalent de bypassPermissions

Sortie & Formats

`--output-format json`	Sortie JSON structurée
`--output-format stream-json`	Streaming JSON en temps réel
`--input-format`	Format d'entrée (text, stream-json)
`--include-partial-messages`	Inclure les events de streaming partiel
`--json-schema '{}'`	Forcer un schéma de sortie
`--max-turns 5`	Limiter les tours agentiques
`--max-budget-usd 2`	Limite de dépenses

Prompt système

`--system-prompt "text"`	Remplacer le prompt système
`--system-prompt-file`	Charger depuis un fichier
`--append-system-prompt`	Ajouter du texte au prompt
`--append-system-prompt-file`	Ajouter depuis un fichier

Background & Remote

`--bg --exec "cmd"`	Job shell en background attachable NEW
`--remote "task"`	Session distante sur claude.ai
`--remote-control`	Activer le contrôle à distance
`--tmux`	Worktree + panneau tmux
`--teammate-mode`	Agent teams : auto/in-process/tmux
`--from-pr 42`	Reprise PR : GitHub, GitLab, Bitbucket, GH Enterprise
`--fork-session`	Forker en gardant le contexte
`--teleport`	Reprendre une session web

Plugins & Config

`--plugin-dir path\|file.zip`	Charger des plugins (dossier ou .zip) NEW
`--plugin-url URL`	Fetch une archive plugin pour la session NEW
`--mcp-config`	Charger des serveurs MCP
`--strict-mcp-config`	N'utiliser QUE ces serveurs MCP
`--settings`	Fichier settings JSON custom
`--setting-sources`	Sources de settings (user, project, local)
`--agents`	Définir des agents dynamiques via JSON
`--agent name`	Exécuter en tant qu'agent
`--session-id`	UUID de session spécifique
`--disable-slash-commands`	Désactiver skills et commandes
`--betas`	Beta headers pour les requêtes API

Sous-commandes CLI

`claude agents`	Agent View — toutes les sessions NEW
`claude agents --json`	Lister les sessions live en JSON NEW
`claude ultrareview`	Code review cloud pour CI/scripts NEW
`claude project purge`	Nettoyer l'état local d'un projet NEW
`claude update`	Mettre à jour (annonce la version cible)
`claude auth login/status/logout`	Gestion de l'authentification
`claude mcp add/list/remove`	Gérer les serveurs MCP
`claude mcp serve`	Exposer Claude Code en serveur MCP
`claude plugin init <name>`	Scaffolder un nouveau plugin NEW
`claude plugin details <name>`	Inventaire + coût token projeté NEW
`claude plugin install/enable`	Installer / activer un plugin
`claude auto-mode defaults/config`	Règles auto-mode
`claude bedrock/vertex setup`	Wizards interactifs
`claude doctor`	Diagnostic + dernier résultat d'update

🔌 The Big 5 — Système d'Extension de Claude Code

1. CLAUDE.md — Prompt système

`Managé`	Politique d'entreprise, priorité max
`Projet`	`./CLAUDE.md` ou `./.claude/CLAUDE.md`
`Utilisateur`	`~/.claude/CLAUDE.md`

Imports : @docs/standards.md (max 5 niveaux)

Taille : Garder < 200 lignes, @path pour découper

2. Rules — Règles scopées

Fichiers dans .claude/rules/*.md, activés par glob :

paths: ["src/**/*.tsx"]
MUST use TanStack Query.
SHOULD prefer named exports.

Placement basé sur le consommateur. MUST/SHOULD/MAY

3. Custom Commands — Raccourcis

Créer dans .claude/commands/name.md → /name

$ARGUMENTS, $0, $1 pour les arguments (\$ = $ littéral) NEW

Context live : !`git diff` (exécuté avant le prompt)

4. Skills — Workflows complexes

Répertoire .claude/skills/name/SKILL.md

`description`	Déclencheur auto-découverte (1536 car.)
`context: fork`	Sous-agent isolé (pas de pollution)
`paths: "*.ts"`	Activer par type de fichier
`effort: high`	Forcer le niveau d'effort
`user-invocable`	true = /command, false = Claude only
`allowed-tools`	Restreindre les outils du skill
`disallowed-tools`	Retirer des outils tant que le skill est actif NEW

Divulgation progressive : SKILL.md < 500 lignes, [ref](references/). /reload-skills re-scanne sans restart NEW.

Builtin : code-review, security-review, simplify, init, deslopify, loop, claude-api. Masquer : disableBundledSkills NEW.

5. Sous-agents — Spécialistes parallèles

Créer dans .claude/agents/name.md

`model`	Modèle (hérité par défaut)
`tools`	Restreindre les outils
`isolation: worktree`	Git worktree séparé
`memory: project`	Mémoire persistante (user/project/local)
`permissionMode`	Mode de permission dédié
`effort`	Niveau d'effort du sous-agent

Invoquer : @"name (agent)" | --agent name | SendMessage to: <id>. Matching insensible à la casse/séparateur NEW.

Builtin : Explore (Haiku), Plan, general-purpose, claude-code-guide, statusline-setup, code-reviewer.

6. MCP + Plugins

MCP : Intégrations via .mcp.json. Outils : mcp__server__tool. OAuth RFC 9728. Les serveurs stdio reçoivent CLAUDE_CODE_SESSION_ID, CLAUDE_PROJECT_DIR et CLAUDECODE=1 NEW.

# Ajouter / Lister / Supprimer
claude mcp add playwright -- npx @playwright/mcp
claude mcp list   # non approuvés = ⏸ Pending
claude mcp remove playwright
# Import / JSON / Serveur exposé
claude mcp add-from-claude-desktop
claude mcp serve

Transports : stdio | http | sse | ws

Plugins : Skills + agents + hooks + MCP/LSP + bin/ sur PATH. Auto-load depuis .claude/skills/ NEW. defaultEnabled: false = installe sans activer.

/plugin install name@marketplace · claude plugin init <name>

🖥 Computer Use — dans le CLI

Claude voit et contrôle votre bureau : screenshots, clics, saisie, scroll, drag & drop. Disponible dans le CLI sur macOS et Windows Desktop (Linux non supporté). Multi-monitor. Pro/Max. Active dans Settings > General > Computer Use. 27 outils (screenshot, left_click, type, computer_batch, etc.). request_access obligatoire + allowlist par app.

👁 Monitor tool

Outil built-in pour spawner des watchers background — tail de logs, suivi CI, auto-fix de crashes. Chaque ligne stdout = notification dans la conversation. Remplace les boucles sleep dans Bash. Se combine avec /loop self-pacing.

🛡 Modes de Permission

Mode	Comportement
Default	Demande permission pour chaque outil
acceptEdits	Auto-approuve les éditions, prompt sur les configs build NEW
Plan	Lecture seule. Explore & comprend. N'écrit rien.
Auto	IA classifie. Pro + (Sonnet 4.6 ou Opus) NEW
dontAsk	Skip les prompts, ignore les outils non-approuvés
bypass	Skip toutes les vérifications (containers uniquement)

Normal → Auto-Accept → Plan → Auto

Shift+Tab pour cycler (Agent View incluse). Auto mode sans opt-in depuis fin mai. Détail du classifier en Row 5.

Pro workflow : Plan Mode pour explorer → Normal pour implémenter → Auto pour les longs runs → Rewind si besoin.

Pré-approuver des outils

// .claude/settings.json
"allow": ["Read", "Bash(git *)", "Bash(npm run *)"]
"ask": ["Bash(npm publish *)"]
"deny": ["Bash(rm -rf *)", "*"]

Ordre : deny → ask → allow (premier match gagne)

Glob dans les deny : les noms d'outils acceptent des patterns ; "*" refuse tout NEW

Hardening juin : prompt avant écriture des fichiers de démarrage shell (.zshenv, .bash_login), ~/.config/git/ et configs build (.npmrc, .bazelrc, .devcontainer/) NEW.

🔗 Hooks — Automatisation

Événements (27)

Événement	Quand
`SessionStart`	Début / reprise — `reloadSkills: true` NEW
`SessionEnd`	Fin de session
`UserPromptSubmit`	Avant que Claude traite le message
`PostUserPromptSubmit`	Après submit — peut override `sessionTitle`
`PreToolUse`	Avant un outil — peut bloquer (exit 2)
`PostToolUse`	Après un outil — `duration_ms`, `continueOnBlock` NEW
`PostToolUseFailure`	Après un outil échoué
`MessageDisplay`	Transformer/masquer le texte affiché NEW
`PermissionRequest`	Dialogue de permission apparaît
`PermissionDenied`	Après refus auto-mode (`retry: true`)
`Stop`	Fin de réponse — `additionalContext` NEW
`StopFailure`	Tour terminé par erreur API
`SubagentStart`	Un sous-agent démarre
`SubagentStop`	Fin de sous-agent — `additionalContext` NEW
`TeammateIdle`	Un coéquipier va devenir inactif
`TaskCreated`	Tâche créée via TaskCreate
`TaskCompleted`	Tâche terminée
`PreCompact`	Avant compaction — `exit 2` pour bloquer
`PostCompact`	Après la compaction
`Notification`	Claude envoie une notification
`InstructionsLoaded`	CLAUDE.md ou rules chargé
`ConfigChange`	Un fichier de config change
`FileChanged`	Un fichier surveillé change
`CwdChanged`	Le cwd change (recharger env)
`WorktreeCreate / Remove`	Création / suppression d'un worktree
`Elicitation(Result)`	Input demandé par un serveur MCP

5 types de handlers

`command`	Shell command (+ `args: string[]` exec form) NEW
`http`	POST vers un endpoint
`prompt`	LLM single-turn (Haiku)
`agent`	Sous-agent multi-turn
`mcp_tool`	Appel direct d'un outil MCP

// Exec form (args[]) + filtre conditionnel
"PostToolUse": [{
  "matcher": "Write|Edit",
  "if": "Edit(*.ts)",
  "hooks": [{
    "type": "command",
    "command": "npx",
    "args": ["prettier", "--write", "$CLAUDE_FILE_PATHS"]
  }]
}]

Codes : 0 = succès, 2 = blocage (stderr → Claude), autre = erreur

Champ if : filtre par nom ET arguments. Ex: Bash(git *), mcp__server__tool

Env vars : $CLAUDE_PROJECT_DIR, $CLAUDE_FILE_PATHS, $CLAUDE_TOOL_INPUT, $CLAUDE_SESSION_ID, $CLAUDE_EFFORT NEW

Nouveautés : terminalSequence (notifs desktop/bell), effort.level visible aux hooks, CLAUDE_CODE_STOP_HOOK_BLOCK_CAP (anti-boucle) NEW

✨ Input Superpowers

Syntaxe	Action
`@file`	Référencer fichiers & dossiers dans le contexte
`@"agent"`	Mentionner un sous-agent spécifique
`!command`	Exécuter un shell. Ex: `! git status`
`Ctrl+V`	Coller screenshots, diagrammes, images
`ultrathink`	Mot-clé reconnu — deeper reasoning ponctuel

Pipe Input

# Analyser des logs
cat error.log | claude -p "find root cause"

# Review de PR
gh pr diff 42 | claude -p "security review"

# Commit message
git diff --staged | claude -p "conventional commit msg"

Background & Agent View

Ctrl+B pour envoyer en arrière-plan. claude --bg --exec "pytest -x" lance un job attachable NEW.

←← ouvre l'Agent View — sessions running / blocked / done. /resume reprend les sessions bg NEW.

--remote "task" pour lancer un agent sur claude.ai.

Multi-répertoires & Worktrees

claude --add-dir ../lib --add-dir ../shared
claude -w feature --tmux # worktree + tmux

worktree.baseRef (remote default vs HEAD) et worktree.bgIsolation: "none" NEW.

Outils agent built-in

Filesystem	`Read`, `Write`, `Edit`, `NotebookEdit`, `Glob`, `Grep`
Shell	`Bash`, `BashOutput`, `KillBash` (+ `PowerShell`)
Web	`WebSearch`, `WebFetch`
Agents & Skills	`Agent` (Task), `Skill`, `ToolSearch`, `Monitor`
Session / Meta	`TodoWrite`, `AskUserQuestion`, `ExitPlanMode`, `PushNotification`
MCP	`mcp__<server>__<tool>` (auto-préfixés)

Restreindre : --tools Read,Edit,Bash(git *) · Interdire : --disallowedTools Bash

⚙ Configuration

Hiérarchie (priorité décroissante)

Enterprise	`/etc/claude-code/managed-settings.json`
CLI Args	Flags passés au lancement
Local	`.claude/settings.local.json` (gitignored)
Projet	`.claude/settings.json` (committé)
User	`~/.claude/settings.json` (global)

Variables d'environnement

`ANTHROPIC_API_KEY`	Clé API (override l'abo)
`ANTHROPIC_MODEL`	Modèle par défaut
`ANTHROPIC_DEFAULT_FABLE_MODEL`	ID Fable 5 (alias `fable` + fallback auto) NEW
`ANTHROPIC_DEFAULT_OPUS_MODEL`	ID résolu par l'alias `opus`
`CLAUDE_CODE_SUBAGENT_MODEL`	Modèle de tous les sous-agents
`CLAUDE_CODE_EFFORT_LEVEL`	Niveau d'effort (low…xhigh/max)
`CLAUDE_CODE_SAFE_MODE`	Désactiver toutes les customisations NEW
`CLAUDE_CODE_DISABLE_BUNDLED_SKILLS`	Masquer les skills bundle NEW
`CLAUDE_CODE_ENABLE_AUTO_MODE`	Auto mode sur Bedrock/Vertex/Foundry NEW
`CLAUDE_CODE_SESSION_ID`	Injecté dans les serveurs MCP stdio NEW
`CLAUDE_CODE_PLUGIN_PREFER_HTTPS`	Cloner les plugins GitHub en HTTPS NEW
`CLAUDE_CODE_STOP_HOOK_BLOCK_CAP`	Plafond anti-boucle des Stop hooks NEW
`CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING`	Budget thinking fixe (Opus 4.6/Sonnet 4.6) NEW
`ANTHROPIC_WORKSPACE_ID`	Scoping workload identity federation NEW
`MAX_THINKING_TOKENS`	`0` = off (sauf Fable 5)
`DISABLE_PROMPT_CACHING[_FABLE]`	Désactiver le prompt caching (par tier) NEW
`CLAUDE_CODE_USE_BEDROCK/VERTEX`	Provider tiers
`CLAUDE_PROJECT_DIR`	Racine du projet (injecté dans hooks)

Settings.json — champs clés

`model`	Modèle par défaut (sauvegardé par `/model`)
`effortLevel`	Effort par défaut (low/medium/high/xhigh) NEW
`fallbackModel`	Chaîne de secours (array, max 3) NEW
`availableModels`	Allowlist de modèles (+ `enforceAvailableModels`) NEW
`modelOverrides`	Mapper des IDs vers des IDs provider NEW
`requiredMinimum/MaximumVersion`	Gating de version (managé) NEW
`disableBundledSkills`	Masquer les skills/workflows bundle NEW
`autoMode.hard_deny`	Règles qui bloquent inconditionnellement NEW
`pluginSuggestionMarketplaces`	Allowlist de marketplaces org NEW
`worktree.baseRef / bgIsolation`	Base de branche / isolation background NEW
`alwaysThinkingEnabled`	Thinking par défaut (`Option+T`)
`permissions.{allow,ask,deny}`	Règles de permissions
`hooks`	Hooks du cycle de vie
`theme`	Nom du thème ou JSON custom

Diagnostic : claude --safe-mode désactive CLAUDE.md, skills, MCP et hooks — idéal pour savoir si une customisation déclenche un fallback ou un bug. Git status et noms de dossiers restent inclus. NEW

📁 File Structure Map

Niveau projet (`.claude/`)

CLAUDE.md — Mémoire projet, conventions settings.json — Settings partagés (git) settings.local.json — Settings perso (gitignored) commands/ — Commandes slash du projet skills/ — Skills (+ auto-load plugins) NEW agents/ — Sous-agents du projet rules/ — Règles scopées par fichier claude-security-guidance.md — Règles plugin sécu NEW .mcp.json — Config MCP projet (committable)

Niveau global (`~/.claude/`)

CLAUDE.md — S'applique à TOUS les projets settings.json — Settings globaux commands/ — Commandes personnelles skills/ — Skills personnels agents/ — Agents personnels rules/ — Règles globales themes/ — Thèmes JSON custom plans/ — Fichiers /plan & /ultraplan keybindings.json — Raccourcis personnalisés

Hiérarchie (5 niveaux)

Policy > Organization > User global > User local > Project

managed-settings.json peut imposer requiredMinimumVersion / requiredMaximumVersion NEW.

⏪ Rewind & Checkpoints

Esc EscOuvrir le menu rewind n'importe quand /rewindMême fonction via commande

Options de rewind

Option	Effet
Conversation	Revenir dans le chat. Le code reste.
Code	Restaurer les fichiers. La conversation reste.
Full Rewind	Restaurer conversation ET code.
Summarize up to here	Compresser le contexte ancien, garder les tours récents NEW

Limites : Les effets secondaires (Bash, fichiers supprimés, paquets installés) ne peuvent PAS être annulés. Les checkpoints ne trackent que les éditions de fichiers par Claude. Utilisez Git.

Gestion du contexte

Budget au démarrage ~6K tokens : prompt système, mémoire, env, MCP, CLAUDE.md, rules, descriptions de skills.

Compaction : Auto à ~95%. /compact [focus] manuel. Le modèle préserve désormais les instructions utilisateur sensibles. CLAUDE.md relu depuis le disque.

Workflow « Document & Clear » : Sauvegarder → /clear → Repartir. Claude lit le résumé.

Économiser : Rules scopées, sous-agents, --bare, context: fork, opus[1m] ou fable (1M natif).

Contexte 1M : Fable 5, Opus 4.8/4.7 et Sonnet 4.6. Auto-upgrade Opus sur Max/Team/Enterprise. /usage détaille skills/subagents/plugins/MCP NEW.

🤖 Auto Mode

Permission classifier : l'IA décide si chaque outil est safe ou risky — plus de dialogues à chaque Bash.

Disponibilité NEW

Pro	GA — Sonnet 4.6 ou Opus (Week 21)
Max	GA avec Opus 4.7 / 4.8
Bedrock/Vertex/Foundry	`CLAUDE_CODE_ENABLE_AUTO_MODE=1` (Opus 4.7/4.8)

Activation

Shift+TabCycler jusqu'au pill « Auto » (sans opt-in) NEW --permission-mode autoAu lancement /configRégler en persistant

Classifier — 2 chemins

Fast path : Haiku scanne « safe / risky / uncertain ». Thinking path : reprend les cas uncertain pour réduire les faux positifs. Le dialogue explique quand une règle permissions.ask a causé le prompt NEW.

Hard deny NEW

// settings.json — bloque inconditionnellement
"autoMode": {
  "hard_deny": ["Bash(curl * | sh)"]
}

Règles : claude auto-mode defaults · config effective : claude auto-mode config. Hook PermissionDenied + {"retry": true} pour réagir à un refus.

🧠 Modèles & Effort Levels

Modèles disponibles

Modèle	ID / alias	Notes
Fable 5 SUSPENDED	`fable`	Mythos-class, 1M ctx, 128K out, $10/$50 NEW — désactivé le 12 juin (directive US gov.)
Opus 4.8	`claude-opus-4-8`	Défaut Max/API, 1M ctx NEW
Opus 4.7	`claude-opus-4-7`	Défaut sur AWS, xhigh par défaut
Sonnet 4.6	`claude-sonnet-4-6`	Défaut Pro / Team Standard
Haiku 4.5	`claude-haiku-4-5`	Ultra-rapide, classifier, background

Alias : best (Fable si dispo, sinon Opus), fable, opus, sonnet, haiku, opus[1m], opusplan, default. L'alias best résout vers Opus 4.8 tant que Fable 5 est suspendu.

Fable 5 — fallback automatique NEW SUSPENDED

⚠ Fable 5 suspendu : Désactivé mondialement le 12 juin 2026 sur directive du gouvernement américain. La mécanique de fallback ci-dessous est documentée pour référence et s'appliquera de nouveau si/quand l'accès est rétabli.

Classifiers de sécurité (cybersécurité, biologie) : une requête flaggée bascule sur Opus (4.8 sur l'API, 4.7 sur AWS) avec une notice. Thinking toujours actif, non désactivable. /config → « ask before switching » pour décider à chaque fois.

Niveaux d'effort

low medium high xhigh max ultracode

`high`	Défaut Fable 5, Opus 4.8, Sonnet 4.6
`xhigh`	Défaut Opus 4.7 — raisonnement profond
`max`	Budget maximum, session-only
`ultracode`	Réglage Claude Code : xhigh + dynamic workflows NEW

Invoquer

/effortSlider interactif (← →), labels « Faster/Smarter » --effort xhighAu lancement "ultrathink"Effort ponctuel dans le prompt Option+TToggle thinking

🌍 Plateformes

CLI

macOS	Installer natif (npm ou `curl`)
Linux	Installer natif — PID namespace isolation
Windows	Plus besoin de Git Bash — PowerShell par défaut NEW

Agent View NEW

claude agents (ou ←←) : un écran pour toutes les sessions — running, blocked, done. PR par session, durée écoulée, ! pour un job background. claude agents --json pour le scripting.

Desktop app

Multi-session, terminal intégré, file editor + preview HTML/PDF, diff viewer. /desktop transfère une session du CLI. Computer Use macOS & Windows.

Web — claude.ai/code

Sessions cloud persistantes, sidebar redesignée, drag-and-drop. Routines : agents cloud templatés (schedule, event GitHub, API) NEW. Push notifications mobiles NEW. /teleport pour reprendre en local.

IDE

VS Code	Extensions agentiques multiples simultanément
JetBrains	Plugin Beta — diff viewer amélioré
Devin Desktop	Ex-Windsurf (renommé juin) NEW

Thèmes custom : créez et partagez une palette depuis /theme ou un plugin. Session recap : résumé de ce qui s'est passé pendant que le terminal était hors focus.

🗂 Agent View — un écran pour tout NEW

Research Preview (v2.1.139). Un seul écran liste chaque session Claude Code : ce qui tourne, ce qui attend une réponse de vous, ce qui est terminé.

Ouvrir

claude agentsLancer l'Agent View ←←Depuis une session (sidebar) claude agents --jsonSortie scriptable claude agents --cwd pathScoper à un dossier

Dans la vue

Shift+TabCycle modes (auto inclus) ! <cmd>Job shell background attachable TabTitre = nb de sessions en attente

Flags `claude agents`

`--model / --effort`	Modèle & effort
`--permission-mode`	Mode de permission
`--add-dir / --settings`	Contexte & config
`--mcp-config`	Serveurs MCP
`--plugin-dir`	Plugins

Sessions background

« Pinned » : restent vivantes au repos, redémarrent en place pour les updates. /resume liste les sessions bg avec leur durée (ex. « 3h 2m 5s »). Modèle & effort préservés au réveil.

Combo : claude --bg --exec "npm test" lance un test en background visible dans l'Agent View, attachable/détachable à volonté.

🏗 Dynamic Workflows & Sécurité NEW

Dynamic workflows (research preview)

Un workflow est un script d'orchestration que Claude écrit pour votre tâche et exécute sur des dizaines à des centaines de sous-agents en arrière-plan. Pour les tâches trop grosses pour une seule conversation : audit codebase-wide, grosse migration, recherche cross-checkée.

# Décrire la tâche, demander un workflow
> create a workflow that migrates every
  internal fetch() call to the new HttpClient

Gérer les runs : /workflows. Déclencher via l'effort ultracode (xhigh + orchestration auto) ou le mot-clé ultracode (ex-workflow, renommé juin).

Security guidance plugin NEW

Le plugin security-guidance review les changements de Claude pour des vulnérabilités et les corrige dans la même session :

Check rapide par pattern sur chaque édition
Review modèle en fin de tour
Review agentique approfondie au commit / push

> /plugin install security-guidance@claude-plugins-official
> /reload-plugins

Règles projet dans .claude/claude-security-guidance.md.

Ultrareview NEW

/ultrareview (ou claude ultrareview en CI) : une flotte d'agents chasseurs de bugs tourne dans le cloud, les findings reviennent dans le CLI ou Desktop automatiquement.

🎯 Pro Workflow — Tirer le maximum de Claude Code

Démarrer un projet

1.cd project && claude 2./init pour générer CLAUDE.md 3.Éditer CLAUDE.md → conventions & commandes 4./powerup pour découvrir les features 5.Coder !

Boucle Plan → Execute

Shift+Tab × 2 → Plan Mode → Décrire la tâche

Valider → Shift+Tab → Normal ou Auto → « implémente le plan »

/goal pour fixer une condition de fin : Claude itère à travers les tours jusqu'à l'atteindre. /ultraplan pour déléguer le plan au cloud. NEW

Gérer le contexte

/compact [focus]Compacter avec zone de focus /clearTâches non liées ? Réinitialiser fableTâches longues & autonomes NEW /focusVue condensée (lecture rapide)

Watchers & automatisation

MonitorWatcher background, tail logs /loopSelf-pacing (omettre l'intervalle) /workflowsOrchestration multi-agents NEW

Techniques de prompting

Préciscat error.log | claude -p "root cause" Outcome-firstSur Fable 5 : décrire le résultat, pas les étapes NEW ProgressifDécouper en étapes, valider chacune Corrigez tôtCtrl+C si mauvaise direction AdaptiveLaisser le modèle décider du thinking

Patterns avancés

Agent View	`claude agents` / `←←` NEW
Background exec	`claude --bg --exec "pytest"` NEW
Worktrees	`claude -w feat --tmux`
Fallback chain	`--fallback-model sonnet,haiku` NEW
Auto Mode	Pro+ : classifier gère les permissions NEW
From PR	`--from-pr 42`
Schedule	`/schedule` / Routines (web)

Headless / CI

claude -p --max-budget-usd 2 \
  --max-turns 5 \
  --fallback-model opus,sonnet \
  --effort xhigh "fix failing test"

Debug : claude --safe-mode pour isoler une customisation fautive. NEW

Boucle d'apprentissage : Claude fait une erreur → vous corrigez → promouvez en règle MUST → Claude ne répète jamais. C'est le compound learning.

📝 Personnaliser Claude Code — Créer vos extensions

📋 Commande slash — `.claude/commands/name.md`

---
description: Review staged changes
allowed-tools: Read, Bash(git *)
disallowed-tools: Bash(rm *)   # NEW
model: sonnet
argument-hint: "[focus area]"
---
Diff: !`git diff --staged`
Review: $ARGUMENTS | $1, $2 positionnels

Vous l'invoquez : /name. Perso : ~/.claude/commands/

🧠 Skill — `.claude/skills/name/SKILL.md`

---
name: deploy
description: "Deploy to production (1536 car. max)"
context: fork          # sous-agent isolé
effort: high           # forcer l'effort
disallowed-tools: WebFetch  # NEW
user-invocable: true  # false = Claude only
---
Instructions... + [ref](references/guide.md)

Claude décide quand l'invoquer. /reload-skills re-scanne sans restart.

🤖 Sous-agent — `.claude/agents/name.md`

---
name: security-reviewer
description: "Audit code for vulnerabilities"
model: sonnet
tools: Read, Grep, Glob
memory: project        # user / project / local
isolation: worktree    # git worktree séparé
---
You are a security specialist...

Invoquer : @"name (agent)" | --agent name | langage naturel

📐 Rule — `.claude/rules/name.md`

---
paths: ["src/**/*.tsx", "src/**/*.ts"]
---
MUST use TanStack Query for data fetching.
SHOULD prefer named exports over default.

Chargée auto quand Claude touche un fichier correspondant au glob.

🔗 Hook — `.claude/settings.json`

"hooks": {
  "PostToolUse": [{
    "matcher": "Write|Edit",
    "if": "Edit(*.ts)",
    "hooks": [{
      "type": "command",
      "args": ["prettier", "--write", "$FILE"]
    }]
  }]
}

Déterministe — s'exécute toujours (contrairement à CLAUDE.md ~80%).

🔌 Plugin — `claude plugin init <name>`

# Scaffolder un plugin (skills+agents+hooks+MCP)
claude plugin init my-plugin
# Charger pour la session (dossier, .zip, URL)
claude --plugin-dir ./my-plugin
claude --plugin-url https://.../plugin.zip

Essentiels

Navigation & Affichage

Édition & Modèle

Mode Vim

Préfixes rapides

Dialogues de confirmation

Session & Contexte

Modèle & Configuration

Projet & Analyse

Extensions & Plugins

Avancé & Remote

Système & Compte

Démarrage de session

Modèle & Raisonnement

Contexte & Répertoires

Permissions

Sortie & Formats

Prompt système

Background & Remote

Plugins & Config

Sous-commandes CLI

1. CLAUDE.md — Prompt système

2. Rules — Règles scopées

3. Custom Commands — Raccourcis

4. Skills — Workflows complexes

5. Sous-agents — Spécialistes parallèles

6. MCP + Plugins

🖥 Computer Use — dans le CLI

👁 Monitor tool

Pré-approuver des outils

Événements (27)

5 types de handlers

Pipe Input

Background & Agent View

Multi-répertoires & Worktrees

Outils agent built-in

Hiérarchie (priorité décroissante)

Variables d'environnement

Settings.json — champs clés

Niveau projet (.claude/)

Niveau global (~/.claude/)

Hiérarchie (5 niveaux)

Options de rewind

Gestion du contexte

Disponibilité NEW

Activation

Classifier — 2 chemins

Hard deny NEW

Modèles disponibles

Fable 5 — fallback automatique NEW SUSPENDED

Niveaux d'effort

Invoquer

CLI

Agent View NEW

Desktop app

Web — claude.ai/code

IDE

Ouvrir

Dans la vue

Flags claude agents

Sessions background

Dynamic workflows (research preview)

Security guidance plugin NEW

Ultrareview NEW

Démarrer un projet

Boucle Plan → Execute

Gérer le contexte

Watchers & automatisation

Techniques de prompting

Patterns avancés

Headless / CI

📋 Commande slash — .claude/commands/name.md

🧠 Skill — .claude/skills/name/SKILL.md

🤖 Sous-agent — .claude/agents/name.md

📐 Rule — .claude/rules/name.md

🔗 Hook — .claude/settings.json

🔌 Plugin — claude plugin init <name>

Commandes de base

Modèles & Effort

Niveau projet (`.claude/`)

Niveau global (`~/.claude/`)

Flags `claude agents`

📋 Commande slash — `.claude/commands/name.md`

🧠 Skill — `.claude/skills/name/SKILL.md`

🤖 Sous-agent — `.claude/agents/name.md`

📐 Rule — `.claude/rules/name.md`

🔗 Hook — `.claude/settings.json`

🔌 Plugin — `claude plugin init <name>`