Guide Claude Code

Verrouille Claude en mode lecture seule strict. Il peut lire, explorer et poser des questions, mais ne peut ni écrire, ni modifier, ni supprimer de fichier. S'active via Shift+Tab pour cycler entre les modes (default → auto-accept → plan), ou au lancement avec `--permission-mode plan`.

Cycle entre les modes de permission pendant une session active. L'ordre est : Default → Auto-Accept Edits (⏵⏵) → Plan Mode (⏸) → retour à Default. Chaque mode change le niveau d'autonomie de Claude. En Default, Claude demande avant chaque action. En Auto-Accept, il édite librement mais demande pour les commandes shell. En Plan, il ne peut que lire et proposer.

Résume la conversation en cours et libère de l'espace dans la fenêtre de contexte. Claude supprime d'abord les anciens résultats d'outils, puis résume la conversation si nécessaire. Les requêtes clés et les extraits de code importants sont préservés. Auto-compact se déclenche automatiquement quand le contexte est plein.

Lance un assistant qui guide la création d'un fichier CLAUDE.md à la racine du projet. Ce fichier contient les instructions persistantes que Claude charge à chaque session : conventions de code, commandes fréquentes, contexte projet, règles à suivre.

Lance un diagnostic de l'installation de Claude Code. Vérifie les problèmes courants de configuration, d'environnement et de dépendances. Fait partie des trois commandes guidées de setup avec /init (créer un CLAUDE.md) et /agents (configurer des subagents).

Le préfixe @ permet d'inclure du contenu directement dans ton message sans attendre que Claude lise les fichiers. @fichier.js → injecte le contenu complet du fichier. @dossier/ → affiche la liste des fichiers du dossier avec leurs infos (pas le contenu). @serveur:ressource → récupère des données depuis un serveur MCP connecté. Les références @ déclenchent aussi le chargement des CLAUDE.md du dossier référencé et de ses parents.

Claude Code accepte des images directement dans le terminal. Trois méthodes : drag & drop d'un fichier image dans la fenêtre du terminal, Ctrl+V pour coller depuis le presse-papier (pas Cmd+V), ou donner le chemin du fichier dans le message. Claude peut analyser des maquettes UI, des screenshots d'erreurs, des diagrammes d'architecture, et générer du code correspondant.

Fichier Markdown lu par Claude au début de chaque session. Il peut exister à plusieurs niveaux : global (~/.claude/CLAUDE.md), projet (CLAUDE.md ou .claude/CLAUDE.md), et local (CLAUDE.local.md). Les niveaux se combinent : le global s'applique partout, le projet est partagé avec l'équipe via git, le local est personnel et gitignored.

Fichier JSON de configuration avec un système de scopes hiérarchiques. 4 niveaux : Managed (IT, priorité max) > Local (.claude/settings.local.json) > Project (.claude/settings.json, commité) > User (~/.claude/settings.json). Configure les permissions (allow/deny), le mode par défaut, les hooks, le modèle, les variables d'environnement, et des dizaines d'autres options.

Les hooks sont des commandes shell configurées dans settings.json qui s'exécutent automatiquement en réponse à des événements du cycle de vie de Claude Code. Événements disponibles : Notification (Claude attend une action), PreToolUse/PostToolUse (avant/après un outil), WorktreeCreate/WorktreeRemove (gestion des worktrees), ConfigChange (modification de config).

Le sandbox active un isolement OS-level pour les commandes bash : restrictions filesystem (lecture/écriture limitées au dossier de travail par défaut) et réseau (seulement les domaines approuvés via proxy). Deux modes : auto-allow (commandes sandboxées approuvées automatiquement) et regular permissions (demander quand même). macOS utilise Seatbelt, Linux et WSL2 utilisent bubblewrap + socat. WSL1 non supporté.

