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 Ctrl+BMettre la tâche en arrière-plan

Navigation & Affichage

Ctrl+RRecherche dans l'historique Ctrl+LEffacer l'écran (garde la conversation) Ctrl+OTranscript fullscreen — cycle les vues NEW Ctrl+TAfficher/masquer la liste des tâches Ctrl+SStash le prompt en cours ↑/↓Naviguer l'historique des commandes ←/→Cycler les onglets / footer

É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 (adaptive sur Opus 4.7) Alt+OToggle fast mode ?Afficher tous les raccourcis Space (maintenu)Push-to-talk (si /voice activé) Alt+YCycler l'historique de paste (après Ctrl+Y) Ctrl+JNewline (séquence de contrôle) Option+EnterNewline (macOS) Ctrl+X Ctrl+KKill tous les agents en arrière-plan (×2 pour confirmer) Ctrl+X Ctrl+EOuvrir dans l'éditeur externe (alias Ctrl+G)

Mode Vim NEW

vVisual mode — sélection caractère VVisual-line mode — sélection ligne EscRetour au mode normal (amélioré)

Préfixes rapides

/Commande slash ou skill !Mode Bash — exécuter une commande shell @Autocomplete fichier/dossier/agent

Dialogues de confirmation

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

Tip : /terminal-setup pour Shift+Enter. /keybindings pour personnaliser. Contextes : Global, Chat, Confirmation, Transcript, etc. (17 contextes). Rendu flicker-free (alt-screen) activé par défaut depuis v2.1.89. CLAUDE_CODE_NO_FLICKER=0 pour revenir au rendu classique.

⚡ Commandes Slash

Session & Contexte

`/clear`	Réinitialiser la conversation (alias: /reset, /new)
`/compact [focus]`	Compacter avec focus optionnel
`/resume [session]`	Reprendre par ID ou nom (alias: /continue)
`/rewind`	Revenir à un checkpoint (alias: /checkpoint)
`/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 (subscribers) NEW
`/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 (sonnet, opus, haiku) — Opus 4.7 dispo NEW
`/effort [level]`	Slider interactif — low/medium/high/xhigh/max/auto NEW
`/fast [on\|off]`	Toggle mode sortie rapide (Opus 4.6, contexte 1M)
`/focus`	Vue condensée : dernier prompt + résumé outils + réponse NEW
`/tui`	Rendu fullscreen sans flicker (alt-screen) NEW
`/config`	Panneau de config (inclut Editor mode, remplace /vim) (alias: /settings)
`/permissions`	Gérer perms + onglet Recent (retry par `r`) NEW (alias: /allowed-tools)
`/mcp`	Gérer les serveurs MCP & OAuth
`/hooks`	Voir les hooks configurés
`/theme`	Changer le thème + éditeur JSON (~/.claude/themes/)
`/color [color]`	Couleur de la barre de prompt
`/sandbox`	Toggle mode sandbox
`/vim`	Supprimée v2.1.92 → `/config` → Editor mode REMOVED
`/tag`	Supprimée v2.1.92 → titres de session AI-generated REMOVED

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 des changements
`/review`	Code review (déprécié → plugin code-review)
`/security-review`	Scanner les vulnérabilités
`/insights`	Rapport HTML d'analyse d'utilisation
`/stats`	Visualiser usage quotidien, streaks, préférences
`/ultraplan`	Plan dans le cloud, revue navigateur, exécution locale/distante NEW
`/pr-comments [PR]`	Commentaires de PR GitHub
`/autofix-pr`	Réparer une PR depuis le terminal ou le web NEW
`/plan [desc]`	Entrer en mode plan avec description optionnelle
`/simplify`	Analyser le code pour reuse, qualité, efficacité
`/batch [task]`	Changements parallèles dans les worktrees
`/debug [desc]`	Troubleshooting de session

Extensions & Plugins

`/plugin`	Gérer les plugins (auto-resolve deps) NEW
`/reload-plugins`	Recharger les skills/agents/MCP sans restart
`/agents`	Onglets Running (● N) + Library NEW
`/skills`	Liste triée par tokens NEW
`/chrome`	Configurer Claude in Chrome
`/ide`	Gérer les intégrations IDE

Avancé & Remote

