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. Options CLI

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

3. Commandes slash

Commandes personnalisées : créez .claude/commands/my-command.md (projet) ou ~/.claude/commands/my-command.md (personnel), puis invoquez-la 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

Paramètres clés avec leurs types et 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
  },
  "includeCoAuthoredBy": 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 modèles de fichiers utilisent la syntaxe glob : Edit(src/**). Depuis la v2.1.214, une règle allow à segment unique dir/** ne correspond qu’à <cwd>/dir — et non plus à tout dir/ présent n’importe où dans l’arborescence ; écrivez 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 de la même portée cwd.

Nouvelles clés (v2.1.118+) :

Pour le schéma complet des paramètres, consultez Configuration Deep Dive dans le guide complet.

7. Référence rapide CLAUDE.md

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

Emplacement :

Contenu à 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

Gardez-le facile à parcourir. Une prose dense gaspille 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, donc chaque mot consomme du contexte.

Conseils pratiques : - 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 dans les sous-répertoires sont chargés lorsque Claude lit des fichiers dans ce répertoire - Les règles partagées par l’équipe vont dans .claude/rules/*.md pour une organisation modulaire

8. Modes d’autorisation

Auto Mode (v2.1.85+) est le mode d’autorisation par défaut pour les nouvelles sessions des forfaits Pro, Max et Team depuis le 14 août 2026 (un defaultMode défini par vous-même reste en place jusqu’à ce que vous acceptiez l’invite de changement unique ; disableAutoMode le désactive à l’échelle de l’organisation). C’est le remplacement recommandé de --dangerously-skip-permissions. Les opérations en lecture seule et les modifications de fichiers sont approuvées automatiquement. Les règles personnalisées d’autorisation/refus sont résolues en premier. Tout le reste est envoyé au classificateur de sécurité. Bloqué automatiquement par défaut : curl | bash, force-push vers main, déploiements en production, suppressions massives dans le cloud, modifications IAM, envoi externe de données sensibles.¹

Disjoncteur : 3 blocages consécutifs ou 20 au total dans une session rétablissent les demandes de confirmation manuelles.

# 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 approuvées automatiquement dans les modes d’autorisation de la même manière que les commandes Bash. Les règles d’autorisation telles que PowerShell(Get-*:*) évitent les demandes de confirmation pour les opérations en lecture seule. Utilisez la v2.1.149+ pour les workflows fortement axés sur PowerShell ; elle corrige les contournements d’autorisation de cd intégré, la correspondance des règles d’autorisation par préfixe/joker et le suivi obsolète des variables de répertoire.

9. Événements de hooks

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

Pour le protocole complet des hooks (JSON d’entrée/sortie, matchers, codes de sortie), consultez Hooks Deep Dive dans le guide complet.

10. Configuration des hooks

Les hooks se trouvent dans settings.json ou dans un 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 : ajoutez "async": true à l’objet hook.²

Champs d’entrée/sortie des hooks :

• duration_ms dans l’entrée du hook PostToolUse / PostToolUseFailure (v2.1.119+) — durée d’exécution de l’outil, hors demandes d’autorisation et hooks PreToolUse.
• hookSpecificOutput.updatedToolOutput (v2.1.121+) — remplace la sortie d’outil pour n’importe quel outil (la v2.1.118 l’a introduit pour MCP uniquement ; la v2.1.121 l’étend à tous les outils).
• hookSpecificOutput.sessionTitle (v2.1.96+) — définit le titre de session depuis un hook UserPromptSubmit.
• args: string[] dans les hooks de commande (v2.1.139+) — transmet un argv structuré sans échappement shell.
• continueOnBlock dans les hooks PostToolUse (v2.1.139+) — retransmet la raison 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 du hook (v2.1.141+) — émet des séquences de contrôle du terminal pour les notifications, les titres de fenêtre et les sonneries.

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

Contrôle 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’élicitation et la configuration de la recherche d’outils, consultez la section MCP du guide complet.

alwaysLoad (v2.1.121+) : Excluez un serveur de confiance du chargement différé 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 pour SDK (v2.1.121+) : Requis pour finaliser OAuth avec des schémas d’URI personnalisés — dans les applications de bureau et les 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 dotés d’un frontmatter YAML. Jusqu’à 10 subagents peuvent s’exécuter en parallèle.⁴

Dans les versions actuelles, claude agents ouvre Agent View : un écran opérationnel en aperçu de recherche pour les sessions Claude Code en cours, bloquées et terminées. claude agents --cwd <path> limite la vue à un seul dossier (v2.1.141+), la v2.1.142 ajoute des flags de répartition pour les sessions en arrière-plan, et la v2.1.143 applique ces flags 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 inoccupées et redémarrent sur place lors des mises à jour. Utilisez Agent View pour la supervision, et non comme preuve que le travail a franchi les contrôles 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 obtenir la liste complète, consultez les variables d’environnement dans le guide intégral.

14. Référence des coûts

Tarifs par million de jetons (en septembre 2026).⁵

Une session type consomme 50K à 200K jetons d’entrée et 10K à 50K jetons de sortie. Session Haiku : $0,10 à $0,45. Session Opus : $0,50 à $2,25.

Modèle par défaut dans Claude Code (selon l’offre) : Opus 5 pour les offres premium – Max, Team Premium, Enterprise (paiement à l’usage, ainsi que les sièges d’abonnement depuis CLI v2.1.251), Anthropic API, et Bedrock / Agent Platform de Google Cloud / Claude Platform sur AWS – et Sonnet 5 pour Pro et Team Standard (Microsoft Foundry : Sonnet 4.5). L’époque où Sonnet 5 était le modèle par défaut partout depuis la v2.1.197 (30 juin 2026) est révolue ; l’alias opus pointe vers Opus 5 (v2.1.219+). Les administrateurs peuvent définir un modèle par défaut pour toute l’organisation, affiché comme « Org default » dans /model (v2.1.196+) ; sur Bedrock/Vertex/Foundry, fixez un modèle précis avec ANTHROPIC_DEFAULT_OPUS_MODEL / ANTHROPIC_DEFAULT_SONNET_MODEL.

Sonnet 5, Opus 5, Opus 4.8, Fable 5 et Fable 5.1 utilisent uniquement le raisonnement adaptatif (sans budgets de réflexion fixes). Pour tous, effort est défini par défaut sur high, avec /effort xhigh pour les tâches de programmation ou agentiques les plus difficiles. 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) ne s’applique qu’à Opus 5 et Opus 4.8 depuis la v2.1.219 — $10 / $50 par MTok (2× le tarif de base) pour atteindre jusqu’à 2,5× plus de jetons de sortie par seconde. Opus 4.7 a été supprimé : claude-opus-4-7 + speed: "fast" renvoie désormais une erreur au lieu de revenir à la vitesse standard. Version préliminaire de recherche, réservée à Claude API (non disponible sur Bedrock/Vertex/Foundry) ; changer de vitesse invalide le cache de prompts.

Changer de modèle pendant une session :

/model opus       # Switch to Opus 5 (v2.1.219+)
/model sonnet     # Switch to Sonnet 5 (default on Pro/Team Standard)
/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 la programmation quotidienne à moindre coût, 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.