Aide-mémoire Claude Code : commandes, configuration et raccourcis

Chaque flag CLI, commande slash, raccourci clavier, clé de configuration, événement de hook et variable d’environnement au même endroit. Pour des explications approfondies, consultez le guide Claude Code complet. Pour une première installation, consultez le démarrage rapide.

1. Installation

Trois méthodes d’installation, par ordre de préférence.

# Native binary (recommended)
curl -fsSL https://claude.ai/install.sh | bash

# Homebrew (macOS)
brew install --cask claude-code

# NPM (deprecated — migrate with `claude install`)
npm install -g @anthropic-ai/claude-code

Installer une version spécifique :

curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58

Vérifier l’installation :

claude doctor
claude --version

S’authentifier :

claude auth login       # Log in or switch accounts
claude auth status      # Check current auth state
claude auth logout      # Clear stored credentials

2. Flags CLI

Sous-commande ajoutée dans la v2.1.212 : claude auto-mode reset réinitialise l’état d’Auto Mode depuis le terminal ; utilisez --yes pour ignorer la demande de confirmation.⁷

3. Slash Commands

Commandes personnalisées : créez .claude/commands/my-command.md (projet) ou ~/.claude/commands/my-command.md (personnel), puis appelez la commande avec /my-command. Les commandes prennent en charge le frontmatter YAML pour la description, les outils autorisés, le remplacement du modèle et l’interpolation des arguments via $ARGUMENTS ou les paramètres positionnels $1, $2.

---
description: Fix a GitHub issue
allowed-tools: Read, Edit, Bash(git:*)
model: opus
argument-hint: [issue-number]
---

Fix GitHub issue #$ARGUMENTS following our coding standards.

Utilisation : /fix-issue 123

4. Raccourcis clavier

Commandes générales

Préfixes rapides

Saisie multiligne

Les raccourcis clavier sont personnalisables via /keybindings (stockés dans ~/.claude/keybindings.json).

5. Fichiers de configuration

Ordre de priorité (du plus élevé au plus faible)

La première correspondance l’emporte. Les paramètres d’entreprise ne peuvent pas être contournés.

6. Référence de Settings.json

Principaux paramètres, avec leurs types et des exemples. Placez-les dans n’importe quel fichier de paramètres de la hiérarchie ci-dessus.

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "model": "claude-sonnet-4-6",
  "permissions": {
    "allow": ["Read", "Glob", "Grep", "Bash(npm run:*)", "Bash(git:*)", "Edit(src/**)"],
    "deny": ["Read(.env*)", "Bash(rm -rf:*)", "Bash(sudo:*)"],
    "ask": ["WebFetch", "Bash(docker:*)"],
    "defaultMode": "acceptEdits",
    "additionalDirectories": ["../shared-lib"]
  },
  "env": {
    "NODE_ENV": "development"
  },
  "hooks": {},
  "sandbox": {
    "enabled": false,
    "autoAllowBashIfSandboxed": true
  },
  "cleanupPeriodDays": 30,
  "respectGitignore": true,
  "showTurnDuration": true,
  "language": "en",
  "autoMemoryDirectory": ".claude/memory",
  "plansDirectory": ".claude/plans"
}