`/loop [interval]`	Répéter — omettre interval = self-pacing NEW
`/schedule`	Tâches planifiées sur le cloud
`/btw`	Question rapide sans outils ni historique
`/voice`	Dictée vocale push-to-talk
`/teleport`	Reprendre une session web en local
`/desktop`	Transférer vers l'app Desktop
`/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 et l'auth
`/status`	Version et infos du compte
`/usage`	Limites du plan et rate limits
`/extra-usage`	Configurer l'usage supplémentaire
`/feedback`	Soumettre un rapport (alias: /bug)
`/release-notes`	Picker interactif de version NEW
`/powerup`	Leçons animées pour apprendre Claude Code NEW
`/team-onboarding`	Générer un guide ramp-up pour un coéquipier NEW
`/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` NEW
`/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é

Modèle & Raisonnement

`--model sonnet`	Choisir le modèle (sonnet/opus/haiku)
`--model opus[1m]`	Opus + contexte 1M (1M natif sur Opus 4.7)
`--model claude-opus-4-7`	Opus 4.7 — adaptive thinking NEW
`--effort xhigh`	Niveau d'effort xhigh (100K tokens) NEW
`--effort {low..max,auto}`	low / medium / high / xhigh / max / auto
`--fallback-model`	Modèle de secours si surcharge

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
`--allowedTools`	Outils auto-approuvés
`--disallowedTools`	Outils retirés du contexte
`--tools`	Restreindre les outils built-in
`--enable-auto-mode`	Débloquer Auto dans Shift+Tab
`--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

Avancé & Remote

`--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
`--agent name`	Exécuter en tant qu'agent
`--agents`	Définir des agents via JSON
`--from-pr 42`	Reprise PR : GitHub, GitLab, Bitbucket, GH Enterprise NEW
`--fork-session`	Forker en gardant le contexte
`--teleport`	Reprendre une session web
`--mcp-config`	Charger des serveurs MCP
`--strict-mcp-config`	N'utiliser QUE ces serveurs MCP
`--plugin-dir`	Charger des plugins depuis un dossier
`--settings`	Fichier settings JSON custom
`--init / --init-only`	Lancer les hooks d'init (et exit)
`--maintenance`	Lancer les hooks de maintenance et exit
`--disable-slash-commands`	Désactiver skills et commandes
`--no-session-persistence`	Désactiver la persistance (print)
`--session-id`	UUID de session spécifique
`--agents`	Définir des agents dynamiques via JSON
`--channels`	Notifications MCP à écouter (research preview)
`--setting-sources`	Sources de settings à charger (user, project, local)
`--betas`	Beta headers pour les requêtes API

Sous-commandes CLI

`claude update`	Mettre à jour
`claude auth login`	Connexion (--email, --sso, --console, --third-party) NEW
`claude auth status`	Statut d'auth (JSON ou --text)
`claude auth logout`	Déconnecter le compte
`claude agents [list\|run]`	Lister et exécuter les agents
`claude mcp add/list/remove`	Gérer les serveurs MCP
`claude mcp add-from-claude-desktop`	Importer depuis l'app Desktop
`claude mcp add-json`	Ajouter depuis un blob JSON
`claude mcp serve`	Exposer Claude Code en serveur MCP
`claude plugin [install\|list\|marketplace]`	Gérer plugins & marketplaces
`claude auto-mode defaults`	Règles auto-mode par défaut
`claude auto-mode config`	Config effective avec settings
`claude bedrock setup`	Wizard interactif Bedrock NEW
`claude vertex setup`	Wizard interactif Vertex AI NEW

🔌 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

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.) NEW
`context: fork`	Sous-agent isolé (pas de pollution du contexte)
`paths: "*.ts"`	Activer par type de fichier
`effort: high`	Forcer la réflexion étendue
`user-invocable`	true = /command, false = Claude only
`allowed-tools`	Restreindre les outils du skill
`model`	Override du modèle par skill

Divulgation progressive : SKILL.md < 500 lignes, [ref](references/). /skills trie par coût en tokens NEW.

Builtin : code-review, security-review, simplify, init, deslopify, loop, claude-api, session-start-hook.

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é
`description`	Critère d'invocation par Claude
`effort`	Niveau d'effort du sous-agent

Invoquer : @"name (agent)" | --agent name | SendMessage to: <id>

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 (Protected Resource Metadata) NEW.