L'auto-mémoire permet à Claude d'accumuler des connaissances entre sessions sans que tu écrives quoi que ce soit. Claude décide lui-même ce qui mérite d'être retenu : commandes de build, insights de debug, conventions de code, préférences. Les notes sont dans ~/.claude/projects/<projet>/memory/ : un fichier MEMORY.md (index) + des fichiers thématiques. Les 200 premières lignes de MEMORY.md (ou 25Ko) sont chargées au démarrage de chaque session. Requiert Claude Code v2.1.59+.

Le Model Context Protocol (MCP) permet de connecter Claude Code à des services externes : GitHub, bases de données, APIs, navigateur, etc. Les serveurs MCP se configurent dans ~/.claude.json (scope user) ou .mcp.json (scope projet). Chaque serveur expose des outils que Claude peut utiliser comme ses outils natifs. Les définitions d'outils sont différées : seuls les noms sont chargés au départ, le schéma complet est récupéré à la demande.

Les slash commands personnalisées sont des fichiers Markdown dans .claude/commands/ (projet) ou ~/.claude/commands/ (global). Chaque fichier .md devient une commande invocable avec /nom-du-fichier. Le contenu du fichier est injecté comme prompt. Supporte les variables $ARGUMENTS pour passer des paramètres.

Les subagents sont des assistants IA spécialisés qui tournent dans leur propre fenêtre de contexte, avec un system prompt personnalisé, des outils spécifiques et des permissions indépendantes. Quand Claude rencontre une tâche qui correspond à la description d'un subagent, il lui délègue automatiquement. Les résultats reviennent sous forme de résumé dans la session principale. Le travail du subagent ne gonfle pas ton contexte principal.

Claude Code sauvegarde chaque conversation localement. Tu peux reprendre une session avec --continue (la plus récente), --resume (sélecteur interactif ou par nom), ou --from-pr <numéro> (session liée à une PR). Le contexte complet est restauré : historique, résultats d'outils, état de la conversation. Les permissions de session ne sont pas restaurées — il faut les ré-approuver.

Le flag --worktree (-w) crée une copie isolée du repo dans .claude/worktrees/<nom>/ avec sa propre branche (worktree-<nom>). Chaque session travaille sur des fichiers séparés sans collision. Les worktrees sans modifications sont supprimés automatiquement en quittant. Les subagents peuvent aussi utiliser des worktrees avec isolation: worktree.

Extended thinking est activé par défaut. Il donne à Claude un espace de raisonnement interne avant de répondre. Opus 4.6 et Sonnet 4.6 utilisent le raisonnement adaptatif : le modèle alloue dynamiquement les tokens de réflexion selon le niveau d'effort. Le raisonnement est visible en mode verbose (Ctrl+O). Le mot 'ultrathink' dans un prompt force le niveau d'effort à high pour ce tour.

Le flag -p (ou --print) exécute Claude Code en mode non-interactif : Claude traite le prompt et retourne le résultat sans attendre d'input. Anciennement appelé 'headless mode', c'est désormais l'interface CLI de l'Agent SDK. Supporte tous les flags : --output-format (text/json/stream-json), --allowedTools, --permission-mode, --continue, --resume, --append-system-prompt, --json-schema. Idéal pour les pipelines CI/CD, scripts shell et automatisation.

Claude Code a 4 modes de permission qui contrôlent son niveau d'autonomie. Default : Claude demande avant chaque édition et commande. Auto-Accept Edits : Claude édite librement, demande pour les commandes shell. Plan Mode : lecture seule, Claude ne peut que lire et proposer. Auto Mode (research preview) : Claude évalue les actions avec des vérifications de sécurité automatiques en arrière-plan.

La fenêtre de contexte contient l'historique de conversation, le contenu des fichiers lus, les résultats de commandes, CLAUDE.md, l'auto-mémoire, les skills chargés et les instructions système. Quand elle se remplit, Claude compacte automatiquement : il supprime d'abord les anciens résultats d'outils, puis résume la conversation. Les requêtes clés sont préservées, mais les instructions du début peuvent se perdre.