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

3 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

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

Entrée multiligne

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

5. Fichiers de configuration

Hiérarchie de précédence (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 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 le 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 :

À 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 avancés : - Utilisez le préfixe # dans le REPL pour ajouter des éléments à l’auto-memory 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 d’autorisation

Mode auto (v2.1.85+) 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 appliquées en premier. Tout le reste passe par le classificateur de sécurité. Bloqués automatiquement par défaut : curl | bash, force-push vers main, déploiements en production, suppressions cloud massives, modifications IAM, envoi de données sensibles vers l’extérieur.¹

Disjoncteur : 3 blocages consécutifs ou 20 au total dans une session repassent en demandes manuelles.

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

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

Approbation automatique PowerShell (v2.1.119+) : les commandes du tool PowerShell sont approuvées automatiquement en mode d’autorisation de la même façon que les commandes Bash. Les règles d’autorisation comme PowerShell(Get-*:*) évitent les demandes de confirmation pour les opérations en lecture seule.

9. Événements de hooks

| InstructionsLoaded | CLAUDE.md chargé | Non | | ConfigChange | Le fichier de configuration 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 à cause d’une erreur API | Non | | PermissionRequest | Une boîte de dialogue d’autorisation s’affiche | 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 | 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 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 async s’exécutent en arrière-plan sans bloquer : ajoutez "async": true à l’objet hook.²

Champs de sortie / entrée des hooks :

• duration_ms sur l’entrée des hooks PostToolUse / PostToolUseFailure (v2.1.119+) — temps d’exécution du tool, hors demandes d’autorisation et hooks PreToolUse.
• hookSpecificOutput.updatedToolOutput (v2.1.121+) — remplace la sortie du tool pour n’importe quel tool (v2.1.118 l’a introduit uniquement pour MCP ; v2.1.121 l’étend à tous les tools).
• hookSpecificOutput.sessionTitle (v2.1.96+) — définit le titre de la session depuis un hook UserPromptSubmit.
• args: string[] sur les hooks de commande (v2.1.139+) — transmet un argv structuré sans shell quoting.
• continueOnBlock sur les hooks PostToolUse (v2.1.139+) — renvoie la raison du blocage à Claude et continue le tour.
• subagent_type sur l’entrée des hooks d’agent (v2.1.140+) — identifie le type d’agent en cours d’exécution.

11. Configuration rapide MCP

Ajoutez un serveur MCP avec 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 .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 compte désormais 100 millions de téléchargements mensuels et plus de 3 000 serveurs indexés.³ Pour les types de transport, l’elicitation et la configuration de la recherche de tools, consultez la section MCP dans le guide complet.

alwaysLoad (v2.1.121+) : excluez un serveur de confiance du report Tool Search. Tous ses tools 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 génèrent 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 desktop et flux de connecteurs 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 un 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 research-preview pour les sessions Claude Code en cours, bloquées et terminées. Utilisez-le pour le suivi, pas comme preuve que le travail a passé les contrôles qualité.⁶

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

14. Référence des coûts

Tarification par 1 million de tokens (en avril 2026).⁵

Une session typique 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 passeront à Opus 4.7 le 23 avril 2026)
• Bedrock, Vertex, Foundry → Sonnet 4.5 (épinglez une version plus récente via ANTHROPIC_DEFAULT_OPUS_MODEL)

Opus 4.7 nécessite Claude Code v2.1.111 ou ultérieure. 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 workloads de coding/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 coding 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

Cette cheat sheet est le compagnon de consultation rapide du guide complet Claude Code CLI. Pour les procédures de configuration, consultez le quickstart Claude Code. Pour les projets iOS et macOS en particulier, consultez le guide de développement d’agents iOS, les schémas d’intégration XcodeBuildMCP et l’Apple Ecosystem Series. Dernière mise à jour le 13 mai 2026.