# Ajouter / Lister / Supprimer
claude mcp add playwright -- npx @playwright/mcp
claude mcp list
claude mcp remove playwright
# Import depuis Claude Desktop / JSON
claude mcp add-from-claude-desktop
claude mcp add-json '{"cmd":"..."}'
# Serveur MCP exposé par Claude Code
claude mcp serve
# Debug
claude --mcp-debug

Transports : stdio | http | sse | ws

Size override : anthropic/maxResultSizeChars jusqu'à 500K/tool NEW

Plugins : Skills + agents + hooks + MCP + bin/ sur PATH NEW. Auto-resolution des dépendances.

/plugin install name@marketplace

🖥 Computer Use — désormais dans le CLI NEW

Claude voit et contrôle votre bureau : screenshots, clics, saisie, scroll, drag & drop. Depuis v2.1.86, disponible dans le CLI (pas seulement Desktop). macOS et Windows Desktop — Linux non supporté. Multi-monitor. Pro/Max uniquement. Active dans Settings > General > Computer Use.

Sécurité : request_access obligatoire. Allowlist par app. Screenshots filtrés au compositing — seules les apps autorisées sont visibles. systemKeyCombos grant séparé.

Usage : ouvrir une app native, cliquer dans l'UI, tester des changements, vérifier sur iOS/macOS/apps GUI-only.

27 outils : screenshot, left_click, type, key, scroll, zoom, computer_batch (séquence en 1 appel), open_application, mouse_move, double_click, right_click, left_click_drag, read/write_clipboard, wait, switch_display, etc.

👁 Monitor tool NEW

Outil built-in (v2.1.98) 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, demande pour Bash
Plan	Lecture seule. Explore & comprend. N'écrit rien.
Auto	IA classifie (fast path + thinking path). Max + Opus 4.7 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. --enable-auto-mode pour débloquer Auto. Voir Row 5 pour le détail du classifier.

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)