Syntaxe des règles d’autorisation : Tool(pattern:*) permet une correspondance par préfixe. Bash(npm run test:*) autorise npm run test, npm run test:unit, etc. Les motifs de fichiers utilisent la syntaxe glob : Edit(src/**). Depuis la v2.1.214, une règle allow dir/** à segment unique correspond uniquement à <cwd>/dir — et non plus à n’importe quel dir/ dans l’arborescence ; utilisez Edit(**/src/**) pour une correspondance à n’importe quelle profondeur. Les règles deny/ask conservent la correspondance à n’importe quelle profondeur, et les conditions if: des hooks bénéficient du même cadrage sur le cwd.

Nouvelles clés (v2.1.118+) :

Pour consulter le schéma complet des paramètres, reportez-vous à la section Présentation détaillée de la configuration du guide complet.

7. Référence rapide de CLAUDE.md

CLAUDE.md est le fichier d’instructions de votre projet. Claude le lit au début de chaque session.

Emplacements possibles :

AGENTS.md (v2.1.277+) : dans un projet dépourvu de CLAUDE.md, Claude Code lit AGENTS.md à la place – modifiez ce comportement sous « Project instructions » dans /config (pas encore disponible sur Bedrock/Vertex/Foundry).

Éléments à inclure :

# Project Name

## Stack
- Backend: FastAPI, Python 3.11+
- Frontend: HTMX + Alpine.js + Bootstrap 5

## Commands
- Dev: `uvicorn app.main:app --reload --port 8000`
- Test: `python -m pytest -v`
- Lint: `ruff check .`

## Conventions
- Conventional commits: feat:, fix:, docs:, refactor:
- Never force push to main
- Always activate venv before Python commands

## Key Files
- app/main.py — FastAPI app and routes
- app/models.py — SQLAlchemy models

Veillez à ce qu’il reste facile à parcourir. Une prose dense consomme inutilement des tokens de contexte à chaque session. Utilisez des listes à puces, des tableaux et de courts blocs de code. Évitez les longs paragraphes — Claude lit CLAUDE.md au début de chaque session, chaque mot consomme donc du contexte.

Conseils avancés : - Utilisez le préfixe # dans le REPL pour ajouter des éléments à la mémoire automatique sans modifier CLAUDE.md : # Always use TypeScript strict mode - Les fichiers CLAUDE.md des sous-dossiers sont chargés lorsque Claude lit des fichiers dans le dossier concerné - Placez les règles partagées par l’équipe dans .claude/rules/*.md afin de les organiser de manière modulaire

8. Modes d’autorisation

Le mode Auto (v2.1.85+) est le mode d’autorisation par défaut des nouvelles sessions avec les abonnements Pro, Max et Team depuis le 14 août 2026 (une valeur defaultMode que vous avez vous-même définie reste active jusqu’à ce que vous acceptiez l’invite de basculement unique ; disableAutoMode désactive ce mode pour toute l’organisation). Il constitue le remplacement recommandé de --dangerously-skip-permissions. Les opérations en lecture seule et les modifications de fichiers sont approuvées automatiquement ; depuis la v2.1.281, où l’évaluation par le classificateur s’effectue côté serveur, les commandes shell en lecture seule et exécutées dans la sandbox attendent également cette évaluation et sont bloquées si elles sont signalées. Les règles allow/deny personnalisées sont traitées en premier. Tout le reste est soumis au classificateur de sécurité. Actions bloquées automatiquement par défaut : curl | bash, force-push sur la branche principale, déploiements en production, suppressions massives dans le cloud, modifications IAM et envoi externe de données sensibles.¹

Disjoncteur : après 3 blocages consécutifs ou 20 au total au cours d’une session, le système revient aux demandes de confirmation manuelles.

Commandes rm dangereuses dans les modes sans surveillance (v2.1.281) : en mode auto et avec --dangerously-skip-permissions, l’invite liée à une commande rm dangereuse attend 2 minutes, puis refuse la commande en suggérant une reformulation afin que la session puisse continuer. Une commande rm récursive dont la cible provient uniquement du résultat d’une substitution de commande, telle que rm -rf "$(pwd)", demande désormais une confirmation même lorsqu’une règle allow Bash s’applique.

# Enable at startup (--enable-auto-mode was removed in v2.1.111)
claude --permission-mode auto

# Cycle during session
Shift+Tab    # Manual (aka default) -> acceptEdits -> auto -> plan

Approbation automatique PowerShell (v2.1.119+) : les commandes de l’outil PowerShell sont automatiquement approuvées selon le mode d’autorisation, comme les commandes Bash. Les règles allow telles que PowerShell(Get-*:*) évitent les demandes de confirmation pour les opérations en lecture seule. Utilisez la v2.1.149 ou ultérieure pour les workflows faisant un usage intensif de PowerShell ; elle corrige le contournement des autorisations par la commande intégrée cd, la correspondance des règles allow avec les préfixes et caractères génériques, ainsi que le suivi obsolète des variables de dossier.

9. Événements des hooks

| InstructionsLoaded | Au chargement de CLAUDE.md | Non | | ConfigChange | Lorsque le fichier de configuration change en cours de session | Oui | | DirectoryAdded | Lorsque /add-dir ou register_repo_root de SDK ajoute un répertoire de travail en cours de session (v2.1.219+) | Non | | WorktreeCreate | Lors de la création d’un worktree | Oui | | WorktreeRemove | Lors de la suppression d’un worktree | Non | | PreCompact | Avant la compaction du contexte | Non | | PostCompact | Après la compaction du contexte | Non | | Elicitation | Lorsque MCP demande une saisie structurée | Oui | | ElicitationResult | Lorsque l’utilisateur répond à la boîte de dialogue de MCP | Oui | | StopFailure | Lorsque le tour se termine en raison d’une erreur API | Non | | PermissionRequest | Lorsque la boîte de dialogue d’autorisation s’affiche | Oui | | PermissionDenied | Lorsque le mode automatique refuse une action (v2.1.88+) | Non | | CwdChanged | Lorsque le répertoire de travail change (v2.1.83+) | Non | | FileChanged | Lorsqu’un fichier surveillé est modifié par un processus externe (v2.1.83+) | Non | | TaskCreated | Lorsqu’une nouvelle tâche est créée (v2.1.84+) | Non | | TeammateIdle | Lorsqu’un membre de l’équipe d’agents devient inactif | Oui | | TaskCompleted | Lorsqu’une tâche est marquée comme terminée | Oui |

Pour consulter le protocole complet des hooks (JSON d’entrée et de sortie, matchers, codes de sortie), reportez-vous à l’analyse approfondie des hooks dans le guide complet.

10. Configuration des hooks

Les hooks sont définis dans settings.json ou dans un fichier hooks.json dédié. Exemple minimal :

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "npx prettier --write \"$FILE_PATH\""
          }
        ]
      }
    ],
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": ".claude/hooks/validate-bash.sh"
          }
        ]
      }
    ]
  }
}

Syntaxe des matchers :

Codes de sortie :

Les hooks asynchrones s’exécutent en arrière-plan sans bloquer l’opération : ajoutez "async": true à l’objet du hook.²

Champs d’entrée et de sortie des hooks :

• duration_ms dans l’entrée des hooks PostToolUse / PostToolUseFailure (v2.1.119+) — temps d’exécution de l’outil, hors demandes d’autorisation et hooks PreToolUse.
• hookSpecificOutput.updatedToolOutput (v2.1.121+) — remplace la sortie de n’importe quel outil (la v2.1.118 avait introduit cette fonctionnalité uniquement pour MCP ; la v2.1.121 l’étend à tous les outils).
• hookSpecificOutput.sessionTitle (v2.1.96+) — définit le titre de la session depuis un hook UserPromptSubmit.
• args: string[] dans les hooks de commande (v2.1.139+) — transmet un argv structuré sans échappement du shell.
• continueOnBlock dans les hooks PostToolUse (v2.1.139+) — renvoie le motif du blocage à Claude et poursuit le tour.
• subagent_type dans l’entrée des hooks d’agent (v2.1.140+) — identifie le type d’agent en cours d’exécution.
• terminalSequence dans la sortie JSON des hooks (v2.1.141+) — émet des séquences de contrôle du terminal pour les notifications, les titres de fenêtre et les alertes sonores.

11. Configuration rapide de MCP

Ajoutez un serveur MCP en une seule commande :

# Remote HTTP server (recommended)
claude mcp add --transport http github https://api.githubcopilot.com/mcp/

# Remote with auth header
claude mcp add --transport http api https://api.example.com/mcp \
  --header "Authorization: Bearer $TOKEN"

# Local stdio server
claude mcp add --transport stdio postgres \
  --env "DATABASE_URL=postgresql://user:pass@localhost/db" \
  -- npx -y @anthropic-ai/mcp-server-postgres

Gestion de la portée :

claude mcp add --scope project ...   # Team-shared (.mcp.json)
claude mcp add --scope user ...      # Personal (~/.claude.json)

Exemple de fichier .mcp.json de projet :

{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    },
    "database": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-server-postgres"],
      "env": {
        "DATABASE_URL": "postgresql://user:pass@localhost/db"
      }
    }
  }
}

MCP totalise désormais 100 millions de téléchargements mensuels et plus de 3 000 serveurs indexés.³ Pour en savoir plus sur les types de transport, l’elicitation et la configuration de la recherche d’outils, consultez la section consacrée à MCP dans le guide complet.

alwaysLoad (v2.1.121+) : Excluez un serveur de confiance du report par Tool Search. Tous ses outils sont chargés au démarrage de la session, sans aller-retour ToolSearch :

{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/",
      "alwaysLoad": true
    }
  }
}

Nouvelle tentative automatique (v2.1.121+) : En cas d’erreur au démarrage, les serveurs MCP font l’objet de 3 nouvelles tentatives au maximum avant d’être marqués comme déconnectés.

redirectUri de mcp_authenticate dans SDK (v2.1.121+) : Requis pour terminer OAuth avec des schémas d’URI personnalisés — applications de bureau et flux de connecteurs claude.ai.

11.5. Commandes CLI des plugins

12. Types de subagents

Claude délègue automatiquement des tâches aux subagents. Vous pouvez également les demander explicitement :

> Use the explore agent to find all auth-related files
> Have a subagent analyze the database schema

Les subagents personnalisés sont définis dans .claude/agents/ (projet) ou ~/.claude/agents/ (personnel), sous forme de fichiers markdown avec un frontmatter YAML. Jusqu’à 10 subagents peuvent s’exécuter en parallèle.⁴

Dans les versions actuelles, claude agents ouvre Agent View : une interface d’exploitation en version préliminaire dédiée à la recherche, qui présente les sessions Claude Code en cours, bloquées et terminées. claude agents --cwd <path> limite la vue à un seul répertoire (v2.1.141+) ; la v2.1.142 ajoute des flags de lancement pour les sessions en arrière-plan, tandis que la v2.1.143 les applique de manière cohérente au tableau de bord et aux sessions en arrière-plan : --add-dir, --settings, --mcp-config, --plugin-dir, --permission-mode, --model, --effort et --dangerously-skip-permissions. La v2.1.144 ajoute la prise en charge de /resume pour les sessions en arrière-plan et les signale avec bg ; la v2.1.145 ajoute claude agents --json, le nombre d’éléments en attente de saisie dans les onglets et des correctifs pour le volet de réponse d’Agent View ; la v2.1.147 ajoute des sessions en arrière-plan épinglées, qui restent actives lorsqu’elles sont inactives et redémarrent sur place pour les mises à jour. Utilisez Agent View pour la surveillance, et non comme preuve que le travail a satisfait aux critères de qualité.⁶

Champs du frontmatter d’un agent personnalisé :

Exemple d’agent personnalisé (.claude/agents/security-reviewer.md) :

---
name: security-reviewer
description: Expert security code reviewer. Use PROACTIVELY after code changes to auth or data handling.
tools: Read, Grep, Glob, Bash
model: opus
permissionMode: plan
---

You are a senior security engineer. Analyze for OWASP Top 10 vulnerabilities,
secrets, hardcoded credentials, and SQL injection. Report findings with severity
levels and remediation steps.

13. Variables d’environnement

Authentification et API

Configuration du modèle

Fournisseurs cloud

Contrôle du comportement

Configuration des outils

Réseau et proxy

Pour consulter la liste complète, reportez-vous à la section Variables d’environnement du guide intégral.

14. Référence des coûts

Tarification par million de tokens (en septembre 2026).⁵

Une session type consomme entre 50 K et 200 K tokens d’entrée et entre 10 K et 50 K tokens de sortie. Session Haiku : $0,10-$0,45. Session Opus 5.5 : $0,40-$1,80.

Modèle par défaut dans Claude Code (selon l’offre) : Opus pour toutes les offres depuis la v2.1.280 (22 septembre 2026) — Pro et Team Standard sont passées de Sonnet à Opus, comme Max, Team Premium et Enterprise — et le modèle Opus par défaut est Opus 5.5 (claude-opus-5-5), désormais ciblé par l’alias opus. La répartition introduite par la v2.1.251 (Opus 5 pour les offres premium, Sonnet 5 pour Pro/Team Standard) et Sonnet 5 comme modèle par défaut universel depuis la v2.1.197 appartiennent au passé. Les administrateurs peuvent définir un modèle par défaut pour toute l’organisation, affiché sous « Modèle par défaut de l’organisation » dans /model (v2.1.196+). Claude Platform sur AWS, Amazon Bedrock et Agent Platform de Google Cloud utilisent également Opus 5.5 par défaut ; Microsoft Foundry constitue la seule exception (Sonnet 4.5 par défaut et seul environnement où opus correspond à Opus 4.6) — épinglez un modèle précis avec ANTHROPIC_DEFAULT_OPUS_MODEL / ANTHROPIC_DEFAULT_SONNET_MODEL.

Opus 5.5, Sonnet 5, Opus 5, Opus 4.8, Fable 5 et Fable 5.1 utilisent exclusivement le raisonnement adaptatif (aucun budget de réflexion fixe), avec /effort xhigh pour les tâches de développement et agentiques les plus exigeantes. La valeur par défaut de effort est high pour tous ces modèles, sauf Opus 5.5, dont la valeur par défaut est medium — et depuis la v2.1.280, un niveau d’effort enregistré avant que /effort ne devienne propre à chaque modèle ne s’applique plus aux nouveaux modèles tels qu’Opus 5.5 ; celui-ci commence donc avec sa propre valeur par défaut jusqu’à ce que vous en choisissiez une. La réflexion ne peut pas être désactivée sur Opus 5.5 ni sur les modèles Fable (MAX_THINKING_TOKENS=0 n’y produit aucun effet). Changements incompatibles d’Opus 5 par rapport à Opus 4.8 : la réflexion est activée par défaut pour les requêtes qui omettent le champ thinking, et thinking: {type: "disabled"} avec un effort xhigh ou max renvoie une erreur 400.

Le mode rapide (/fast) s’applique à Opus 5.5, Opus 5 et Opus 4.8, Opus 5.5 étant le modèle par défaut depuis la v2.1.280 — $8 / $40 par MTok avec Opus 5.5, $10 / $50 avec Opus 5 et 4.8 (2× le tarif de base dans chaque cas) pour atteindre jusqu’à 2,5× plus de tokens de sortie par seconde. Opus 4.7 a été supprimé : claude-opus-4-7 + speed: "fast" génère désormais une erreur au lieu de revenir à la vitesse standard. Disponible en aperçu de recherche, uniquement avec Claude API et les abonnements (pas avec Bedrock/Vertex/Foundry ni Claude Platform sur AWS) ; changer de vitesse invalide le cache de prompts. Depuis la v2.1.271, le mode rapide fonctionne également dans les sessions Claude Code Remote (runners cloud et auto-hébergés) : le paramètre de mode rapide de l’hôte ou /fast saisi dans la session s’applique lorsque votre organisation l’autorise.

Changer de modèle pendant une session :

/model opus       # Switch to Opus 5.5 (v2.1.280+)
/model sonnet     # Switch to Sonnet 5
/model haiku      # Switch to Haiku 4.5
/model fable      # Switch to Fable 5.1 (tier above Opus, v2.1.257+)
/effort xhigh     # Recommended for the hardest coding/agentic work

Règle de décision : utilisez Haiku pour l’exploration simple. Pour le développement quotidien à coût maîtrisé, choisissez Sonnet. Réservez Opus au raisonnement complexe, à l’architecture, aux boucles agentiques et à l’analyse de sécurité. Utilisez opusplan pour les refactorisations complexes (Opus planifie, Sonnet exécute).

15. Emplacements des fichiers clés

16. Journal des modifications

17. Références

Cet aide-mémoire est le compagnon de consultation rapide du guide complet de Claude Code CLI. Pour découvrir les étapes de configuration, consultez le guide de démarrage rapide de Claude Code. Pour les projets iOS et macOS en particulier, consultez le guide de développement avec des agents pour iOS, les modèles d’intégration de XcodeBuildMCP et la série sur l’écosystème Apple. Dernière mise à jour le 17 juillet 2026.