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

3. Slash Commands

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 tools autorisés, le remplacement du modèle et l’interpolation d’arguments via $ARGUMENTS ou les positions $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

Contrôles généraux

Préfixes rapides

Saisie multiligne

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

5. Fichiers de configuration

Hiérarchie de priorité (de la plus élevée à la plus basse)

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

6. Référence Settings.json

Paramètres clés avec 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:*) fournit 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/**).

Nouvelles clés (v2.1.118+) :

Pour le schéma complet des paramètres, consultez la 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.

Où il se trouve :

Ce qu’il faut 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 coûte 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 - Le CLAUDE.md des sous-dossiers est chargé lorsque Claude lit des fichiers dans ce dossier - Les règles partagées par l’équipe vont dans .claude/rules/*.md pour une organisation modulaire

8. Modes de permission

Auto Mode (v2.1.85+) est le remplacement recommandé de --dangerously-skip-permissions. La 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 passe au classificateur de sécurité. Bloqués automatiquement par défaut : curl | bash, force-push vers main, déploiements en production, suppressions massives dans le cloud, modifications IAM, envoi de données sensibles vers l’extérieur.¹

Disjoncteur : 3 blocages consécutifs ou 20 au total dans une session remettent en pause avec confirmation manuelle.

# Enable at startup
claude --enable-auto-mode

# Cycle during session
Shift+Tab    # default -> acceptEdits -> auto -> plan

Approbation automatique PowerShell (v2.1.119+) : les commandes de l’outil PowerShell sont approuvées automatiquement en mode de permission de la même façon que les commandes Bash. Les règles d’autorisation comme PowerShell(Get-*:*) évitent les confirmations pour les opérations en lecture seule. Utilisez v2.1.149+ pour les workflows très axés PowerShell ; cette version corrige les contournements de permission du cd intégré, la correspondance des règles d’autorisation par préfixe/joker et le suivi obsolète de la variable de dossier.

9. Événements de hooks

| InstructionsLoaded | CLAUDE.md chargé | Non | | ConfigChange | Le fichier de config change en cours de session | Oui | | WorktreeCreate | Worktree en cours de création | Oui | | WorktreeRemove | Worktree en cours de suppression | 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 | Boîte de dialogue de permission affichée | Oui | | PermissionDenied | Le mode auto refuse une action (v2.1.88+) | Non | | CwdChanged | Le dossier de travail change (v2.1.83+) | Non | | FileChanged | Un fichier surveillé est modifié de l’extérieur (v2.1.83+) | Non | | TaskCreated | Nouvelle tâche créée (v2.1.84+) | Non | | TeammateIdle | Un membre de l’équipe d’agents devient inactif | Oui | | TaskCompleted | Tâche 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 de sortie / entrée des hooks :

• duration_ms dans l’entrée du hook PostToolUse / PostToolUseFailure (v2.1.119+) — temps d’exécution de l’outil hors confirmations de permission et hooks PreToolUse.
• hookSpecificOutput.updatedToolOutput (v2.1.121+) — remplace la sortie d’outil pour n’importe quel outil (v2.1.118 l’a introduit pour MCP uniquement ; 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 guillemets shell.
• continueOnBlock dans les hooks PostToolUse (v2.1.139+) — renvoie la raison du blocage à Claude et poursuit le tour.
• subagent_type dans l’entrée du hook 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, titres de fenêtre et 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 projet .mcp.json :

{
  "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 compte désormais 100 millions de téléchargements mensuels et plus de 3 000 serveurs indexés.³ Pour 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 report 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+) : les serveurs MCP qui rencontrent une erreur au démarrage sont relancés jusqu’à 3 fois avant d’être marqués comme déconnectés.

SDK mcp_authenticate redirectUri (v2.1.121+) : requis pour finaliser OAuth sur les schémas d’URI personnalisés — applications de bureau et flux de connecteur claude.ai.

11.5. Commandes Plugin CLI

12. Types de subagents

Claude délègue automatiquement aux subagents. Vous pouvez aussi 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 frontmatter YAML. Jusqu’à 10 subagents peuvent s’exécuter en parallèle.⁴

claude agents ouvre Agent View dans les versions actuelles : un écran d’opérations 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+), v2.1.142 ajoute des flags de dispatch pour les sessions en arrière-plan, et v2.1.143 applique ces flags de façon 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. v2.1.144 ajoute la prise en charge de /resume pour les sessions en arrière-plan et les marque avec bg ; v2.1.145 ajoute claude agents --json, le comptage des onglets en attente de saisie et des corrections du volet de réponse d’Agent View ; 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, pas comme preuve que le travail a passé les seuils qualité.⁶

Champs de frontmatter d’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 la liste complète, consultez Variables d’environnement dans le guide complet.

14. Référence des coûts

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

Une session type consomme 50K-200K tokens d’entrée et 10K-50K tokens de sortie. Session Haiku : $0.10-$0.45. Session Opus : $0.50-$2.25.

Modèle par défaut selon le plan (Claude Code au 16 avril 2026) :

• Max, Team Premium → Opus 4.7
• Pro, Team Standard, Enterprise, Anthropic API → Sonnet 4.6 (Enterprise + API passent à Opus 4.7 le 23 avril 2026)
• Bedrock, Vertex, Foundry → Sonnet 4.5 (épingler un modèle plus récent via ANTHROPIC_DEFAULT_OPUS_MODEL)

Opus 4.7 nécessite Claude Code v2.1.111 ou ultérieur. Il utilise uniquement le raisonnement adaptatif (pas de budgets de réflexion fixes). Le nouveau niveau d’effort xhigh est le niveau par défaut pour les charges de travail de codage/agentiques sur Opus 4.7.

Changer de modèle pendant une session :

/model opus       # Switch to Opus (resolves to 4.7 on API, 4.6 on Bedrock/Vertex/Foundry)
/model sonnet     # Switch to Sonnet 4.6
/model haiku      # Switch to Haiku 4.5
/effort xhigh     # Opus 4.7 only — recommended for coding/agentic

Règle de décision : l’exploration simple va à Haiku. Le codage quotidien sensible aux coûts va à Sonnet. Le raisonnement difficile, l’architecture, les boucles agentiques et l’analyse de sécurité vont à Opus. Utilisez opusplan pour les refactorings complexes (Opus planifie, Sonnet exécute).

15. Emplacements des fichiers clés

16. Journal des modifications

17. Références

Cet aide-mémoire accompagne le guide complet Claude Code CLI pour une consultation rapide. Pour les guides pas à pas de configuration, consultez le quickstart Claude Code. Pour les projets iOS et macOS en particulier, consultez le guide de développement d’agent iOS, les schémas d’intégration XcodeBuildMCP et l’Apple Ecosystem Series. Dernière mise à jour le 24 mai 2026.