Syntaxe : Bash(npm run *), Read(/src/**), WebFetch(domain:x.com), mcp__server__*, Edit(*.ts)

Hardening avril : Bash escape de flags, /dev/tcp, env-var prefixes ; PowerShell auto-approval à l'identique ; sandbox.failIfUnavailable.

🔗 Hooks — Automatisation

Événements (26)

Événement	Quand
`SessionStart`	Début / reprise de session
`SessionEnd`	Fin de session
`UserPromptSubmit`	Avant que Claude traite le message
`PostUserPromptSubmit`	Après submit — peut override `sessionTitle` NEW
`PreToolUse`	Avant un outil — peut bloquer (exit 2)
`PostToolUse`	Après un outil réussi — reçoit `duration_ms` NEW
`PostToolUseFailure`	Après un outil échoué
`PermissionRequest`	Dialogue de permission apparaît
`PermissionDenied`	Après refus auto-mode (`retry: true`) NEW
`Stop`	Claude finit sa réponse
`StopFailure`	Tour terminé par erreur API
`SubagentStart`	Un sous-agent démarre
`SubagentStop`	Un sous-agent termine
`TeammateIdle`	Un coéquipier va devenir inactif
`TaskCreated`	Tâche créée via TaskCreate
`TaskCompleted`	Tâche terminée
`PreCompact`	Avant la 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 répertoire de travail change (recharger env)
`WorktreeCreate`	Création d'un worktree
`WorktreeRemove`	Suppression d'un worktree
`Elicitation`	Serveur MCP demande un input
`ElicitationResult`	Réponse à une elicitation MCP

5 types de handlers

`command`	Shell command
`http`	POST vers un endpoint
`prompt`	LLM single-turn (Haiku)
`agent`	Sous-agent multi-turn
`mcp_tool`	Appel direct d'un outil MCP NEW

// Auto-format conditionnel + duration_ms logging
"PostToolUse": [{
  "matcher": "Write|Edit",
  "if": "Edit(*.ts)",
  "hooks": [{
    "type": "command",
    "command": "npx prettier --write $CLAUDE_FILE_PATHS"
  }]
}]

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

Champ if : Filtre par nom ET arguments d'outil. Ex: Bash(git *), Edit(*.ts), mcp__server__tool

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

hookSpecificOutput : {"sessionTitle": "..."} pour nommer la session depuis un hook 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

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"

# Traduire
cat README.md | claude -p "translate to Spanish"

Multi-répertoires & Worktrees

# Ajouter des répertoires
claude --add-dir ../lib --add-dir ../shared

# Worktree isolé
claude -w feature # branche git isolée

# Worktree + tmux
claude -w feature --tmux

Background & Remote

Ctrl+B pour envoyer en arrière-plan. Claude continue pendant que vous travaillez.

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

/remote-control pour rendre la session accessible à distance.

Outils agent built-in

Ce que Claude peut appeler (utilisés dans allowedTools, if, hooks) :

Filesystem	`Read`, `Write`, `Edit`, `NotebookEdit`, `Glob`, `Grep`
Shell	`Bash`, `BashOutput`, `KillBash` (+ `PowerShell` opt-in)
Web	`WebSearch`, `WebFetch`
Agents & Skills	`Agent` (Task), `Skill`, `ToolSearch`, `Monitor` NEW
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` (commité)
User	`~/.claude/settings.json` (global)

Commandes config

config listAfficher tous les settings config get keyVoir une valeur config set key valDéfinir une valeur config add key valAjouter à un tableau config remove key valRetirer d'un tableau

Variables d'environnement

`ANTHROPIC_API_KEY`	Clé API (override l'abo)
`ANTHROPIC_MODEL`	Modèle par défaut
`ANTHROPIC_SMALL_FAST_MODEL`	Modèle pour les tâches légères
`CLAUDE_CODE_EFFORT_LEVEL`	Niveau d'effort (low…xhigh/max/auto)
`CLAUDE_CODE_USE_BEDROCK`	Amazon Bedrock
`CLAUDE_CODE_USE_VERTEX`	Google Vertex AI
`CLAUDE_CODE_USE_MANTLE`	Bedrock via Mantle NEW
`CLAUDE_CODE_DISABLE_1M_CONTEXT`	Désactiver 1M context
`CLAUDE_CODE_DISABLE_AUTO_MEMORY`	Désactiver auto memory
`CLAUDE_CODE_NO_FLICKER`	1 = alt-screen (défaut v2.1.89), 0 = classique NEW
`CLAUDE_CODE_HIDE_CWD`	Masquer le cwd dans le logo de démarrage NEW
`CLAUDE_CODE_CERT_STORE`	`bundled` pour ignorer le store OS NEW
`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`	Isolation PID namespace Linux NEW
`CLAUDE_CODE_SCRIPT_CAPS`	Limite d'invocation de scripts par session NEW
`CLAUDE_CODE_PERFORCE_MODE`	Edit/Write échouent en read-only (hint `p4 edit`) NEW
`CLAUDE_CODE_USE_POWERSHELL_TOOL`	Activer/désactiver l'outil PowerShell
`ENABLE_PROMPT_CACHING_1H`	TTL prompt caching 1 heure NEW
`FORCE_PROMPT_CACHING_5M`	TTL prompt caching 5 min (test) NEW
`ENABLE_TOOL_SEARCH`	Activer ToolSearch sur Vertex AI NEW
`OTEL_LOG_TOOL_DETAILS`	Émettre tous les détails d'outils en OpenTelemetry NEW
`DISABLE_TELEMETRY`	Opt-out télémétrie
`DISABLE_AUTOUPDATER`	Désactiver les MAJ auto
`DISABLE_UPDATES`	Bloquer tous les chemins de MAJ NEW
`CLAUDE_PROJECT_DIR`	Racine du projet (injecté dans hooks)

Settings.json — champs clés

`model`	Modèle par défaut
`effort`	Niveau d'effort par défaut
`permissions.{allow,ask,deny}`	Règles de permissions
`hooks`	Hooks du cycle de vie
`allowedMcpServers`	Whitelist de serveurs MCP
`deniedMcpServers`	Blacklist de serveurs MCP
`prUrlTemplate`	Template d'URL de code review custom NEW
`sandbox.failIfUnavailable`	Forcer la disponibilité du sandbox NEW
`disableSkillShellExecution`	Bloquer le shell depuis skills/commandes/plugins NEW
`showThinkingSummaries`	Résumés de thinking (off en interactif v2.1.86) NEW
`statusLine.refreshInterval`	Relancer la status line toutes les N sec NEW
`theme`	Nom du thème ou JSON custom

Permissions avancées

// .claude/settings.json
{
  "permissions": {
    "allow": ["Read", "Bash(git *)"],
    "ask": ["Bash(npm publish *)"],
    "deny": ["Bash(rm -rf *)"]
  },
  "allowedMcpServers": ["playwright"],
  "deniedMcpServers": ["untrusted"]
}

📁 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 (SKILL.md + references/) agents/ — Sous-agents du projet rules/ — Règles scopées par fichier .mcp.json — Config MCP projet (committable)

Niveau global (`~/.claude/`)

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

Hiérarchie (5 niveaux)

Policy > Organization > User global > User local > Project

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

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% de capacité. /compact [focus] manuel avec zone de focus. CLAUDE.md relu depuis le disque.

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

Économiser : Rules scopées, sous-agents pour le verbeux, --bare, context: fork sur skills, opus[1m] (1M natif sur Opus 4.7).

Prompt caching : ENABLE_PROMPT_CACHING_1H (TTL 1h) — /context affiche les hits de cache (fix du % sur Opus 4.7 avril 2026). NEW

/resume : ~67% plus rapide sur grosses sessions (40 Mo+) depuis avril. NEW

Write tool : +60% de vitesse avril 2026. MCP startup significativement plus rapide. NEW

🤖 Auto Mode NEW

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

Disponibilité

Research preview	v2.1.83 (Week 13, 23 mars 2026)
GA Max	v2.1.92+ (Week 15) avec Opus 4.7
Team / Enterprise	Sonnet 4.6, Opus 4.6, Opus 4.7

Activation

--enable-auto-modeDébloquer au lancement Shift+TabCycler jusqu'au pill "Auto" /configRégler en persistant

Classifier — 2 chemins

Fast path : Haiku scanne « safe / risky / uncertain ». Thinking path : Opus/Sonnet reprend les cas uncertain pour réduire les faux positifs.

Hook `PermissionDenied`

"PermissionDenied": [{
  "hooks": [{
    "type": "command",
    "command": "./scripts/request-allow.sh"
  }]
}]
// stdout {"retry": true} => retry l'outil

Règles par défaut : claude auto-mode defaults. Configuration effective : claude auto-mode config.

Pas de conflit : Plan Mode reste prioritaire quand les deux sont actifs (fix avril).

🧠 Modèles & Effort Levels

Modèles disponibles

Modèle	ID	Notes
Opus 4.7	`claude-opus-4-7`	1M contexte, 64K-128K output, adaptive thinking NEW
Opus 4.6	`claude-opus-4-6`	Fast mode avec 1M contexte (avril)
Sonnet 4.6	`claude-sonnet-4-6`	Rapide & équilibré, défaut
Haiku 4.5	`claude-haiku-4-5-20251001`	Ultra-rapide, exploration, classifier

Adaptive thinking NEW

Sur Opus 4.7, la réflexion étendue est décidée par le modèle — plus de budget_tokens manuel. Indicateurs inline : "still thinking", "thinking more", "almost done thinking".

Niveaux d'effort

low medium high xhigh max auto

`low`	Questions simples, explorations
`medium`	Usage courant
`high`	Défaut API-key / Bedrock / Vertex / Team / Enterprise
`xhigh`	100K tokens — défaut Opus 4.7, MRCR v2 = 71% NEW
`max`	Budget maximum — problèmes complexes
`auto`	Research preview : classifier décide

Invoquer

--effort xhighAu lancement /effortSlider interactif (↑↓) NEW "ultrathink"Effort max ponctuel dans le prompt Option+TToggle thinking

🌍 Plateformes

CLI

macOS	Installer natif (npm ou `curl`)
Linux	Installer natif — PID namespace isolation NEW
Windows	Installer natif (plus besoin de WSL)

Desktop app NEW

Refonte du 14 avril 2026 :

Multi-session sidebar
Drag-&-drop pane layout
Terminal intégré
Fichier editor + preview HTML/PDF
Diff viewer refait
Computer Use macOS & Windows

/desktop depuis le CLI pour transférer une session vers l'app.

Web — claude.ai/code NEW

Research preview pour Pro/Max. Infrastructure cloud, sessions persistantes sur mobile. /teleport pour reprendre une session web en local.

IDE

VS Code	Extensions agentiques multiples simultanément (Copilot + Claude Code + Codex) NEW
JetBrains	Plugin Beta — diff viewer amélioré
/ide	Gérer les intégrations actives

GitHub & GitLab

/install-github-app — GitHub Actions & Code Review. --from-pr accepte GitHub, GitLab, Bitbucket, GitHub Enterprise. MCP server GitHub (mcp__github__*).

Third-party : « 3rd-party platform » sur l'écran de login. Wizards claude bedrock setup / claude vertex setup.

🎯 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 NEW 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"

/ultraplan pour déléguer la phase de plan au cloud, revoir dans le navigateur, exécuter localement. NEW

Gérer le contexte

/compact [focus]Compacter avec zone de focus /clearTâches non liées ? Réinitialiser opus[1m]Grands codebases (natif Opus 4.7) --bareQuestions rapides, skip le startup /focusVue condensée (lecture rapide) NEW

Watchers & automatisation

MonitorWatcher background, tail logs NEW /loopSelf-pacing (omettre l'intervalle) NEW Hook PostToolUseAuto-format après Edit

Techniques de prompting

Préciscat error.log | claude -p "root cause" Vérifiable"Après le fix, lance npm test" ProgressifDécouper en étapes, valider chacune Corrigez tôtCtrl+C si mauvaise direction AdaptiveSur Opus 4.7, laisser le modèle décider du thinking NEW

Patterns avancés

Worktrees	`claude -w feat --tmux`
Multi-dirs	`--add-dir ../lib`
Background	`Ctrl+B`
Agent Teams	`--teammate-mode auto`
Remote	`--remote "task"`
Loop	`/loop 5m /test` ou self-pacing
Schedule	`/schedule` pour du cron cloud
Auto Mode	Max+Opus 4.7 : classifier gère les permissions NEW
From PR	`--from-pr 42` (GitHub/GitLab/Bitbucket)

Headless / CI

claude -p --max-budget-usd 2 \
  --max-turns 5 \
  --effort xhigh "fix failing test"

OpenTelemetry : tool_use_id, tool_input_size_bytes, command_name, effort attrs 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 *)
model: sonnet
disable-model-invocation: true
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)"  # NEW
context: fork          # sous-agent isolé
paths: "src/**/*.ts"    # activer par glob
effort: high           # forcer la réflexion
user-invocable: true  # false = Claude only
allowed-tools: Read, Bash(git *)
model: sonnet
---
Instructions... + [ref](references/guide.md)

Claude décide quand l'invoquer (auto-découverte via description). /skills les trie par coût tokens.

🤖 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é
permissionMode: plan
---
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.
MAY use inline styles for one-off components.

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",
      "command": "npx prettier --write $FILE"
    }]
  }]
}

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

