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 l’état de votre mode automatique 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 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
  },
  "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 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 de la même restriction au répertoire de travail courant.

Nouvelles clés (v2.1.118+) :

Pour consulter le schéma complet des paramètres, reportez-vous à l’analyse approfondie de la configuration dans le 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 :

É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

Facilitez-en la lecture rapide. 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 occupe 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-répertoires sont chargés lorsque Claude lit des fichiers dans le répertoire concerné - Placez les règles partagées par l’équipe dans .claude/rules/*.md pour une organisation modulaire

8. Modes d’autorisation

Auto Mode (v2.1.85+) est le remplacement recommandé de --dangerously-skip-permissions. Les opérations en lecture seule et les modifications de fichiers sont automatiquement approuvées. Les règles personnalisées d’autorisation et de refus sont évaluées en premier. Tout le reste est soumis au classificateur de sécurité. Sont bloqués automatiquement par défaut : curl | bash, le force-push vers la branche principale, les déploiements en production, les suppressions massives dans le cloud, les modifications IAM et l’envoi externe de données sensibles.¹

Disjoncteur : après 3 blocages consécutifs ou 20 au total pendant une session, le système revient aux 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 de PowerShell (v2.1.119+) : les commandes de l’outil PowerShell sont automatiquement approuvées selon le mode d’autorisation, comme les commandes Bash. Des règles d’autorisation telles que PowerShell(Get-*:*) évitent les demandes de confirmation pour les opérations en lecture seule. Pour les workflows qui utilisent beaucoup PowerShell, utilisez la v2.1.149 ou ultérieure ; elle corrige le contournement des autorisations par la commande intégrée cd, la correspondance des règles d’autorisation par préfixe et caractère générique, ainsi que le suivi obsolète des variables de répertoire.

9. Événements des hooks

| InstructionsLoaded | Lorsque CLAUDE.md est chargé | Non | | ConfigChange | Lorsqu’un fichier de configuration change pendant la session | Oui | | DirectoryAdded | Lorsque /add-dir ou register_repo_root de SDK ajoute un répertoire de travail pendant la 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 | Lorsqu’une boîte de dialogue d’autorisation s’affiche | Oui | | PermissionDenied | Lorsque Auto Mode 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é en 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/sortie, matchers, codes de sortie), reportez-vous à l’analyse approfondie des hooks dans le guide complet.

10. Configuration des hooks

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

Champs d’entrée/sortie des hooks :

• duration_ms dans l’entrée des hooks 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 de n’importe quel outil (la v2.1.118 a introduit cette fonctionnalité pour MCP uniquement ; 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 tableau argv structuré sans échappement pour le 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 du hook (v2.1.141+) — émet des séquences de contrôle du terminal pour les notifications, les titres de fenêtre et les signaux 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

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 consulter la liste complète, reportez-vous à la section Variables d’environnement du guide complet.

14. Référence des coûts

Tarifs par million de tokens (en juillet 2026).⁵

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

Modèle par défaut dans Claude Code (depuis la v2.1.197, 30 juin 2026) : Sonnet 5 pour toutes les nouvelles sessions — contexte natif de 1M, tarif de lancement de 2 $/10 $ jusqu’au 31 août — tandis qu’Opus reste accessible avec une seule commande /model opus (depuis la v2.1.219, cet alias sélectionne Opus 5). 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, épinglez un modèle précis avec ANTHROPIC_DEFAULT_OPUS_MODEL / ANTHROPIC_DEFAULT_SONNET_MODEL.

Sonnet 5, Opus 5, Opus 4.8 et Fable 5 utilisent uniquement le raisonnement adaptatif, sans budget de réflexion fixe. effort est défini par défaut sur high pour tous ces modèles, avec /effort xhigh pour les tâches de codage et 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 l’utilisation de thinking: {type: "disabled"} avec un effort xhigh ou max renvoie une erreur 400.

Le mode rapide (/fast) s’applique uniquement à Opus 5 et Opus 4.8 depuis la v2.1.219 — 10 $/50 $ par million de tokens (2 fois le tarif de base) pour produire jusqu’à 2,5 fois 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. Version expérimentale, réservée à Claude API (non disponible sur Bedrock/Vertex/Foundry) ; changer de vitesse invalide le cache des prompts.

Changer de modèle pendant une session :

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

Règle de décision : utilisez Haiku pour les explorations simples, Sonnet pour le codage quotidien à coût maîtrisé, et Opus pour les raisonnements complexes, l’architecture, les boucles agentiques et les analyses de sécurité. Utilisez opusplan pour les refactorisations complexes : Opus établit le plan, puis Sonnet l’exécute.

15. Emplacements des fichiers clés

16. Journal des modifications

17. Références

Cette fiche pratique accompagne le guide complet de Claude Code CLI pour vous permettre de retrouver rapidement les informations essentielles. Pour suivre 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.