🔌 MCP Server — `.mcp.json`

# Ajouter via CLI
claude mcp add playwright -- npx @playwright/mcp
# Ou dans .mcp.json
{ "mcpServers": { "pg": {
  "type": "stdio",
  "command": "npx",
  "args": ["@mcp/server-postgres"]
}}}

Essentiels

Navigation & Affichage

Édition & Modèle

Mode Vim NEW

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

Avancé & Remote

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 — désormais dans le CLI NEW

👁 Monitor tool NEW

Pré-approuver des outils

Événements (26)

5 types de handlers

Pipe Input

Multi-répertoires & Worktrees

Background & Remote

Outils agent built-in

Hiérarchie (priorité décroissante)

Commandes config

Variables d'environnement

Settings.json — champs clés

Permissions avancées

Niveau projet (.claude/)

Niveau global (~/.claude/)

Hiérarchie (5 niveaux)

Options de rewind

Gestion du contexte

Disponibilité

Activation

Classifier — 2 chemins

Hook PermissionDenied

Modèles disponibles

Adaptive thinking NEW

Niveaux d'effort

Invoquer

CLI

Desktop app NEW

Web — claude.ai/code NEW

IDE

GitHub & GitLab

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

🔌 MCP Server — .mcp.json

Commandes de base

Modèles & Effort

Power Moves

Niveau projet (`.claude/`)

Niveau global (`~/.claude/`)

Hook `PermissionDenied`

📋 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`

🔌 MCP Server — `.mcp.json`