Guide de Claude Code CLI : installation, configuration, commandes, variables d'environnement

En bref : Claude Code est un CLI agentique qui lit votre base de code, exécute des commandes et modifie des fichiers, sous le contrôle de cinq systèmes : la configuration, les permissions, les hooks, MCP et les subagents. Utilisez des hooks, et non des prompts, pour tout ce qui doit s’exécuter systématiquement.

État actuel (CLI v2.1.292, 6 octobre 2026 ; les versions npm latest et next sont 2.1.292, stable est 2.1.285) :²³⁴

• Modèle par défaut : Claude Opus 5.5 (claude-opus-5-5) avec les offres Pro, Max, Team et Enterprise, le Anthropic API, ainsi que sur Claude Platform avec AWS, Amazon Bedrock et l’Agent Platform de Google Cloud. Microsoft Foundry fait exception : Sonnet 4.5 y est utilisé par défaut et son alias opus désigne Opus 4.6.²²¹
• Opus 5.5 en bref : 4 $/20 $ par million de tokens, avec des lectures du cache à 0,20 $, un contexte de 1 M par défaut sur le Anthropic API et, depuis la v2.1.287, sur Bedrock, Agent Platform et Foundry, un effort medium par défaut et un raisonnement qui ne peut pas être désactivé. Le mode rapide le facture 8 $/40 $. Sonnet 5.5 (2 $/10 $ ; sonnet sur le Anthropic API depuis la v2.1.284) constitue le choix le moins coûteux lorsqu’une tâche ne nécessite pas Opus.^{220222223228232}
• Le mode Auto est le mode de permission initial des sessions interactives dans le terminal et VS Code, quels que soient l’offre et le fournisseur (v2.1.283-284), tandis que les sessions claude -p et Agent SDK démarrent en mode Manual, sauf si --permission-mode auto est passé (la v2.1.302 est revenue sur le démarrage automatique introduit par la v2.1.285 avec les fournisseurs tiers et lorsque la télémétrie est désactivée).²⁷⁵ Ses contrôles de sécurité s’exécutent sur le serveur sans frais pour les comptes Enterprise et Claude API, sur Claude Platform avec AWS, Bedrock, Agent Platform et Foundry, ainsi que par l’intermédiaire de passerelles ; à défaut, des contrôles locaux facturés prennent le relais.^{219227228229230}
• AGENTS.md : depuis la v2.1.277, AGENTS.md est lu comme ensemble d’instructions du projet lorsqu’un projet ne comporte aucun CLAUDE.md, sauf lorsque les feature flags ne sont pas récupérés (notamment sur Bedrock) et lors de la première session suivant une installation ou une mise à niveau.²¹⁹²²³

L’historique détaillé de chaque version figure dans le journal des modifications.

Claude Code fonctionne comme un système agentique, et non comme une interface de chat dotée de connaissances en programmation. Le CLI lit votre base de code, exécute des commandes, modifie des fichiers, gère les workflows git, se connecte à des services externes via MCP et délègue les tâches complexes à des subagents spécialisés. Tout passe par une interface en ligne de commande qui s’intègre aux méthodes de travail réelles des développeurs. En février 2026, 4 % des commits GitHub publics (environ 135 000 par jour) sont créés par Claude Code — soit une croissance multipliée par 42 896 en 13 mois depuis la version préliminaire destinée à la recherche — et 90 % du propre code de Anthropic est écrit par l’IA.¹⁰³

La différence entre une utilisation occasionnelle et une utilisation efficace de Claude Code repose sur cinq systèmes fondamentaux. Maîtrisez-les, et Claude Code deviendra un puissant démultiplicateur :

1. Hiérarchie de configuration : contrôle le comportement
2. Système de permissions : contrôle les opérations
3. Système de hooks : permet une automatisation déterministe
4. Protocole MCP : étend les capacités
5. Système de subagents : prend en charge les tâches complexes en plusieurs étapes

Points clés à retenir

• Cinq systèmes déterminent votre efficacité : la hiérarchie de configuration, les permissions, les hooks, MCP et les subagents contrôlent tous les aspects, du comportement à l’automatisation.
• Transférez le travail à la couche de délégation : les subagents évitent de surcharger le contexte en isolant l’exploration dans des fenêtres de contexte vierges et en ne renvoyant que des synthèses.
• Les hooks garantissent l’exécution, contrairement aux prompts : utilisez des hooks pour les contrôles de linting, de formatage et de sécurité qui doivent s’exécuter systématiquement, quel que soit le comportement du modèle.
• La répartition des modèles par niveau réduit les coûts sans sacrifier la qualité : confiez l’exploration des subagents à des modèles moins coûteux et réservez Opus aux véritables raisonnements architecturaux — ou standardisez sur Opus si la qualité est votre seule variable.
• MCP connecte Claude à votre chaîne d’outils : les bases de données, GitHub, Sentry et plus de 3 000 intégrations étendent les capacités de Claude au-delà de la lecture de fichiers et des commandes bash.

J’ai passé des mois à pousser Claude Code dans ses retranchements sur des bases de code en production, des pipelines CI/CD et des déploiements en entreprise. Ce guide condense cette expérience pour offrir la référence complète que j’aurais aimé avoir à mes débuts. Chaque fonctionnalité comprend la syntaxe exacte, de véritables exemples de configuration et les cas limites qui piègent même les utilisateurs expérimentés.

Choisissez votre parcours

Comment utiliser ce guide

Cette référence compte plus de 5 000 lignes — inutile de la lire intégralement. Commencez par la section correspondant à votre niveau d’expérience :

Utilisez Ctrl+F / Cmd+F dans votre navigateur pour rechercher des flags, des commandes ou des clés de configuration spécifiques. La fiche de référence rapide, à la fin, propose une synthèse facile à parcourir de toutes les commandes principales.

Analyses approfondies connexes

Ces articles de blog explorent en détail certains aspects de Claude Code :

Démarrage rapide en 60 secondes

Si vous souhaitez simplement lancer Claude Code et voir le résultat, procédez dans cet ordre :

# 1. Install (pick one)
npm install -g @anthropic-ai/claude-code          # npm users
brew install anthropic/claude/claude              # macOS + Homebrew
curl -sL claude.ai/install.sh | sh                # native installer

# 2. Launch in any project directory
cd ~/your-project && claude

# 3. Authenticate (browser opens automatically on first run)
/login

# 4. Ask your first question
> What does this repo do? Read the key files and summarize.

C’est tout. La suite détaille les options d’installation, la configuration des autorisations et des hooks, la connexion des serveurs MCP et le déploiement en entreprise — mais rien de tout cela n’est nécessaire pour commencer.

Prérequis : Node 22+ uniquement pour l’ancienne méthode via npm (version minimale relevée de 18 à partir de la v2.1.198 ; la documentation d’installation actuelle indique « Node.js 22 ou version ultérieure », vérifié le 7 août 2026) ; le programme d’installation natif recommandé ne dépend pas de Node. macOS / Linux / Windows 10+ sont pris en charge. Un abonnement Claude Pro, Max, Team ou Enterprise, ou une clé Anthropic API avec facturation à l’usage, couvre l’utilisation. Consultez Comment installer Claude Code ? pour connaître les spécificités de chaque plateforme, les procédures de dépannage et la méthode utilisant le binaire natif (adoptée par défaut depuis la v2.1.113). Les informations relatives à la dernière version présentées dans ce guide sont actualisées à chaque publication ; consultez la ligne la plus récente du journal des modifications pour connaître la date de la dernière vérification.²⁶⁷

Fonctionnement de Claude Code : le modèle mental

Avant d’examiner les fonctionnalités, vous devez comprendre comment l’architecture de Claude Code façonne toutes vos interactions avec l’outil. Le système repose sur trois couches :

┌─────────────────────────────────────────────────────────┐
│                    CLAUDE CODE LAYERS                    │
├─────────────────────────────────────────────────────────┤
│  EXTENSION LAYER                                         │
│  ┌─────────┐  ┌─────────┐  ┌─────────┐  ┌─────────┐    │
│  │   MCP   │  │  Hooks  │  │ Skills  │  │ Plugins │    │
│  └─────────┘  └─────────┘  └─────────┘  └─────────┘    │
│  External tools, deterministic automation, domain       │
│  expertise, packaged extensions                          │
├─────────────────────────────────────────────────────────┤
│  DELEGATION LAYER                                        │
│  ┌─────────────────────────────────────────────────┐    │
│  │           Subagents (20 concurrent default)      │    │
│  │   Explore | Plan | General-purpose | Custom      │    │
│  └─────────────────────────────────────────────────┘    │
│  Isolated contexts for focused work, returns summaries  │
├─────────────────────────────────────────────────────────┤
│  CORE LAYER                                              │
│  ┌─────────────────────────────────────────────────┐    │
│  │         Main Conversation Context                │    │
│  │   Tools: Read, Edit, Bash, Glob, Grep, etc.     │    │
│  └─────────────────────────────────────────────────┘    │
│  Your primary interaction; limited context; costs money │
└─────────────────────────────────────────────────────────┘

Couche principale : votre conversation principale. Chaque message, lecture de fichier et résultat d’outil consomme une partie du contexte d’une fenêtre partagée (200 000 tokens en standard⁹¹, 1 million de tokens avec Opus 4.6 ou les modèles à contexte étendu). Lorsque cette fenêtre est pleine, Claude perd le fil des décisions antérieures et la qualité se dégrade. Cette couche est facturée au token.

Couche de délégation : les subagents démarrent avec un contexte vierge, accomplissent une tâche ciblée et renvoient une synthèse. Les résultats de leurs recherches n’alourdissent pas votre conversation principale ; seules leurs conclusions y sont intégrées. Confiez les recherches à des subagents utilisant des modèles moins coûteux, ou conservez votre modèle principal pour toutes les tâches si la qualité prime sur le coût.

Couche d’extension : MCP connecte des services externes (bases de données, GitHub, Sentry). Les hooks garantissent l’exécution de commandes shell indépendamment du comportement du modèle. Les skills formalisent une expertise métier que Claude applique automatiquement. Les plugins regroupent tous ces éléments afin de les distribuer.

L’idée essentielle : la plupart des utilisateurs travaillent exclusivement dans la couche principale, tandis que le contexte s’alourdit et que les coûts augmentent. Les utilisateurs expérimentés confient les recherches et les tâches spécialisées à la couche de délégation, configurent la couche d’extension selon leur flux de travail et réservent la couche principale à l’orchestration et aux décisions finales.

Table des matières

1. Comment installer Claude Code ?
2. Démarrage rapide : votre première session
3. Principaux modes d’interaction
4. Analyse approfondie du système de configuration
5. Quel modèle choisir ?
6. Combien coûte Claude Code ?
7. Cadres de décision
8. Comment fonctionne le système d’autorisations ?
9. Comment fonctionnent les hooks ?
10. Qu’est-ce que MCP (Model Context Protocol) ?
11. Que sont les subagents ?
12. Qu’est-ce que le mode de réflexion étendue ?
13. Styles de sortie
14. Slash commands
15. Comment fonctionnent les skills ?
16. Système de plugins
17. Comment fonctionne la mémoire ?
18. Images et entrées multimodales
19. Mode vocal
20. Comment fonctionne l’intégration à Git ?
21. Comment utiliser Claude Code dans mon IDE ?
22. Modes d’utilisation avancés
23. Agents distants et en arrière-plan [APERÇU DE RECHERCHE]
24. Claude dans Chrome
25. Claude Code dans Slack [APERÇU DE RECHERCHE]
26. Claude Code sur le Web [APERÇU DE RECHERCHE]
27. Claude dans Microsoft 365 (mai 2026)
28. Optimisation des performances
29. Comment résoudre les problèmes ?
30. Déploiement en entreprise
31. Référence des raccourcis clavier
32. Bonnes pratiques
33. Recettes de flux de travail
34. Guide de migration
35. Conseils adaptés à chaque public
36. Fiche de référence rapide
37. Journal des modifications
38. Références

Comment installer Claude Code ?

Configuration requise

Claude Code fonctionne sous macOS 13+, Ubuntu 20.04+/Debian 10+ et Windows 10+ (en mode natif ou avec WSL). Le système nécessite au minimum 4 Go de RAM et une connexion Internet active.⁹² La compatibilité avec les shells est optimale avec Bash, Zsh ou Fish.

Sous Windows, WSL 1 et WSL 2 sont tous deux pris en charge. Git Bash fonctionne également si vous préférez utiliser Windows en mode natif. Alpine Linux et les autres systèmes basés sur musl nécessitent des paquets supplémentaires :

apk add libgcc libstdc++ ripgrep
export USE_BUILTIN_RIPGREP=0

Matrice de compatibilité des plateformes

Installation, mise à jour et désinstallation en un coup d’œil

Tableau de référence rapide — toutes les méthodes, toutes les commandes et la vérification de version sur un seul écran. Les sous-sections suivantes présentent les particularités et les procédures de dépannage propres à chaque méthode.

Depuis la v2.1.113, le CLI canonique lance un binaire Claude Code natif au moyen d’une dépendance facultative propre à chaque plateforme, au lieu d’un JavaScript intégré — utilisez le programme d’installation natif pour bénéficier de la distribution testée. La méthode npm fonctionne toujours, mais affiche l’avis d’obsolescence initialement ajouté dans la v2.1.15.

Méthodes d’installation

Installation native (recommandée)

Le binaire natif offre l’expérience la plus fluide, sans dépendance à Node.js :

# macOS and Linux
curl -fsSL https://claude.ai/install.sh | bash

# Homebrew alternative
brew install --cask claude-code

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

# Windows CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Pour installer une version précise :

# Install specific version
curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58

# Install latest explicitly
curl -fsSL https://claude.ai/install.sh | bash -s latest

# Windows PowerShell - specific version
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 1.0.58

Une version à ne jamais épingler derrière un proxy ou une gateway : 2.1.275. Avec cette version, chaque requête échoue avec 400 ... Input tag 'advisor_20260301' lorsque ANTHROPIC_BASE_URL pointe vers un proxy ou une gateway ; la version 2.1.276 corrige cette régression.²¹⁸

Installation avec NPM (obsolète)

Remarque : Depuis la v2.1.15, les installations npm affichent un avis d’obsolescence. Le binaire natif constitue désormais la méthode d’installation recommandée. Effectuez la migration avec claude install.

Pour les anciens environnements dans lesquels npm reste nécessaire :

npm install -g @anthropic-ai/claude-code

N’utilisez jamais sudo lors d’une installation avec npm. Cela crée des problèmes d’autorisations qui compliquent toutes les étapes ultérieures.

Migration depuis une installation existante

Si vous disposez d’une ancienne installation basée sur npm, migrez vers le binaire natif :

claude install

Options d’authentification

Claude Code propose trois méthodes d’authentification, chacune présentant des avantages et des inconvénients différents :

Console Claude (facturation API)

Connectez-vous directement au API de Anthropic via platform.claude.com (anciennement console.anthropic.com). Créez un compte, configurez la facturation et authentifiez-vous au moyen du CLI. La Console propose une facturation à l’usage avec un accès complet au API. Un espace de travail « Claude Code » dédié est créé automatiquement ; vous ne pouvez pas créer de clés API pour cet espace de travail, mais vous pouvez surveiller son utilisation. Depuis la v2.1.243, /login → Console Anthropic propose une méthode sans clé, « Sign in with your Console account » (recommandée), parallèlement à la création d’une clé API. Ainsi, les organisations qui n’autorisent pas les clés API peuvent tout de même se connecter avec leurs identifiants Console.²⁵⁰

Abonnement Claude Pro ou Max

Utilisez les identifiants de votre compte claude.ai. L’abonnement couvre à la fois l’interface web et l’utilisation du CLI dans le cadre d’une formule mensuelle unique. Il simplifie la facturation pour les utilisateurs individuels qui souhaitent maîtriser leurs coûts.

Plateformes d’entreprise

AWS Bedrock, Google Vertex AI et Microsoft Foundry offrent chacun un accès de niveau entreprise s’appuyant sur vos relations de facturation cloud existantes. Assistant de configuration de Bedrock (v2.1.92+) : un assistant interactif affiché sur l’écran de connexion vous guide dans l’authentification AWS, la sélection de la région, la vérification des identifiants et l’épinglage du modèle.¹³⁷ Assistant de configuration de Vertex AI (v2.1.98+) : un assistant équivalent pour Google Cloud vous guide dans l’authentification GCP, la configuration du projet et de la région, la vérification des identifiants et l’épinglage du modèle.¹⁴² Workload Identity Federation mTLS de Vertex AI (v2.1.121+) : Vertex AI accepte désormais Workload Identity Federation reposant sur des certificats X.509 (identifiants par défaut de l’application mTLS) — des jetons GCP de courte durée générés à partir d’un certificat client, sans JSON de compte de service.¹⁵⁴ Approbation des certificats d’autorité de certification du système d’exploitation (v2.1.101+) : les proxies TLS d’entreprise fonctionnent désormais par défaut — Claude Code approuve le magasin de certificats du système d’exploitation. Définissez CLAUDE_CODE_CERT_STORE=bundled pour utiliser uniquement les autorités de certification intégrées.¹⁴³

# AWS Bedrock
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1
export AWS_PROFILE=your-profile

# Google Vertex AI
export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=us-east5
export ANTHROPIC_VERTEX_PROJECT_ID=your-project

# Microsoft Foundry
export CLAUDE_CODE_USE_FOUNDRY=1
export ANTHROPIC_FOUNDRY_RESOURCE=your-resource-name
# Optional: API key auth (otherwise uses Entra ID)
export ANTHROPIC_FOUNDRY_API_KEY=your-key

# Amazon Bedrock via Mantle (v2.1.94+)
export CLAUDE_CODE_USE_MANTLE=1

Pour les déploiements d’entreprise derrière des proxies ou passant par des gateways LLM :

# Corporate proxy
export HTTPS_PROXY='https://proxy.example.com:8080'

# LLM gateway (skip native auth)
export CLAUDE_CODE_USE_BEDROCK=1
export ANTHROPIC_BEDROCK_BASE_URL='https://your-gateway.com/bedrock'
export CLAUDE_CODE_SKIP_BEDROCK_AUTH=1

En-têtes d’indication pour les gateways (v2.1.273) : Claude Code peut ajouter des en-têtes de requête qu’une gateway LLM peut utiliser à des fins de routage et d’observation — x-claude-code-request-class, x-claude-code-agent-type, x-claude-code-prev-tool-durations, x-claude-code-compaction, x-claude-code-context-compacted et, depuis la v2.1.283, x-claude-code-prompt-id, un UUID aléatoire commun à toutes les requêtes traitant une même invite utilisateur, y compris les tours des subagents.²¹⁷²²⁶ Avec une URL de base personnalisée ou un fournisseur tiers tel que Bedrock, les en-têtes restent désactivés tant que vous ne définissez pas CLAUDE_CODE_GATEWAY_HINT_HEADERS=1. La documentation du protocole des gateways précise également qu’une connexion directe au API de Anthropic les envoie par défaut et que CLAUDE_CODE_GATEWAY_HINT_HEADERS=0 les désactive pour toutes les connexions.²²⁷

Vérification

claude doctor

La commande indique le type d’installation, la version, la configuration système et tous les problèmes détectés.

Gestion de l’authentification (v2.1.41+)

Gérez l’authentification sans ouvrir le REPL :⁹⁰

claude auth login          # Log in or switch accounts
claude auth status         # Check current auth state (account, plan, expiry)
claude auth logout         # Clear stored credentials

Depuis la v2.1.268, claude auth status --json inclut configDirectory — le dossier de configuration réellement lu par le CLI, ce qui s’avère utile lorsque l’indirection de CLAUDE_CONFIG_DIR crée une ambiguïté.²¹⁶

Depuis la v2.1.273, la connexion avec un compte Claude demande également l’accès à vos plugins claude.ai.²¹⁷

Depuis la v2.1.286, claude auth status indique désormais api_key, et non plus claude.ai, pour la clé API enregistrée lors d’une connexion à la Console.²³¹

Procédure courante pour passer d’un compte ou d’une organisation à l’autre :

claude auth logout && claude auth login

Voir aussi : Comment déboguer les problèmes ? pour résoudre les échecs d’authentification.

Mises à jour

Claude Code se met à jour automatiquement par défaut, en recherchant les nouvelles versions au démarrage et régulièrement pendant les sessions. Les mises à jour sont téléchargées en arrière-plan et appliquées au lancement suivant.

Pour désactiver les mises à jour automatiques :

export DISABLE_AUTOUPDATER=1

Ou dans settings.json :

{
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

Mise à jour manuelle :

claude update

Désinstallation

Installation native (macOS/Linux/WSL) :

rm -f ~/.local/bin/claude
rm -rf ~/.claude-code

Installation native (Windows PowerShell) :

Remove-Item -Path "$env:LOCALAPPDATA\Programs\claude-code" -Recurse -Force
Remove-Item -Path "$env:LOCALAPPDATA\Microsoft\WindowsApps\claude.exe" -Force

Nettoyage de la configuration (supprime tous les paramètres) :

rm -rf ~/.claude
rm ~/.claude.json
rm -rf .claude
rm -f .mcp.json

Démarrage rapide : votre première session

1. Installez et lancez :

claude                           # Launch in current directory

2. Accédez à un projet :

cd ~/my-project && claude        # Or launch from any git repo

3. Demandez à Claude d’effectuer une tâche :

> "Explain the architecture of this project"
> "Find all TODO comments and create a summary"
> "Add input validation to the signup form"

4. Utilisez les raccourcis clavier pendant votre session :

/cost                            # Check token usage and cost
/compact                         # Free up context when it gets large
Alt+T                            # Toggle extended thinking for hard problems
Ctrl+C                           # Cancel current response

5. Reprenez plus tard :

claude -c                        # Resume your most recent session
claude --resume                  # Pick from session list

Conseil d’expert : créez un fichier CLAUDE.md à la racine de votre projet avec les commandes de build, les conventions de codage et des notes sur l’architecture. Claude le lit à chaque session — c’est le moyen le plus efficace d’améliorer la qualité.

Modes d’interaction principaux

REPL interactif

Lancez Claude Code sans argument pour accéder à la boucle interactive de lecture-évaluation-affichage :

cd your-project
claude

Le REPL conserve le contexte de la conversation d’un échange à l’autre. Saisissez directement vos requêtes, recevez les réponses et poursuivez jusqu’à quitter avec /exit ou Ctrl+D.

Commencez par une requête initiale pour cibler la session :

claude "explain the authentication flow in this project"

Conseil d’expert : le REPL conserve son état lors des opérations de compaction. Lorsque le contexte devient trop volumineux, Claude résume automatiquement les échanges plus anciens tout en préservant les décisions clés et les extraits de code. Vous pouvez déclencher cette opération manuellement avec /compact ou ajouter des instructions personnalisées précisant les éléments à conserver.

Mode non interactif

Le mode d’affichage (-p) exécute une seule requête, puis se ferme :

# Direct query
claude -p "list all TODO comments in this project"

# Process piped input
cat error.log | claude -p "identify the root cause of these failures"

# Chain with other tools
claude -p "generate a README" > README.md

Pour obtenir une sortie structurée adaptée à l’analyse dans des scripts :

claude -p "count lines by file type" --output-format json

La sortie JSON contient tout le nécessaire pour l’automatisation :

{
  "type": "result",
  "subtype": "success",
  "total_cost_usd": 0.0034,
  "is_error": false,
  "duration_ms": 2847,
  "duration_api_ms": 1923,
  "num_turns": 4,
  "result": "Response text here...",
  "session_id": "abc-123-def"
}

Pour traiter en temps réel une sortie diffusée en continu :

claude -p "build the application" --output-format stream-json | while read line; do
  echo "$line" | jq -r 'select(.result) | .result'
done

Options de format de sortie :

Texte des subagents dans stream-json (v2.1.211+) : par défaut, la sortie stream-json ne contient que les événements de la session principale — le travail effectué au sein des subagents apparaît sous forme de résumé. L’option --forward-subagent-text (ou CLAUDE_CODE_FORWARD_SUBAGENT_TEXT=1) transmet également au flux le texte et le raisonnement des subagents, afin que les bancs d’essai et les pipelines de journaux puissent observer le travail délégué au fil de son exécution, au lieu de ne voir que le rapport final.¹⁸⁸

Les subagents imbriqués sont désormais transmis eux aussi (v2.1.219). À l’origine, seuls les subagents de profondeur 1 apparaissaient. Les subagents créés à une profondeur de 2 ou plus figurent désormais également dans le flux transmis, chacun étant identifié par l’id tool_use de l’appel Agent qui l’a créé — un pipeline peut ainsi reconstruire l’arborescence de délégation au lieu de voir une simple liste de textes. Cette évolution accompagne directement le rétablissement, dans la même version, de la création imbriquée jusqu’à une profondeur de 3 par défaut : sans elle, deux des trois niveaux seraient restés invisibles.¹⁹⁶

Les subagents passés en arrière-plan ne deviennent plus invisibles (v2.1.273) : les sorties SDK et stream-json ne perdent plus les messages restants ni le rapport final d’un subagent lorsque celui-ci passe en arrière-plan en cours d’exécution (par exemple avec CLAUDE_AUTO_BACKGROUND_TASKS).²¹⁷

Une exécution -p bloquée renvoie désormais une erreur (v2.1.277) : auparavant, les sessions claude -p et Agent SDK confrontées à une erreur interne pouvaient rester bloquées sans produire de résultat — le pire mode de défaillance pour un pipeline, puisque seul un délai d’expiration externe mettait fin à l’exécution. Elles signalent maintenant l’erreur et se terminent avec le code 1 ; le tableau des codes de sortie ci-dessous constitue donc à nouveau l’intégralité du contrat. La même version permet aussi aux sessions headless d’enregistrer leurs totaux de coût et d’utilisation à la fermeture : la reprise d’une session headless (claude -p --resume, le SDK, le rechargement d’une fenêtre de l’extension VS Code) ne remet plus à zéro les totaux de la session, ce qui évite de sous-estimer les coûts cumulés lors de la reprise d’exécutions headless.²¹⁹

Codes de sortie :

Contrôle du comportement agentique en mode -p :

# Limit autonomous turns (prevents runaway loops)
claude -p "refactor the auth module" --max-turns 10

# Allow specific tools without prompting
claude -p "fix lint errors" --allowedTools "Edit,Bash(npm run lint)"

# Use with a specific model
claude -p "explain this code" --model claude-sonnet-5

# Bare mode: skip hooks, LSP, plugin sync, skill walks (v2.1.81+); only CLI-named MCP servers (v2.1.286)
claude -p "count files" --bare

# Channel permission relay: send approval prompts to Telegram/Discord (v2.1.81+)
claude --channels

# Restricted mode for eval harnesses and shared machines (v2.1.248+)
claude --restricted -p "query" --tools "Read,Grep,Glob"

# Unattended hosts: deny anything that would prompt (v2.1.259+)
claude -p "run the nightly checks" --permission-prompts none

Mode restreint (v2.1.248+) : --restricted (ou CLAUDE_CODE_RESTRICTED=1) est conçu pour les bancs d’essai qui pilotent claude sur une machine partagée. Il supprime les outils intégrés exécutant des commandes ou du code, ainsi que WebFetch, sauf si vous les nommez individuellement dans --tools — le préréglage default ne suffit pas —, limite les outils de fichiers intégrés aux répertoires de travail, charge uniquement les paramètres gérés et --settings (les fichiers de paramètres utilisateur, de projet et locaux sont ignorés), refuse bypassPermissions et interdit la création de sessions cloud.²⁰⁶²⁰⁹

--permission-prompts none (v2.1.259) : le complément destiné aux hôtes sans surveillance. Toute action qui déclencherait une demande d’autorisation est automatiquement refusée, tandis que le mode d’autorisation actif — y compris le mode automatique — continue de prendre toutes les décisions possibles sans votre intervention. Ne le confondez pas avec --permission-prompt-tool, qui délègue les demandes à un outil MCP au lieu de les refuser. La documentation de référence CLI ne répertorie pas encore cette nouvelle option ; le CHANGELOG fait foi.²¹¹

cd persiste d’un échange à l’autre dans les sessions non interactives (v2.1.265) : les sessions -p alimentées par une entrée stream-json, les sessions Agent SDK et les sessions cloud ne réinitialisent plus le répertoire de travail du shell à chaque nouveau message de l’utilisateur — un cd effectué lors d’un échange reste désormais valable au suivant.²¹⁵

--system-prompt-snapshot off (v2.1.267) : par défaut, une conversation réutilise son system prompt enregistré à chaque requête. Cette option génère plutôt un nouveau system prompt à chaque requête — c’est le réglage adapté pour faire évoluer le texte d’un prompt, afin que chaque exécution prenne en compte votre dernière modification au lieu de l’instantané, au prix de la stabilité du cache de prompts que cet instantané vise à préserver.²¹⁶

--bare respecte ses limites (v2.1.286) : --bare ne se connecte désormais qu’aux serveurs MCP nommés sur la ligne de commande, n’envoie aucun rappel système au modèle et ne lance aucune tâche en arrière-plan ; une commande shell qui atteint son délai d’expiration s’arrête au lieu de passer en arrière-plan. La documentation headless indique qu’avant la v2.1.286, ces limites n’étaient que partiellement respectées, et recommande --bare pour les appels scriptés et SDK.²³¹²³³

Modèle d’intégration CI/CD :

# In a GitHub Action or CI pipeline
result=$(claude -p "review this diff for security issues" --output-format json 2>/dev/null)
is_error=$(echo "$result" | jq -r '.is_error')
if [ "$is_error" = "true" ]; then
  echo "Review failed"
  exit 1
fi
echo "$result" | jq -r '.result'

Gestion des sessions

Les sessions conservent l’historique des conversations afin de pouvoir les poursuivre. Cette persistance est essentielle aux travaux complexes répartis sur plusieurs sessions :

# Continue most recent session
claude -c

# Continue with additional prompt
claude -c -p "now add error handling"

# Resume specific session by ID
claude -r "abc123" "implement the remaining tests"

# Fork a session for parallel exploration
claude -r "base-session" --fork-session "try a different approach"

# Open the Claude desktop app on this directory, or on a session (v2.1.285)
claude --desktop
claude --desktop --continue

Déplacer une session en cours avec /cd (v2.1.169+ ; configuration immédiate depuis la v2.1.246) : /cd path change le répertoire de travail sans interrompre le cache de prompts. Depuis la v2.1.246, les paramètres de projet, hooks, serveurs .mcp.json (après la demande d’autorisation habituelle), skills et agents du nouveau répertoire prennent effet immédiatement après le déplacement, sans attendre --resume.²⁶²²⁴⁹

Sessions liées aux PR (v2.1.27+, étendu en v2.1.119+) : démarrez une session liée à une pull request ou merge request précise. Depuis la v2.1.119, --from-pr accepte les URL de MR GitLab, de PR Bitbucket et de PR GitHub Enterprise, en plus de celles de github.com :⁷⁴¹⁵²

claude --from-pr 123                                                # GitHub PR number (assumes current repo's remote)
claude --from-pr https://github.com/org/repo/pull/123               # GitHub URL
claude --from-pr https://gitlab.com/org/repo/-/merge_requests/45    # GitLab MR (v2.1.119+)
claude --from-pr https://bitbucket.org/org/repo/pull-requests/67    # Bitbucket PR (v2.1.119+)
claude --from-pr https://ghe.example.com/org/repo/pull/89           # GitHub Enterprise (v2.1.119+)

Les sessions sont également liées automatiquement aux PR lorsque vous les créez avec gh pr create au cours d’une session. Vous pouvez ainsi reprendre facilement, plus tard, le travail sur une PR précise. Le badge de PR dans le pied de page peut pointer vers une URL personnalisée de revue de code grâce au paramètre prUrlTemplate (v2.1.119+) — utile lorsque votre équipe relie les PR à un outil de revue distinct.¹⁵²

/resume accepte les URL de PR (v2.1.122+). Collez une URL de PR dans la zone de recherche de /resume pour retrouver la session qui a créé cette PR — cela fonctionne avec github.com, GitHub Enterprise, gitlab.com (y compris les instances GitLab auto-hébergées) et bitbucket.org.¹⁵⁴

Sessions nommées : nommez les sessions au démarrage ou pendant leur exécution :

# Name session at startup (v2.1.76+)
claude -n "auth-refactor"                  # --name flag sets display name[^125]

# Name current session
> /rename auth-refactor

# Resume by name or number
> /resume 1                    # Resume first session
> /resume auth-refactor        # Resume by name
claude --resume auth-refactor  # Resume from terminal
claude -r 3                    # Resume by number from terminal

# Fork for parallel exploration
claude --resume auth-refactor --fork-session

Remarque : --session-id exige un UUID valide (par exemple, 550e8400-e29b-41d4-a716-446655440000). Pour attribuer un nom lisible à une session, utilisez plutôt /rename et --resume.

/fork crée une session en arrière-plan ; /subtask correspond au fork effectué dans la session (v2.1.212). La commande /fork copie désormais la conversation actuelle dans une nouvelle session en arrière-plan — celle-ci obtient sa propre ligne dans claude agents, ce qui vous permet d’envoyer la copie explorer une autre piste pendant que votre session principale se poursuit. L’ancien comportement — effectuer un fork au sein de la session actuelle — subsiste sous le nouveau nom /subtask.¹⁸⁹ Depuis la v2.1.214, une session démarrée comme fork indique "fork" comme source du hook SessionStart (contre "resume" auparavant), afin que les hooks filtrant par source puissent les distinguer.¹⁹⁰ La v2.1.216 réduit la confirmation de /fork à une seule ligne indiquant le nom de la nouvelle session et son id claude attach.¹⁹² Depuis la v2.1.221, une session issue d’un fork crée son propre worktree au lieu de travailler dans le checkout de la session d’origine — le fork qui explore une autre piste ne peut donc plus entrer en conflit avec les fichiers non validés de la session principale, ce qui constituait le principal risque lorsqu’une copie était envoyée expérimenter.¹⁹⁹ La v2.1.232 fait également du fork le comportement par défaut des subagents : un subagent subagent_type: "fork" hérite de l’intégralité de la conversation et du cache de prompts, et les créations d’agents qui ne sont pas des coéquipiers s’exécutent désormais en arrière-plan par défaut dans les sessions interactives.²⁵⁵

Claude Code stocke les sessions sous forme de transcriptions JSONL. L’exécution des agents attribue des valeurs agentId uniques, les transcriptions étant stockées sous la forme agent-{agentId}.jsonl. La reprise conserve l’intégralité du contexte des conversations précédentes.

Mode plan

Le mode plan limite Claude à une exploration en lecture seule — aucune modification de fichier, aucune exécution bash et aucune action destructive. Claude conçoit une stratégie d’implémentation, l’enregistre dans un fichier de plan et attend votre approbation avant toute exécution.

Activation du mode plan :

# Cycle through modes during a session
Shift+Tab           # Cycles: normal → plan → auto-accept

# Or use the /plan command with an optional description (v2.1.72+)
/plan                                     # Enter plan mode
/plan refactor the auth module            # Enter plan mode with a description

# Or ask Claude directly
"Plan how to refactor the auth module"   # Claude may enter plan mode automatically

Fonctionnement :

1. Claude passe en mode plan (automatiquement pour les tâches complexes, ou avec Shift+Tab)
2. Explore le code source à l’aide d’outils en lecture seule : Read, Glob, Grep, WebSearch, WebFetch
3. Enregistre un plan dans .claude/plans/{session-slug}.md
4. Quitte le mode plan avec ExitPlanMode et vous présente le plan pour examen
5. Vous approuvez le plan, demandez des modifications ou le refusez

Outils disponibles en mode plan : Read, Glob, Grep, LS, WebSearch, WebFetch, AskUserQuestion. Les outils de modification (Edit, Write, Bash, NotebookEdit) sont bloqués.

Après l’approbation du plan (v2.1.32+) : Claude propose trois options : - « Oui, effacer le contexte et accepter automatiquement les modifications » (Shift+Tab) — repart de zéro avec l’intégralité du contexte disponible pour le plan - « Oui, et approuver manuellement les modifications » — conserve le contexte ; vous approuvez chaque modification - « Oui, accepter automatiquement les modifications » — conserve le contexte ; Claude s’exécute sans demander d’approbation pour chaque modification

L’effacement automatique du contexte lors de l’approbation constitue le workflow recommandé. Le plan bénéficie ainsi d’une nouvelle fenêtre de contexte, ce qui améliore nettement son respect : Claude reste concentré plus longtemps, sans que l’ancienne conversation interfère.

Quand utiliser le mode plan : - Implémentation de nouvelles fonctionnalités impliquant des décisions d’architecture - Refactorisations touchant plusieurs fichiers, lorsque vous souhaitez examiner l’approche au préalable - Code source inconnu, lorsque l’exploration doit précéder les modifications - Toute tâche pour laquelle plusieurs approches valides existent et sur laquelle vous souhaitez intervenir

Conseil d’expert : plus vous passez de temps en mode plan, plus Claude a de chances de réussir l’implémentation. Le mode plan permet une exploration pratiquement sans coût — aucun appel d’outil risqué, aucune modification inutile. Utilisez-le généreusement.

Mode lecteur d’écran (v2.1.208)

Claude Code propose un mode dédié aux lecteurs d’écran, qui adapte l’interface du terminal aux technologies d’assistance. Vous pouvez l’activer de trois façons :¹⁸⁶

# Flag at launch
claude --ax-screen-reader

# Environment variable
export CLAUDE_AX_SCREEN_READER=1

# Or persistently in settings.json
{ "axScreenReader": true }

Anthropic documente ce mode — ainsi que ses modes d’interaction — sur une nouvelle page consacrée à l’accessibilité dans la documentation officielle.¹⁸⁶

Aucune pause avant chaque ligne (v2.1.287) : le mode lecteur d’écran affiche désormais les lignes nouvelles ou modifiées sans marquer d’abord une pause avec le curseur au début de la ligne. CLAUDE_AX_PREPARK_MS définit cette pause en millisecondes ; sa valeur par défaut est maintenant 0 (contre 50 auparavant). Définissez donc CLAUDE_AX_PREPARK_MS=50 pour la rétablir. La même version corrige une série de problèmes liés aux lecteurs d’écran, notamment le curseur qui ne se trouvait pas à proximité du texte saisi dans les zones de recherche et l’absence des lignes modifiées dans les demandes d’approbation des modifications.²³²²³³

Plongée dans le système de configuration

Claude Code repose sur un système de configuration en couches. Il est essentiel d’en comprendre la hiérarchie : les niveaux supérieurs l’emportent sur les niveaux inférieurs, et les paramètres d’entreprise ne peuvent en aucun cas être contournés.

Hiérarchie de configuration

Définir la configuration depuis le prompt : /config key=value (v2.1.181)

Depuis la v2.1.181, /config key=value définit n’importe quel paramètre directement depuis le prompt (par exemple /config thinking=false) sans ouvrir l’interface interactive /config. La commande fonctionne en session interactive, avec -p et en Remote Control. /config --help (v2.1.183) liste les clés abrégées disponibles. La v2.1.183 a également modifié l’interface interactive /config : Entrée et Espace basculent désormais tous deux le paramètre sélectionné, et Échap enregistre puis ferme (auparavant, Échap annulait les modifications).¹⁷⁴

Référence complète de settings.json

Une configuration complète illustrant toutes les options principales :

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "model": "claude-sonnet-5",
  "permissions": {
    "allow": [
      "Read",
      "Glob",
      "Grep",
      "Bash(npm run:*)",
      "Bash(git:*)",
      "Bash(make:*)",
      "Edit(src/**)",
      "mcp__github"
    ],
    "deny": [
      "Read(.env*)",
      "Read(secrets/**)",
      "Bash(rm -rf:*)",
      "Bash(sudo:*)",
      "Edit(package-lock.json)",
      "Edit(.git/**)"
    ],
    "ask": [
      "WebFetch",
      "Bash(curl:*)",
      "Bash(docker:*)"
    ],
    "additionalDirectories": [
      "../shared-lib",
      "../docs"
    ],
    "defaultMode": "acceptEdits"
  },
  "env": {
    "NODE_ENV": "development",
    "DEBUG": "app:*"
  },
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write"
          }
        ]
      }
    ]
  },
  "sandbox": {
    "enabled": false,
    "autoAllowBashIfSandboxed": true,
    "excludedCommands": ["git", "docker"]
  },
  "statusLine": {
    "type": "command",
    "command": "~/.claude/statusline.sh"
  },
  "cleanupPeriodDays": 30,
  "outputStyle": "Explanatory",
  "language": "en",
  "respectGitignore": true,
  "showTurnDuration": true,
  "plansDirectory": ".claude/plans",
  "spinnerVerbs": ["Thinking", "Processing", "Analyzing"],
  "spinnerTipsOverride": {
    "label": "Team tips",
    "tips": [
      "Custom tip 1",
      {"id": "tip-2", "text": "Custom tip 2", "cooldownSessions": 5, "priority": 1}
    ],
    "tipsFile": "~/.claude/team-tips.json",
    "excludeDefault": true
  },
  "skillOverrides": {
    "legacy-skill": "off",
    "manual-only-skill": "user-invocable-only",
    "compact-skill": "name-only"
  },
  "includeGitInstructions": false,
  "modelOverrides": {
    "claude-opus-5-5": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-prod",
    "claude-sonnet-5": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/sonnet-prod"
  },
  "autoMemoryDirectory": ".claude/memory",
  "sandbox": {
    "enableWeakerNetworkIsolation": true
  }
}

skillOverrides est utile lorsqu’une équipe dispose d’une vaste bibliothèque de skills mais souhaite en limiter l’exposition à l’exécution. Utilisez off pour masquer un skill à la fois du modèle et du sélecteur de commandes slash, user-invocable-only pour qu’il reste appelable par son nom tout en étant retiré de la sélection par le modèle, et name-only pour n’afficher que le nom du skill, sans sa description complète.¹⁵⁶

Nouveaux paramètres (v2.1.174–176) :

• availableModels / enforceAvailableModels (géré, v2.1.175+) : la liste d’autorisation availableModels restreint les modèles sélectionnables dans une session. Avec enforceAvailableModels: true, elle contraint aussi le modèle Default : un Default qui aboutirait à un modèle non autorisé se rabat sur le premier modèle autorisé, et les paramètres utilisateur ou projet ne peuvent plus élargir une liste availableModels gérée. Un correctif associé (v2.1.176) comble la faille par laquelle le choix d’un alias pouvait rediriger vers un modèle bloqué via ANTHROPIC_DEFAULT_*_MODEL, et /fast refuse désormais de basculer vers un modèle absent de la liste d’autorisation.¹⁷² Depuis la v2.1.187, les organisations peuvent imposer ces restrictions directement dans le sélecteur /model, --model, /model et ANTHROPIC_MODEL : choisir un modèle restreint affiche le message « restricted by your organization’s settings ».¹⁷⁶
• language (affinement v2.1.176) : outre la langue des réponses, les titres de session sont désormais générés par défaut dans la langue de votre conversation ; définissez language pour imposer une langue précise aux titres.¹⁷²
• footerLinksRegexes (v2.1.176) : badges de liens détectés par expression régulière dans la ligne de pied de page, configurables via les paramètres utilisateur ou gérés.¹⁷²
• wheelScrollAccelerationEnabled (v2.1.174) : définissez-le à false pour désactiver l’accélération du défilement à la molette en mode plein écran.¹⁷²

Nouveaux paramètres (v2.1.207–v2.1.212) :

• vimInsertModeRemaps (v2.1.208) : remappages de touches personnalisés pour le mode insertion de vim ; l’exemple classique consiste à associer jj à Échap (voir Mode Vim).¹⁸⁶
• axScreenReader (v2.1.208) : active durablement le mode lecteur d’écran (voir Mode lecteur d’écran).¹⁸⁶
• processWrapper (v2.1.208) : fait passer chaque processus que Claude Code lance pour son propre compte par un exécutable enveloppe, conçu pour les lanceurs d’entreprise (voir Lanceur d’entreprise).¹⁸⁶
• Restriction de source pour autoMode (v2.1.207) : le paramètre autoMode n’est plus lu depuis le fichier .claude/settings.local.json d’un dépôt ; configurez-le plutôt dans ~/.claude/settings.json. Cela ferme une brèche par laquelle un dépôt cloné pouvait embarquer une configuration du mode auto.¹⁸⁵

Nouveaux paramètres (v2.1.217) :

• emojiCompletionEnabled (v2.1.217) : autocomplétion des codes courts d’emoji dans la zone de saisie : tapez :heart: pour insérer ❤️, ou un fragment comme :hea pour obtenir des suggestions. Activé par défaut ; définissez-le à false pour le désactiver.¹⁹⁴

Nouveaux paramètres (v2.1.219) :

• sandbox.network.strictAllowlist (v2.1.219) : refuse les hôtes hors liste d’autorisation pour les commandes en sandbox sans demander de confirmation, au lieu d’ouvrir une boîte de dialogue d’autorisation. Voir Mode sandbox.¹⁹⁶
• workflowSizeGuideline (v2.1.219) : définit la recommandation indicative de taille des workflows dynamiques depuis n’importe quel fichier de paramètres (utilisateur, projet ou géré), et plus seulement via /config. Par défaut, les workflows dynamiques suivent une recommandation medium (« aim for fewer than 15 agents ») ; la ligne correspondante de /config se masque lorsqu’un fichier de paramètres fournit la valeur. Il s’agit d’une indication, pas d’un plafond imposé. Voir Subagents.¹⁹⁶

Nouveaux paramètres (v2.1.242–243) :

• modelPicker (utilisateur ou géré, v2.1.242+) : organise le sélecteur /model sous forme de liste ordonnée et étiquetée de modèles. Il s’agit d’un objet comportant un tableau options (chaque ligne contient un model obligatoire, plus un label et une description facultatifs ; model est repris tel quel, si bien que les alias, les ID Anthropic et les ID Bedrock/Vertex/Foundry/passerelle fonctionnent tous) et un booléen facultatif replaceBuiltInOptions (false, la valeur par défaut, ajoute les lignes après la liste intégrée ; true n’affiche que vos lignes, Default et le modèle déjà utilisé par la session). Claude Code lit la clé depuis les paramètres gérés, --settings et les paramètres utilisateur, et l’ignore dans les paramètres de projet et locaux : un dépôt cloné ne peut donc pas réétiqueter le sélecteur. La source la plus élevée qui la définit fournit l’intégralité de la liste. Une liste d’autorisation availableModels s’applique toujours à chaque ligne, et une étiquette modifie ce qu’affiche le sélecteur, pas le modèle réellement exécuté.²⁵⁰²⁴⁸
• promptCacheTtl / subagentPromptCacheTtl (n’importe quel fichier, v2.1.242+) : "5m" ou "1h" par catégorie de requêtes, ce qui permet aux utilisateurs d’une clé API ou d’un fournisseur cloud de conserver un cache d’une heure sur la conversation principale tandis que les subagents restent à cinq minutes. Voir Stratégies de mise en cache.²⁵⁰²⁴⁸
• modelPricing (géré, v2.1.243+) : les tarifs contractuels par modèle et le multiplicateur de remise d’une organisation, utilisés par /cost, la ligne d’état et les chiffres de coût de la télémétrie à la place du prix catalogue. Voir Consulter les coûts.²⁵⁰

Nouveaux paramètres (v2.1.247) : - feedbackDrafts (v2.1.247) : régit le nouvel outil SendFeedback – lorsqu’un problème survient pendant une session, Claude peut rédiger un rapport de feedback que vous relisez puis envoyez depuis /feedback ; ce paramètre permet de désactiver cette rédaction. Consultez la ligne /feedback dans Commandes slash.²⁴⁵ - Extension de la forme de spinnerTipsOverride (v2.1.247) : les entrées de conseils peuvent désormais être des objets {id, text, cooldownSessions, priority} en plus de simples chaînes, et l’objet gagne les clés tipsFile et label, ce qui permet aux organisations de faire tourner leurs propres conseils aux côtés des conseils intégrés (l’exemple ci-dessus montre la forme étendue). La référence des paramètres documente désormais les nouvelles clés.²⁴⁵²²⁷

Paramètres récents (v2.1.248–251) :

• desktopSessionCleanupPeriodDays (v2.1.248) : limite la durée pendant laquelle les sessions écrites par l’application de bureau échappent au nettoyage des transcriptions. Le correctif qui l’accompagne compte davantage que le réglage lui-même : les sessions Claude Desktop et Cowork disparaissaient auparavant après cleanupPeriodDays (30 jours par défaut) ; le nettoyage les conserve désormais tant qu’elles figurent dans l’application, sauf si une politique d’organisation gère la rétention.²⁰⁶
• Restrictions sur le bloc env du projet (v2.1.251) : un bloc env dans un .claude/settings.json au niveau du projet ne peut plus définir CLAUDE_CONFIG_DIR, CLAUDE_CODE_TMPDIR, ni TMPDIR/TMP/TEMP – définissez-les plutôt dans votre shell, vos paramètres utilisateur ou vos paramètres gérés, afin qu’un dépôt cloné ne puisse pas rediriger l’emplacement où Claude Code écrit sa configuration et ses fichiers temporaires.²⁰⁶

Paramètres récents (v2.1.257-259) :

• timeFormat / timeZone (v2.1.257) : contrôlent l’affichage des heures dans Claude Code – l’horloge de fin de tour et les horodatages des transcriptions. timeFormat accepte le format 12 heures, 24 heures, 24 heures UTC ou un motif strftime explicite ; timeZone désigne le fuseau horaire.²¹¹ La référence des paramètres documente désormais ces deux clés.²²⁷
• permissions.blockReadsOutsideWorkingDirectories (v2.1.257) : refuse purement et simplement les lectures de fichiers hors des répertoires de travail de la session. Sans ce paramètre, le mode auto demande désormais une confirmation avant la première lecture de ce type dans la session (voir Mode auto).²¹¹ La v2.1.273 comble deux lacunes : une commande Bash que le vérificateur ne peut pas analyser entièrement déclenche une demande au lieu de contourner la vérification, et un répertoire de mémoire choisi par les paramètres d’un dépôt n’est ni chargé, ni rappelé, ni indexé sous ce paramètre.²¹⁷
• managedMcpServers / managedSourcesBehavior : clés de portée gérée, traitées dans Déploiement en entreprise – les organisations fournissant des serveurs MCP à tous les utilisateurs (v2.1.259) et la fusion optionnelle entre sources gérées (affinée en v2.1.257).²¹¹²⁴⁴

Paramètres récents (v2.1.261) :

• bashOutputMaxChars / taskOutputMaxChars (v2.1.261) : augmentent la quantité de sortie de commande (et de sortie de tâche en arrière-plan, respectivement) que Claude reçoit directement avant que le reste ne soit enregistré dans un fichier, jusqu’à 128K caractères. Il s’agit d’un mécanisme distinct de la variable d’environnement BASH_MAX_OUTPUT_LENGTH, qui définit la fenêtre de relecture du fichier de sortie de travail de la commande (30 000 caractères par défaut, plafonnée à 150 000) : ces clés fixent le seuil entre sortie directe et fichier persistant – au-delà, la sortie atterrit dans un fichier que Claude peut lire à la demande au lieu d’être tronquée.²¹⁴ Depuis la v2.1.265, le côté persistant a lui aussi un plafond : les résultats d’outils enregistrés sur disque sont limités à 1 Go, et l’aperçu dans la conversation indique quand un fichier enregistré a été tronqué.²¹⁵ La moitié « tâche » a été retirée en v2.1.277 : l’outil obsolète TaskOutput a été supprimé – Claude lit désormais le fichier de sortie d’une tâche en arrière-plan avec Read – et taskOutputMaxChars comme TASK_MAX_OUTPUT_LENGTH n’ont plus aucun effet. bashOutputMaxChars n’est pas concerné.²¹⁹

Paramètres récents (v2.1.267-269) :

• maxEffortLevel (v2.1.267) : plafonne le niveau d’effort que les utilisateurs peuvent choisir – au niveau global ou par modèle sous modelSettings – et s’applique à tous les fournisseurs, Bedrock, Vertex et Foundry compris. Les utilisateurs peuvent toujours choisir un niveau inférieur au plafond ; c’est le pendant côté administrateur de /effort.²¹⁶
• advisorModel : le modèle conseiller enregistré (fable, opus, sonnet ou un identifiant complet) que /advisor écrit dans les paramètres utilisateur ; --advisor le remplace pour une session et CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1 désactive l’outil. Consultez L’outil Advisor.²⁷⁴
• sandbox.allowNestedUserNamespaces (v2.1.305) : autorise les commandes sandboxées sous Linux et WSL2 à créer des espaces de noms utilisateur (Chromium, podman sans root) ; cela leur permet de contourner les protections de fichiers du sandbox, si bien que ce paramètre n’est lu que depuis les paramètres utilisateur ou gérés. Consultez Mode sandbox.²⁷⁸²⁷⁹
• bashEditDiffEnabled (v2.1.269) : lorsque l’outil Bash effectue une modification de fichier, le résultat de l’outil inclut un diff des fichiers modifiés par la commande, de sorte que la conversation montre ce qu’une modification de type sed a réellement fait.²¹⁶

Paramètres récents (v2.1.275) :

• syncClaudeAiSkills / syncClaudeAiPlugins (v2.1.275) : les skills et plugins activés sur votre compte claude.ai se synchronisent désormais dans les sessions de terminal connectées avec ce compte. Réglez l’une ou l’autre clé sur false pour limiter les sessions de terminal aux skills et plugins locaux. Consultez Skills et Système de plugins.²¹⁸

Paramètres récents (v2.1.282-283) :

• maxProseWidth (v2.1.282) : limite la largeur de la prose de Claude dans un terminal large. Les paragraphes, titres, listes et citations se replient dans ce nombre de colonnes, tandis que les tableaux et blocs de code conservent toute la largeur. La valeur est un nombre entier de colonnes, 40 au minimum.²²⁵²²⁷
• deniedModels / availableModelsMatch (géré, v2.1.283) : deniedModels bloque des modèles précis même lorsque availableModels les autorise. Un alias de famille comme "opus" bloque toute la famille, et "claude-opus-5" bloque aussi Opus 5.5 (écrivez "claude-opus-5-0" pour Opus 5 seul). Par défaut, une entrée availableModels comme "claude-opus-5" autorise également les versions ultérieures qui la prolongent ; availableModelsMatch: "exact" limite chaque entrée à la seule version qu’elle nomme, si bien qu’une nouvelle version reste bloquée tant que vous ne l’avez pas ajoutée à la liste. Claude Code ne lit ces deux clés que depuis les paramètres gérés.²²⁶²²⁷
• allowClaudeInChromeWithManagedMcp (géré, v2.1.282) : permet à claude --chrome de fonctionner aux côtés d’un managed-mcp.json exclusif ; le message d’erreur affiché lorsque Chrome est bloqué nomme désormais la clé.²²⁵ La référence des paramètres la documente désormais : la clé n’est lue que depuis les propres paramètres gérés de l’appareil, et une entrée deniedMcpServers pour claude-in-chrome bloque toujours le serveur.²³³

Paramètres récents (v2.1.285) :

• allowedProviders (géré, v2.1.285) : limite les fournisseurs API qu’une machine peut utiliser : l’API Anthropic, un point de terminaison personnalisé, Bedrock, Mantle, Vertex AI, Foundry, Claude Platform on AWS ou une passerelle Cloud.²²⁹ La référence des paramètres documente la clé ; une liste issue des sources d’administration propres à la machine continue de s’appliquer lorsque les paramètres gérés par le serveur en fournissent aussi une, de sorte qu’une session ne peut utiliser que les fournisseurs présents dans les deux listes.²³³

Index des paramètres : les options les plus recherchées

Si vous êtes arrivé ici en quête d’un paramètre précis, voici l’index abrégé. Chaque entrée indique la version qui l’a introduit et, lorsqu’une portée en est responsable, laquelle :

Où trouver la documentation officielle de chaque sujet ?

Ce guide est un manuel de terrain, pas la référence officielle. Lorsque vous avez besoin de la page canonique de Anthropic pour un sous-système, voici les emplacements officiels (chaque section de ce guide renvoie vers la sienne) :

Référence des variables d’environnement

Authentification et API :

ANTHROPIC_API_KEY=sk-ant-...                    # Direct API authentication
ANTHROPIC_AUTH_TOKEN=token                      # Custom authorization header
ANTHROPIC_CUSTOM_HEADERS="X-Key: val"           # Additional request headers; credential/org/routing/API-behavior headers set from managed or project settings require approval (v2.1.251)[^238]

Configuration du modèle :

ANTHROPIC_MODEL=claude-opus-4-7                 # Override default model (Apr 16, 2026)
ANTHROPIC_DEFAULT_MODEL=claude-opus-5-5         # Model new sessions START on; a /model pick overrides + persists (v2.1.236)
ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5    # What the `opus` alias resolves to (Opus 5.5 since v2.1.280; Opus 5 v2.1.219-278)
ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-6
ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5-20251001  # pin the haiku alias; on the Anthropic API it resolves to Haiku 5.5 (claude-haiku-5-5) as of v2.1.293[^274][^275]
CLAUDE_CODE_SUBAGENT_MODEL=sonnet               # Default model for subagents; an agent's model: field and per-spawn picks win (v2.1.251 demoted it from override to default)[^238]
CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1             # Turn the advisor tool off: /advisor becomes unavailable, advisorModel is ignored, --advisor is accepted but does nothing[^282]
CLAUDE_CODE_SUBAGENT_MODEL_FORCE=1              # Force every subagent onto CLAUDE_CODE_SUBAGENT_MODEL (or the main model), ignoring agent-definition and per-spawn overrides -- the pre-v2.1.251 behavior, opt-in (v2.1.257)[^243]
CLAUDE_CODE_DISABLE_WORKFLOWS=1                 # Turn dynamic workflows off for one session; same effect as "disableWorkflows": true, and whichever of the two turned them off, the other cannot turn them back on. Workflows are on by default except on Pro, where "enableWorkflows": true (the Dynamic workflows row in /config) turns them on; the v2.1.147 opt-in CLAUDE_CODE_WORKFLOWS=1 no longer appears in the env-vars reference[^291]
MAX_THINKING_TOKENS=10000                       # (Opus 4.6 and Sonnet 4.6 only — removed in Opus 4.7)
CLAUDE_CODE_MAX_OUTPUT_TOKENS=4000              # Limit output length
CLAUDE_CODE_MAX_TURNS=10                        # Cap agentic turns when no --max-turns is passed; the flag wins when both are set, and a value that is not a positive integer is rejected at startup[^291]
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1          # Enable agent teams (v2.1.32+)

Configuration du fournisseur cloud :

CLAUDE_CODE_USE_BEDROCK=1                       # Use AWS Bedrock
CLAUDE_CODE_USE_VERTEX=1                        # Use Google Vertex AI
CLAUDE_CODE_USE_FOUNDRY=1                       # Use Microsoft Foundry
ANTHROPIC_BEDROCK_BASE_URL=https://...          # Custom Bedrock endpoint
ANTHROPIC_BEDROCK_SERVICE_TIER=priority         # Bedrock service tier (v2.1.122+): 'default', 'flex', or 'priority'; sent as X-Amzn-Bedrock-Service-Tier header[^162]
CLAUDE_CODE_SKIP_BEDROCK_AUTH=1                 # Skip Bedrock auth (for gateways)
CLAUDE_CODE_SKIP_VERTEX_AUTH=1                  # Skip Vertex auth
AWS_BEARER_TOKEN_BEDROCK=token                  # Bedrock bearer token
VERTEX_REGION_CLAUDE_3_7_SONNET=us-west1        # Override Vertex region
VERTEX_REGION_CLAUDE_HAIKU_5_5=us-east5          # Vertex region for Claude Haiku 5.5 (v2.1.293+)[^276]
CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1    # Opt in gateway /v1/models discovery for /model picker (v2.1.129+)[^164]
CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS=3000  # Extend the LLM gateway /v1/models discovery timeout (default 3s; v2.1.269+)[^252]
CLAUDE_CODE_GATEWAY_HINT_HEADERS=1              # Send the x-claude-code-* hint headers (request-class, agent-type, prev-tool-durations, compaction, context-compacted, and prompt-id from v2.1.283) through a gateway or third-party provider; a direct Anthropic API connection sends them by default, and =0 stops them everywhere (v2.1.273+)[^253][^262][^263]
CLAUDE_CODE_AUTO_MODE_SERVER=0                  # Opt out of the server-side auto-mode checks, the default since v2.1.278 for Enterprise and Claude API accounts, Claude Platform on AWS, Bedrock, Agent Platform, Foundry, and gateways (not charged when the server performs them; =1 was the v2.1.273-277 opt-in); also applies on a direct Anthropic API connection since v2.1.281, where server-side is the default with telemetry off since v2.1.282; the docs call it temporary[^253][^255][^259][^260][^261]
CLAUDE_CODE_AUTO_MODE_MODEL=claude-sonnet-5-5   # Model the client-side auto mode classifier uses; no effect on server-side auto mode (v2.1.302+)[^283]

Contrôle du comportement :

DISABLE_AUTOUPDATER=1                           # Prevent automatic background updates
DISABLE_UPDATES=1                               # Block ALL update paths including manual `claude update` (v2.1.118+, stricter than DISABLE_AUTOUPDATER)[^160]
CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1       # Homebrew/WinGet installs run package-manager upgrade in background, then prompt restart (v2.1.129+)[^164]
DISABLE_TELEMETRY=1                             # Opt out of usage telemetry
DISABLE_ERROR_REPORTING=1                       # Disable Sentry
DISABLE_BUG_COMMAND=1                           # Disable /bug command
CLAUDE_CODE_DISABLE_WEB_FETCH=1                 # Turn off the WebFetch tool; WebSearch stays available (v2.1.285+)[^265][^269]
CLAUDE_CODE_DISABLE_ARTIFACT=1                  # Turn the Artifact tool off for one session; while it is set, no settings file turns artifacts back on[^291]
CLAUDE_CODE_ARTIFACT_AUTO_OPEN=0                # Do not open the browser when a new artifact is published[^291]
CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES=2      # Cap re-sends of a non-streaming fallback request that timed out (v2.1.285+)[^265]
CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS=5000 # Starting delay of the exponential backoff between retries of a 529 overloaded request, default 500; whole milliseconds from 500 to 32000; no effect with CLAUDE_CODE_RETRY_WATCHDOG=1 or in fast mode (v2.1.292+)[^272][^276]
CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS=60000 # Ceiling of that backoff, default 32000 ms (v2.1.296+; in the env-vars docs since October 14)[^274][^280]
CLAUDE_CODE_RETRY_WATCHDOG=1                     # Unattended sessions: retry 429 and 529 capacity errors indefinitely, backing off up to 5 minutes or until the limit resets (v2.1.186+)[^276]
CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS=1800000   # Cap, per request, on how long the watchdog waits out 429 and 529 errors; unset means no limit (v2.1.295+)[^274][^276]
CLAUDE_CODE_RETRY_WATCHDOG_MAX_USAGE_LIMIT_WAIT_MS=3600000 # Under the watchdog, end a request at a usage limit that resets further away than this instead of waiting it out (v2.1.301+)[^283]
CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS=60000 # Minimum interval between checks that a usage limit was lifted before its reset, while the watchdog waits on it (v2.1.305+)[^286][^287]
CLAUDE_CODE_RESTRICTED=1                        # Restricted mode: no command/code tools or WebFetch unless named in --tools; only managed settings load (v2.1.248+)[^238]
CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT=1      # Keep the dangerous-rm prompt waiting in auto mode and --dangerously-skip-permissions instead of denying after 2 minutes (v2.1.281+)[^260]
CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT=1    # Skip the prompt for a recursive rm whose target is only command-substitution output, such as rm -rf "$(pwd)" (v2.1.281+)[^260]
CLAUDE_CODE_STRICT_INLINE_SHELL_RM_PROMPT=1     # Keep prompting for an rm built at run time inside a shell -c script Claude Code cannot read; such scripts no longer prompt by default (v2.1.299+; release-notes only as of 2026-10-14)[^279][^280]
DISABLE_COST_WARNINGS=1                         # Hide cost warnings
DISABLE_PROMPT_CACHING=1                        # Disable prompt caching globally
DISABLE_PROMPT_CACHING_SONNET=1                 # Disable for Sonnet only
DISABLE_PROMPT_CACHING_OPUS=1                   # Disable for Opus only
DISABLE_NON_ESSENTIAL_MODEL_CALLS=1             # Skip non-critical API calls
ENABLE_PROMPT_CACHING_1H=1                      # Opt into 1-hour prompt cache TTL (v2.1.108+, API/Bedrock/Vertex/Foundry)
ENABLE_PROMPT_CACHING_1H_BEDROCK=1              # Deprecated alias for the above; v2.1.108+ still honors it on Bedrock but logs a deprecation notice
FORCE_PROMPT_CACHING_5M=1                       # Force 5-minute cache TTL (v2.1.108+)
CLAUDE_CODE_PROMPT_CACHE_TTL=1h                 # Main-conversation cache TTL, 5m or 1h; beats the promptCacheTtl setting (v2.1.242+)[^234]
CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL=5m        # TTL for subagents, workflows, forks, compaction, titles; beats subagentPromptCacheTtl (v2.1.242+)[^234]
ENABLE_TOOL_SEARCH=true                         # Re-enable tool search on Vertex AI (disabled by default v2.1.119+ to avoid unsupported beta header). Valid values: true, false, auto, auto:N[^160]
CLAUDE_CODE_HIDE_CWD=1                          # Hide the working directory in the startup logo (v2.1.119+)[^160]
CLAUDE_CODE_FORK_SUBAGENT=0                     # Turn fork subagents off; on by default in the terminal and, since v2.1.302, in claude -p, the Agent SDK, the desktop app, and VS Code (=1 was the external-build opt-in from v2.1.117; claude mcp serve never offers them)[^160][^283]
CLAUDE_CODE_FORCE_SYNC_OUTPUT=1                 # Force synchronized terminal output when auto-detection misses it, such as Emacs eat (v2.1.129+)[^164]
CLAUDE_CODE_SESSION_ID=...                      # Read-only: present in the Bash tool subprocess; matches the session_id passed to hooks (v2.1.132+)[^168]
CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1          # Skip the fullscreen alternate-screen renderer; keep the conversation in the terminal's native scrollback (v2.1.132+)[^168]
CLAUDE_EFFORT=...                               # Read-only: current effort level inside hooks and Bash tool subprocess (v2.1.133+)[^169]
CLAUDE_CODE_FORWARD_SUBAGENT_TEXT=1             # Include subagent text + thinking in stream-json output; pairs with --forward-subagent-text (v2.1.211+). Covers depth-2+ nested subagents as of v2.1.219[^205][^213]
CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION=200    # Per-session WebSearch cap (default 200; v2.1.212+). Since v2.1.290 an interactive session's budget refills instead of ending at 200 (next line); the env-vars docs, fetched Oct 6, still describe the 200 cap[^206][^271][^273]
CLAUDE_CODE_WEB_SEARCH_REFILLS_PER_HOUR=100     # WebSearch budget refill rate: 100 calls/hour by default in an interactive session, 0 (off) in a non-interactive one (v2.1.290+)[^271][^276]
CLAUDE_CODE_DISABLE_ATTACHMENTS=1               # Send @-mentions as plain text instead of expanding file content; a repo's .claude/settings.json or settings.local.json can no longer set it (v2.1.290)[^271][^273]
CLAUDE_CODE_DISABLE_FILE_MENTIONS=1             # Hand Claude the path of an @ mention to read with its file tools, not the file's contents, so PreToolUse hooks see the read; ignored in project and local settings (v2.1.299+)[^279][^280]
CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS=900000        # WebFetch per-URL session cache TTL (default 15 min; v2.1.233+)[^226]
CLAUDE_CODE_WEBFETCH_DEADLINE_MS=300000         # WebFetch hard deadline: a server that never finishes its response fails the fetch after 300s by default; 0 disables (v2.1.268+)[^252]
CLAUDE_CODE_PROJECT_DIR_NAME=myproj             # Short name for the per-project transcript directory, for hosts that give each session its own config dir (v2.1.234+)[^227]
CLAUDE_CODE_GOAL_CHECKIN_MINUTES=30             # How long background tasks may keep a /goal waiting before Claude checks in on them; 0 disables (v2.1.234+)[^227]
CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION=200       # Per-session subagent-spawn cap (default 200 in v2.1.212–223; the default cap was REMOVED in v2.1.224 — set this to reimpose one)[^206][^218]
CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS=20         # Cap on concurrently-RUNNING subagents (default 20; distinct from the per-session total above; v2.1.217+)[^211]
CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS=0        # Disable the v2.1.229 workflow fan-out stagger (same-prefix sibling agents launch staggered so they read the cached prompt prefix instead of re-paying it)[^224]
CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS=64   # Raise the Workflow tool's per-run concurrent agent limit, 1-256, for inference-bound fan-outs (v2.1.269+)[^252]
CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL=sonnet         # Run every workflow agent on one model while other subagents keep theirs (v2.1.296; release-notes only as of 2026-10-14)[^274][^280]
CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=3          # Nested subagent spawn depth. Default 3 as of v2.1.219; set 1 to disable nesting. Default history: 5 (v2.1.172–v2.1.216) → 1 (v2.1.217) → 3 (v2.1.219). Set it explicitly[^211][^213]

Configuration des outils :

BASH_DEFAULT_TIMEOUT_MS=30000                   # Bash command timeout (30s)
BASH_MAX_TIMEOUT_MS=600000                      # Maximum bash timeout (10min)
BASH_MAX_OUTPUT_LENGTH=50000                    # Read-back window from the Bash working output file (default 30,000 chars, hard ceiling 150,000)
CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR=1     # Reset CWD after each bash
MCP_TIMEOUT=5000                                # MCP server startup timeout
MCP_TOOL_TIMEOUT=30000                          # MCP tool execution timeout
MAX_MCP_OUTPUT_TOKENS=25000                     # MCP output limit
CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH=8192     # Override the cap on MCP tool descriptions and server instructions, every server in the session: 4,096 chars since v2.1.296, 2,048 in v2.1.280-295; Anthropic's first-party servers at api.anthropic.com are uncut since v2.1.299[^279][^256][^274]
CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS=120000       # Threshold before a long MCP tool call moves to the background (default 2 min; v2.1.212+)[^206]
CLAUDE_CODE_MCP_STARTUP_WAIT_MS=10000           # Bound how long the FIRST non-interactive turn waits for still-connecting MCP servers; 0 = don't wait (v2.1.274+)[^254]
CLAUDE_CODE_TOOL_MEMORY_LIMIT=4096              # Opt-in Linux memory cgroup (MB) for Bash tool commands — a runaway build can't stall the session (v2.1.233+)[^226]
CLAUDE_CODE_ENABLE_TODO_TOOLS=1                 # Offer the TodoWrite/TaskCreate-family tools on models outside v2.1.268's allowlist (Claude 3.x, Opus 4.0-4.7, Sonnet 4.0-4.6, Haiku 4.5); elsewhere they are off unless set (first turned off on newer models in v2.1.233)[^226][^252]
SLASH_COMMAND_TOOL_CHAR_BUDGET=15000            # Slash command context limit

Limite de durée des commandes en arrière-plan (v2.1.285, restreinte en v2.1.288) : les commandes Bash et PowerShell lancées en arrière-plan s’arrêtent au bout d’une durée limite, à savoir leur timeout lorsqu’elles sont exécutées avec run_in_background (30 minutes par défaut, 2 heures au maximum), et Claude est averti chaque fois que l’une d’elles est interrompue.²²⁹ Depuis la v2.1.288, cette limite ne s’applique qu’aux sessions sans surveillance (-p, le SDK Agent, la CI et les sessions cloud) ; les sessions dans le terminal, l’application de bureau et VS Code n’imposent aucune limite aux commandes en arrière-plan. La référence des outils le confirme : « Before v2.1.288, it applied in every session. »²³⁴²³⁷

Réseau et proxy :

HTTP_PROXY=http://proxy:8080                    # HTTP proxy
HTTPS_PROXY=https://proxy:8080                  # HTTPS proxy
CLAUDE_CODE_GZIP_REQUEST_BODIES=0              # Turn off gzip compression of large request bodies sent to api.anthropic.com, on even with telemetry off since v2.1.300[^281][^282]
NO_PROXY=localhost,example.com                  # Bypass proxy for domains
CLAUDE_CODE_CLIENT_CERT=/path/to/cert           # mTLS certificate
CLAUDE_CODE_CLIENT_KEY=/path/to/key             # mTLS private key
CLAUDE_CODE_CLIENT_KEY_PASSPHRASE=pass          # mTLS passphrase

Interface et terminal :

CLAUDE_CODE_DISABLE_TERMINAL_TITLE=1            # Don't update terminal title
CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL=1             # Skip IDE extension install
CLAUDE_CODE_SHELL=/bin/zsh                      # Override shell detection
USE_BUILTIN_RIPGREP=1                           # Use included ripgrep (default)
CLAUDE_CONFIG_DIR=~/.myconfig                   # Custom config directory; not settable from project-settings env (v2.1.251)[^238]
IS_DEMO=1                                       # Hide sensitive UI elements[^37]
CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1          # Disable background tasks and Ctrl+B[^46]
CLAUDE_CODE_TMPDIR=/path/to/tmp                 # Override temp directory; not settable from project-settings env, nor are TMPDIR/TMP/TEMP (v2.1.251)[^50][^238]
CLAUDE_CODE_DISABLE_1M_CONTEXT=1               # Hold ALL native-1M models to 200K via auto-compaction (v2.1.223 widened scope); also the opt-out for the v2.1.287 1M default on Bedrock/Vertex/Foundry/Claude apps gateway[^103][^217][^268]
CLAUDE_CODE_AUTO_COMPACT_WINDOW=200k           # Auto-compact window, 100000 to 1000000 tokens; k and M suffixes since v2.1.304 (200k had set a 100K window), out-of-range values warn[^286][^287]
CLAUDE_CODE_DISABLE_ULTRAREVIEW_TRUST_CHECK=1  # Let claude ultrareview run in a folder you have not trusted where it cannot ask, such as CI; environment only, not a settings env block (v2.1.309+)[^286][^287]
CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS=150000     # Context size at which idle compaction applies, default 200000; values below 100000 are raised to 100000; "idleCompaction": false in settings.json turns the feature off (v2.1.299; the docs date both to v2.1.290+)[^279][^280]
CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT=1  # Let unrecognized model IDs exceed the assumed context window (v2.1.223)[^217]
CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS=120000       # Plugin marketplace git timeout (default 120s, was 30s)[^105]
CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS=1        # Remove built-in commit/PR instructions[^117]
CLAUDE_CODE_DISABLE_CRON=1                    # Stop scheduled cron jobs mid-session[^121]
CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS=30000 # SessionEnd hooks timeout (default varies)[^123]
CLAUDE_CODE_USE_POWERSHELL_TOOL=1             # Enable Windows PowerShell tool on Linux/macOS (requires pwsh on PATH; v2.1.111+)[^153]
CLAUDE_CODE_DISABLE_MOUSE_CLICKS=1           # Disable mouse click/drag/hover in fullscreen mode; wheel scroll still works (v2.1.195+)[^196]
CLAUDE_ENABLE_STREAM_WATCHDOG=0              # Disable the streaming idle watchdog (on by default for all providers since v2.1.196: aborts+retries after 5 min of silence)[^198]
CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP=1 # Turn off automatic memory-pressure reaping of idle background shell commands (v2.1.193+)[^196]
CLAUDE_CODE_ENABLE_AWAY_SUMMARY=1             # Force Session Recap when telemetry disabled (v2.1.108+)[^153]
CLAUDE_CODE_BG_TASKS_REPORT_RUNNING=0         # Restore pre-v2.1.269 behavior: remote/headless sessions may report "waiting for your input" while background agents still run[^252]
CLAUDE_AX_SCREEN_READER=1                     # Enable screen reader mode; same as --ax-screen-reader or "axScreenReader": true (v2.1.208+)[^203]
CLAUDE_AX_PREPARK_MS=50                       # Screen reader mode: pause before writing a changed line; default 0 since v2.1.287 (was 50)[^268][^269]
OTEL_LOG_RAW_API_BODIES=1                     # Emit full API request/response bodies as OTel log events (v2.1.111+)[^153]
TRACEPARENT=00-...                            # W3C Trace Context parent (v2.1.110+, SDK/headless)[^153]
TRACESTATE=vendor=value                       # W3C Trace Context state (v2.1.110+, SDK/headless)[^153]

Exportateurs OpenTelemetry + filtrage des champs sensibles :²⁶⁸

OTEL_LOGS_EXPORTER=none                       # OTel logs exporter (supports 'none' for disable; v2.1.85 fixed crash)
OTEL_METRICS_EXPORTER=none                    # OTel metrics exporter (supports 'none'; v2.1.85 fixed crash)
OTEL_TRACES_EXPORTER=none                     # OTel traces exporter (supports 'none'; v2.1.85 fixed crash)
OTEL_LOG_TOOL_CONTENT=1                       # Opt in to emitting tool content in OTel spans (v2.1.101+, sensitive by default)
OTEL_LOG_TOOL_DETAILS=1                       # Opt in to tool_parameters in OTel tool_result events (v2.1.85+); as of v2.1.273 also puts real agent, skill, plugin, and MCP server names on cost and token metrics[^253]
OTEL_LOG_USER_PROMPTS=1                       # Opt in to emitting user prompts in OTel traces (v2.1.101+, sensitive by default)
OTEL_LOG_ASSISTANT_RESPONSES=0                # Gate the claude_code.assistant_response log event holding the model's response text (v2.1.193+)
OTEL_METRICS_INCLUDE_REPOSITORY=1             # Tag OTel metrics and events with vcs.* repository attributes; with OTEL_LOG_TOOL_DETAILS, commit events carry vcs.ref.head.* (v2.1.269+)[^252]
CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH=60000     # Truncation limit for OTel content attributes (default 60 KB; v2.1.214+)[^207]
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1    # Disable release-notes fetch (v2.0.17+); v2.1.110 also stopped the auto-title Haiku request in headless/SDK when set; v2.1.290 also skips the startup connection warm-up[^271]
CLAUDE_CODE_ATTRIBUTION_HEADER=0              # Omit the system-prompt attribution block; behind a Claude apps gateway, set it in the env of the gateway's code or cli policy (v2.1.299+)[^279][^280]

Les paramètres de projet ne peuvent pas activer la télémétrie (v2.1.282) : les fichiers de paramètres de projet et locaux ignorent désormais les variables OpenTelemetry qui activent l’export, définissent son endpoint ou capturent du contenu, comme CLAUDE_CODE_ENABLE_TELEMETRY, les sélecteurs OTEL_*_EXPORTER et OTEL_LOG_*. Les valeurs qui désactivent quelque chose (none pour un sélecteur d’exporter, 0 pour un indicateur de contenu) restent appliquées depuis ces fichiers. Définissez les autres dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Une session interactive affiche un avis au démarrage lorsqu’un fichier de projet en définit une, et /status comme claude doctor listent les noms ignorés ; les sessions -p et Agent SDK n’affichent aucun avis : vérifiez donc après la mise à jour que votre collecteur reçoit toujours des données.²²⁵²²⁷

Attributs des spans par requête LLM (v2.1.121+) : stop_reason, gen_ai.response.finish_reasons et user_system_prompt sont désormais émis sur les spans par requête LLM. user_system_prompt est conditionné à OTEL_LOG_USER_PROMPTS=1, car il peut contenir des données personnelles.¹⁵⁴

Changements au niveau des événements (v2.1.122+) : les attributs numériques des événements de log api_request et api_error sont désormais émis sous forme de nombres (et non plus de chaînes), ce qui corrige les collecteurs OTel en aval qui typaient strictement le schéma. Le nouvel événement de log claude_code.at_mention se déclenche lorsque Claude Code résout une mention @.¹⁵⁴

Attributs de la v2.1.300 : les événements api_request séparent les écritures de cache en cache_creation_5m_tokens et cache_creation_1h_tokens ; les spans de trace portent les attributs des conventions sémantiques GenAI (gen_ai.provider.name, gen_ai.conversation.id, gen_ai.tool.name, error.type) ; les événements user_prompt et les spans d’interaction enregistrent le prompt tel que l’a réécrit le hook prompt.submit d’un mod ; enfin, les événements tool_result portent git_commit_id après un git commit -q dans les dépôts reftable.²⁷³

Attributs des v2.1.301 et v2.1.302 : les événements tool_decision portent classifier_verdict et permission_mode, ce qui permet de distinguer une décision du classifieur du mode auto d’une règle de permission, ainsi que, avec OTEL_LOG_TOOL_DETAILS=1, classifier_category, qui nomme la règle intégrée à laquelle correspond un blocage du classifieur (v2.1.301) ; la v2.1.302 renseigne classifier_category pour la plupart des blocages du classifieur, où il manquait jusque-là, et conserve tool_use_id, tool_source et tool_parameters sur l’événement lorsque OTEL_LOGRECORD_ATTRIBUTE_COUNT_LIMIT est bas. La documentation de monitoring ne mentionne pas encore ces trois attributs.²⁷⁵²⁷⁶

Événement de la v2.1.307 : claude_code.safety_event se déclenche pour chaque appel d’outil qu’une règle de permission, le mode auto, un contrôle de sécurité, un hook ou la sandbox a arrêté, soumis à confirmation ou renvoyé ; tool_use_id y figure, sauf pour les événements de fin de tour. La documentation de monitoring le mentionne et liste désormais aussi classifier_verdict (v2.1.301+).²⁷⁸²⁷⁹

Événement de log claude_code.assistant_response (v2.1.193+) : Claude Code peut émettre le texte complet de la réponse du modèle sous forme d’événement de log OTel, conditionné par OTEL_LOG_ASSISTANT_RESPONSES. Ce conditionnement cache un piège de mise à jour à connaître : lorsque OTEL_LOG_ASSISTANT_RESPONSES n’est pas défini, il suit OTEL_LOG_USER_PROMPTS. Tout déploiement qui journalise déjà le contenu des prompts commencera donc à recevoir le contenu des réponses de l’assistant après la mise à jour. Définissez OTEL_LOG_ASSISTANT_RESPONSES=0 pour limiter la télémétrie aux prompts.¹⁷⁹

Ajouts de télémétrie de la v2.1.214 : les événements de log OTel portent désormais les attributs message.uuid, client_request_id et tool_source, pour la corrélation au niveau des messages et la provenance des outils ; la charge utile subagentStatusLine inclut l’effort de raisonnement du subagent, ce qui permet aux lignes de statut personnalisées d’afficher ensemble le modèle et l’effort ; enfin, la nouvelle variable d’environnement CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH configure la limite de troncature de 60 Ko appliquée aux attributs de contenu OTel.¹⁹⁰

Télémétrie de la passerelle (v2.1.265) : les sessions de la passerelle d’applications Claude exportent désormais OpenTelemetry directement vers un collecteur lorsque les paramètres gérés de la passerelle en désignent un dans OTEL_EXPORTER_OTLP_ENDPOINT, au lieu de passer par le relais de la passerelle ; les sessions sans collecteur désigné continuent d’utiliser le relais. La même version ajoute user.email et user.groups à la télémétrie que Claude Desktop et Cowork envoient via une passerelle d’applications Claude, à l’image des sessions en terminal.²¹⁵

Télémétrie des hooks (v2.1.280) : l’événement OTel hook_execution_complete porte désormais la taille des sorties des hooks et le nombre de sorties trop volumineuses enregistrées dans un fichier.²²⁰

prompt_text (v2.1.287) : l’événement user_prompt porte désormais prompt_text, une copie de prompt destinée aux backends qui imbriquent les clés à points. Partout où votre pipeline supprime ou masque prompt, faites de même pour prompt_text.²³²

API / Contrôle du modèle :²⁶⁸

CLAUDE_CODE_EXTRA_BODY='{...}'                # Inject extra body fields into API calls; v2.1.113 fixed 400 errors with output_config.effort on Vertex/subagent calls
CLAUDE_CODE_MAX_CONTEXT_TOKENS=200000         # Override max context tokens (pre-existing var; v2.1.98 fixed handling of DISABLE_COMPACT when both are set)
CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS=25000 # Override default token limit for file read operations (v2.1.0+); a Read call with allow_large can pass it when the context has room (v2.1.296+)[^274][^276]
CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK=1   # Do not fall back to non-streaming API on streaming failures (v2.1.83+)
CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS=1      # Stop sending structured outputs, for Mantle or gateways that reject them; session titles, memory recall, and prompt hooks failed there before (v2.1.288+)[^270][^273]
ANTHROPIC_BETAS=beta1,beta2                   # Enable beta API headers; v2.1.78 fixed silent ignore on Haiku models
ANTHROPIC_SMALL_FAST_MODEL=arn:...            # Fast model ID (Bedrock ARN supported; v0.2.125 stopped escaping slashes in ARN)

Plugins / MCP :²⁶⁸

CLAUDE_CODE_PLUGIN_CACHE_DIR=~/.claude/plugins # Plugin cache directory (v2.1.72 fixed literal '~' dir on some shells)
CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1 # Preserve plugin marketplace cache when git pull fails (offline-friendly; v2.1.90+)
CLAUDE_CODE_MCP_SERVER_NAME=server1           # Passed to MCP headersHelper scripts so one helper can serve multiple servers (v2.1.85+)
CLAUDE_CODE_MCP_SERVER_URL=https://...        # Passed to MCP headersHelper scripts alongside the name (v2.1.85+)
MCP_SDK_GENERATION=v1                         # Opt out of the v2 MCP client; v2.1.274 made v2 the default on the last holdouts (Bedrock/Vertex/Foundry + telemetry-disabled installs)[^254]
MCP_PROTOCOL_NEGOTIATION=legacy               # Opt out of MCP 2026-07-28 protocol negotiation: with direct HTTP servers (default everywhere as of v2.1.274) and, since v2.1.292, with local (stdio) servers on every install, Bedrock, Vertex, and Foundry included and, since v2.1.299, with cloud session and Remote Control connectors[^279][^254][^272]

Shell / IDE :²⁶⁸

CLAUDE_CODE_SHELL_PREFIX="time "              # Wrap every Claude-invoked shell command with a prefix (v1.0.61+)
CLAUDE_CODE_GIT_BASH_PATH=C:\Program\ Files\Git\bin\bash.exe  # Custom Git Bash path on Windows (v2.1.98+)
CLAUDE_CODE_EXIT_AFTER_STOP_DELAY=60000       # SDK: exit after N ms idle (v2.0.35+)
CLAUDE_CODE_AUTO_CONNECT_IDE=false            # Disable IDE auto-connection (v1.0.61+)

Entreprise / authentification :²⁶⁸

CLAUDE_CODE_PROXY_RESOLVES_HOSTS=1            # Opt into proxy-side DNS resolution (v2.0.55 moved this from default-on to opt-in)
CLAUDE_CODE_API_KEY_HELPER_TTL_MS=300000      # TTL for dynamically generated API keys via apiKeyHelper (apiKeyHelper refresh added v0.2.74 with 5-min default; env var added v0.2.117)
CLAUDE_CODE_PROCESS_WRAPPER=/path/to/wrapper  # Route all Claude Code self-spawned processes through a wrapper executable; same as the processWrapper setting (v2.1.208+)[^203]

Variables des skills (v2.1.69+) :

${CLAUDE_SKILL_DIR}                            # Self-reference for skills to locate their own directory[^117]

Identité de l’appelant SDK (v2.1.51+) :

CLAUDE_CODE_ACCOUNT_UUID=uuid                  # Provide account UUID synchronously for SDK callers
CLAUDE_CODE_USER_EMAIL=user@example.com        # Provide user email for SDK callers
CLAUDE_CODE_ORGANIZATION_UUID=uuid             # Provide organization UUID for SDK callers

Débogage :

ANTHROPIC_LOG=debug                             # Enable API request logging

Quel modèle choisir ?

Le choix du bon modèle pour chaque tâche a un impact considérable sur le coût et la qualité. Claude Code vous permet de changer facilement de modèle à plusieurs niveaux.

Modèles disponibles

Claude Sonnet 5.5 (28 septembre 2026) : Le modèle Sonnet par défaut sur Anthropic API depuis la v2.1.284, qui fait pointer l’alias sonnet vers ce modèle ; le modèle par défaut de toutes les offres reste Opus 5.5. Identifiant du modèle : claude-sonnet-5-5 (Bedrock : anthropic.claude-sonnet-5-5). 2 $/MTok en entrée, 10 $/MTok en sortie, comme Sonnet 5, avec des lectures du cache à 0,10 $/MTok (0,05 fois le prix d’entrée selon la page des tarifs, soit le même taux qu’Opus 5.5 ; la v2.1.296 corrige les montants calculés par Claude Code, qui utilisait 0,20 $). Fenêtre de contexte de 1M de tokens, sortie maximale de 128 000 tokens (jusqu’à 300 000 sur Batches API avec l’en-tête bêta output-300k-2026-03-24). Date limite des connaissances fiables : juin 2026, comme Opus 5.5 et Fable 5.1. Retrait au plus tôt le 28 septembre 2027. Dans Claude Code, effort est défini sur medium par défaut pour Sonnet 5.5 (la valeur par défaut propre à Claude API est high), et le raisonnement ne peut pas être désactivé. Repli selon le contenu : une requête signalée comme relevant de la cybersécurité est réexécutée sur Sonnet 5, tandis qu’une requête signalée comme relevant de la biologie se termine par un refus, car Sonnet 5.5 ne dispose d’aucun modèle de repli pour la biologie. Nécessite Claude Code v2.1.284 ou une version ultérieure ; pour conserver Sonnet 5, fixez ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5.²²⁸²³⁰

La page du modèle répertorie cinq changements incompatibles pour le code API migrant depuis Sonnet 5 : le raisonnement préalable est désactivé avec between_tools, l’utilisation forcée d’outils renvoie une erreur, les blocs de raisonnement sont liés au modèle et à la conversation, computer_20251124 n’est pas accepté sur Claude API et Google Cloud, et l’outil de conseil rejette Opus 4.8, Opus 4.7 et Sonnet 5 comme conseillers. Le texte entre les appels d’outils est également renvoyé dans des blocs thinking : une interface qui l’affiche en continu cesse donc de l’afficher tant qu’elle ne définit pas une valeur display permettant de renvoyer ce texte.²³⁰

Claude Opus 5.5 (22 septembre 2026) : Le nouveau modèle Opus par défaut dans Claude Code depuis la v2.1.280 – et, selon le tableau par offre de la documentation de configuration des modèles, le modèle par défaut pour toutes les offres et tous les fournisseurs directs : Pro, Max, Team, Enterprise, Anthropic API, Claude Platform on AWS, Amazon Bedrock et Agent Platform de Google Cloud (Microsoft Foundry conserve Sonnet 4.5, et son alias opus désigne Opus 4.6). Cette même version fait passer le modèle par défaut de Pro et Team Standard de Sonnet à Opus, « comme pour Max, Team Premium et Enterprise » – mettant fin à la différence entre offres qui persistait depuis le passage du niveau premium à Opus. Identifiant du modèle : claude-opus-5-5 (Bedrock : anthropic.claude-opus-5-5) – un instantané fixe sans date, selon le même principe que claude-opus-5. Les tarifs passent sous ceux d’Opus 5 : 4 $/MTok en entrée, 20 $/MTok en sortie (Opus 5 : 5 $/25 $), avec des lectures du cache à 0,20 $/MTok – 5 % du prix d’entrée, soit la moitié des 10 % habituels (seuls Fable 5.1 et Mythos 5.1 descendent plus bas, à 2,5 %). Fenêtre de contexte de 1M de tokens, sortie maximale de 128 000 tokens (jusqu’à 300 000 sur Batches API avec l’en-tête bêta output-300k-2026-03-24). Raisonnement adaptatif toujours actif – le tableau de présentation des modèles lui attribue la même mention « Adaptatif (toujours actif) » qu’à Fable, alors que celui d’Opus 5 était activé par défaut mais pouvait être désactivé. effort est défini sur medium par défaut (Opus 5 utilisait high par défaut), et la v2.1.280 adapte la règle de reprise des réglages en conséquence : un niveau d’effort enregistré avant que /effort ne soit propre à chaque modèle ne s’applique plus aux nouveaux modèles tels qu’Opus 5.5 – le modèle utilise sa propre valeur par défaut jusqu’à ce que vous choisissiez un niveau. Date limite des connaissances fiables : juin 2026 (données d’entraînement également de juin 2026), à égalité avec Fable 5.1 pour la date la plus récente parmi les modèles actuels. Retrait au plus tôt le 22 septembre 2027. Nécessite Claude Code v2.1.280 ou une version ultérieure.²²⁰²²¹

Changements incompatibles lors de la migration de votre code API d’Opus 5 vers Opus 5.5 :²²²

1. Le raisonnement ne peut pas être désactivé. thinking: {type: "disabled"} et thinking: {type: "enabled", budget_tokens: N} renvoient tous deux une erreur 400. Supprimez le champ thinking et choisissez plutôt un niveau d’effort.
2. L’utilisation forcée d’outils renvoie une erreur. tool_choice n’accepte que auto et none ; any et tool renvoient une erreur 400, y compris sur le point de terminaison de comptage des tokens. Utilisez auto avec l’utilisation stricte d’outils ou des sorties structurées.
3. Les blocs de raisonnement sont liés au modèle. Un routeur ou un mécanisme de repli qui transfère une conversation d’Opus 5.5 vers un autre modèle exécute ces tours sans les blocs de raisonnement d’Opus 5.5 (Fable 5.1 et Mythos 5.1 sur Claude API font exception).
4. computer_20251124 est rejeté sur Claude API et Google Cloud. Déclarez plutôt l’ensemble d’outils computer_toolset_20260801 ; Bedrock conserve l’ancien outil. Un autre changement ne fait échouer aucune requête, mais modifie la structure de la réponse : le texte que le modèle écrit entre les appels d’outils est renvoyé dans des blocs thinking, vides avec la valeur par défaut de display. Une interface qui diffuse ces commentaires en continu devient silencieuse tant qu’elle ne définit pas display: "updates" (bêta) ou "summarized".²²²

Basculement selon le contenu dans Claude Code. Opus 5.5 fonctionne avec des classificateurs de sécurité qui signalent le plus souvent des contenus liés à la biologie et à la cybersécurité. Lorsqu’un classificateur signale une requête, Claude Code la relance sur un autre modèle et affiche un avis : les requêtes signalées pour leur contenu biologique passent à Opus 5, celles signalées pour leur contenu de cybersécurité à Opus 4.8, et la session reste sur ce modèle de repli jusqu’à ce que vous reveniez au modèle initial avec /model. Désactivez Changer de modèle lorsqu’un message est signalé dans /config (switchModelsOnFlag: false) pour que votre accord soit demandé à chaque fois.²²³ Depuis la v2.1.287, le basculement conserve votre niveau d’effort actuel au lieu d’adopter celui du modèle de repli par défaut : une session au niveau medium, valeur par défaut d’Opus 5.5, reste donc à medium sur Opus 4.8, dont la valeur par défaut est high.²³²²³³

Claude Opus 5 (juillet 2026 ; précédent modèle de la gamme Opus) : Le modèle de la gamme Opus vers lequel pointait l’alias opus depuis la v2.1.219 (24 juillet 2026) jusqu’à ce que la v2.1.280 fasse d’Opus 5.5 le modèle Opus par défaut ; ce qui suit décrit son état au lancement en juillet 2026. Anthropic le présente comme un remplacement direct d’Opus 4.8 : les mêmes tarifs de 5 $/MTok en entrée et 25 $/MTok en sortie, « des performances nettement améliorées pour le même coût » et environ 26 % de tokens en moins en moyenne au niveau de raisonnement maximal par rapport à Opus 4.8. Il était le modèle par défaut sur Claude Max et le modèle le plus performant sur Claude Pro. Identifiant du modèle : claude-opus-5 — un instantané figé sans date, selon le même principe que claude-opus-4-8 et claude-sonnet-5, et non un pointeur continuellement actualisé. Fenêtre de contexte de 1M de tokens (sans en-tête bêta, inchangée par rapport à Opus 4.8), sortie maximale de 128K (jusqu’à 300K sur l’API Batches avec l’en-tête bêta output-300k-2026-03-24). Raisonnement adaptatif uniquement — le raisonnement étendu avec thinking.type: "enabled" n’est pas pris en charge. Date limite des connaissances fiables : mai 2026 (les données d’entraînement s’arrêtent également à mai 2026) — la plus récente parmi tous les modèles Claude disponibles, de son lancement jusqu’à l’arrivée de Fable 5.1 (connaissances arrêtées à juin 2026) le 1er septembre 2026.²⁴¹ Avec l’arrivée d’Opus 5, Opus 4.8 rejoint le tableau des anciens modèles de la documentation aux côtés de 4.7 et 4.6 — il reste disponible, mais n’est plus recommandé par défaut.¹⁹⁷

Deux changements incompatibles lorsque vous migrez un environnement d’orchestration d’Opus 4.8 vers Opus 5 :¹⁹⁷

1. Le raisonnement est activé par défaut. Sur Opus 4.8, une requête sans champ thinking s’exécutait sans raisonnement ; sur Opus 5, la même requête s’exécute avec le raisonnement adaptatif. max_tokens reste une limite stricte sur la sortie totale — raisonnement et texte de réponse —, vérifiez donc à nouveau la marge disponible pour toute charge de travail qui s’exécutait auparavant sans raisonnement. Passez thinking: {type: "disabled"} pour rétablir l’ancien comportement, sous réserve du point suivant.
2. Lorsque le raisonnement est désactivé, le niveau d’effort est plafonné à high. Associer thinking: {type: "disabled"} à un effort xhigh ou max renvoie une erreur 400. Le contrôle s’applique à chaque requête — passer l’effort à xhigh alors que le raisonnement est désactivé est refusé, même si les tours précédents de la même conversation ont été acceptés.

Dans Claude Code en particulier : effort vaut high par défaut sur Opus 5 (comme sur l’API Claude), et tous les niveaux sont disponibles — low, medium, high, xhigh, max. Dans ses propres conseils de migration, Anthropic recommande de tester le niveau d’effort max lorsque les capacités comptent davantage que la consommation de tokens. Le mode rapide prend en charge Opus 5 à 10 $/50 $ par MTok (voir Mode rapide).¹⁹⁷¹⁹⁸

Claude Fable 5.1 (1er septembre 2026) : Le nouveau sommet de la gamme Fable et, depuis la v2.1.257, le modèle vers lequel pointe l’alias fable (sauf si ANTHROPIC_DEFAULT_FABLE_MODEL en fixe un autre) ; best signifie désormais « le dernier modèle Fable auquel vous avez accès ». La version minimale mérite une précision : la documentation de configuration des modèles indique que l’alias a changé en v2.1.255 et la page du modèle précise que Fable 5.1 « nécessite Claude Code v2.1.255 ou ultérieure », mais les versions 2.1.253 à 256 n’ont jamais été publiées sur npm — la v2.1.257 (1er septembre) est la première version installable qui l’intègre. Identifiant du modèle : claude-fable-5-1 (Bedrock : anthropic.claude-fable-5-1). Même gamme et mêmes tarifs par token que Fable 5 — 10 $/MTok en entrée, 50 $/MTok en sortie, contexte de 1M, sortie maximale de 128K, raisonnement adaptatif toujours actif, effort à high par défaut — avec un changement tarifaire qui compte pour les longues sessions agentiques : les lectures du cache coûtent 0,25 $/MTok, soit 0,025× le prix d’entrée (2,5 %), contre les 10 % habituels ; seuls Fable 5.1 et Mythos 5.1 bénéficient de ce tarif, et les écritures dans le cache restent au tarif standard (12,50 $ pour 5 minutes, 20 $ pour 1 heure). Date limite des connaissances fiables : juin 2026 (les données d’entraînement s’arrêtent également à juin 2026) — la plus récente parmi tous les modèles Claude disponibles, égalée par Opus 5.5 (connaissances arrêtées à juin 2026) le 22 septembre 2026 et Sonnet 5.5 le 28 septembre. Retrait au plus tôt le 1er septembre 2027. Depuis la v2.1.301, lorsque le dernier modèle Fable n’est pas disponible pour votre organisation, fable et best réessaient une fois avec le modèle Fable précédent au lieu de renvoyer une erreur.²⁷⁵

Trois changements incompatibles par rapport à Fable 5 : l’utilisation forcée d’outils renvoie une erreur, les modèles précédents ne peuvent pas lire ses blocs de raisonnement, et la modification des tours précédents invalide les blocs de raisonnement. Cinq ajouts : l’effort par message (bêta), les messages système limités à un tour (bêta), les mises à jour de progression entre les appels d’outils (display: "updates", bêta), les lectures du cache moins coûteuses et la provenance du contenu. Claude Mythos 5.1 est le même modèle, avec les mêmes caractéristiques, accessible uniquement sur invitation via Project Glasswing. Avec ce lancement, Fable 5 rejoint le tableau des anciens modèles de la documentation aux côtés d’Opus 4.8/4.7/4.6/4.5 et de Sonnet 4.6/4.5.

Une réserve concernant la passerelle figure dans les notes de version : dans les sessions passant par la passerelle des applications Claude, fable et best continuent pour l’instant de pointer vers Fable 5 — une passerelle qui n’est pas encore configurée pour 5.1 le rejette —, sélectionnez donc explicitement Fable 5.1 dans /model dans ce cas ; avant la v2.1.260, le sélecteur /model ne proposait pas Fable 5.1, il fallait donc saisir la commande complète /model claude-fable-5-1 pour le sélectionner explicitement (voir les correctifs liés au lancement ci-dessous). Modèles par défaut des offres au lancement : Opus 5 sur les offres premium, Sonnet 5 sur Pro et Team Standard — remplacés par Opus 5.5 par défaut sur toutes les offres à partir de la v2.1.280 (22 septembre 2026).^211241242221

Correctifs liés au lancement de Fable 5.1 (v2.1.260, 3 septembre) : la première version après le lancement corrige quatre problèmes. Le sélecteur /model affiche désormais Fable 5.1 pour les organisations qui peuvent l’utiliser — avant ce correctif, le modèle n’était accepté qu’en saisissant la commande complète /model claude-fable-5-1. La mise en cache des prompts sur Fable 5.1 couvre désormais le contexte ajouté après les résultats d’outils, qui était auparavant renvoyé comme entrée non mise en cache à chaque tour comportant un appel d’outil — ce qui réduisait discrètement les économies permises par le tarif de lecture du cache à 0,025×, précisément dans les longues sessions agentiques auxquelles elles sont destinées. Modifier /effort en cours de session n’invalide plus le cache des prompts. Enfin, les agents model: fable respectent désormais le marqueur [1m] lorsqu’un modèle est fixé via ANTHROPIC_DEFAULT_FABLE_MODEL, au lieu de fonctionner silencieusement avec une fenêtre de contexte de 200K.²¹²

Claude Fable 5 (9 juin 2026 ; ancien modèle depuis le 1er septembre 2026) : Une nouvelle gamme de modèles au-dessus d’Opus — le modèle le plus puissant et le plus intelligent de Anthropic, à la pointe sur presque tous les bancs d’essai auxquels il a été soumis, et conçu pour rester cohérent sur des millions de tokens de contexte. Fable 5 est le modèle de pointe « de classe Mythos » sécurisé pour un usage général : il intègre des classificateurs de sécurité qui déclenchent un basculement vers Opus 4.8 pour les requêtes liées à la cybersécurité, à la biologie et à la chimie, ainsi qu’à la distillation de modèles (Claude Mythos 5 est le même modèle, avec ces protections levées pour les chercheurs autorisés). Il est devenu sélectionnable dans Claude Code avec la v2.1.170 (9 juin 2026) — exécutez claude update, puis /model fable (l’alias court, qui pointe vers Fable 5.1 depuis la v2.1.257 — pour sélectionner Fable 5 aujourd’hui, utilisez /model claude-fable-5) — et son déploiement sur les offres d’abonnement s’est achevé le 22 juin 2026. Identifiant du modèle : claude-fable-5. Fable 5 inclut une fenêtre de contexte de 1M par défaut, le suffixe [1m] est donc inutile — et depuis la v2.1.173 (11 juin 2026), le nom de modèle claude-fable-5[1m] est automatiquement normalisé en claude-fable-5 par suppression du suffixe (celui-ci n’a jamais eu de sens que sur Opus/Sonnet, où [1m] conditionne l’accès au contexte de 1M) ; sortie maximale de 128K. Les tarifs sont de 10 $/MTok en entrée et de 50 $/MTok en sortie — soit environ 2× ceux d’Opus 4.8 —, réservez-le donc aux raisonnements vraiment difficiles, plutôt qu’aux modifications courantes. Il accepte les mêmes paramètres de requête qu’Opus 4.8 (raisonnement adaptatif uniquement ; temperature/top_p/top_k et budget_tokens supprimés), avec une nouvelle particularité : définir explicitement thinking: {type: "disabled"} renvoie une erreur 400 ; omettez donc entièrement le paramètre thinking pour exécuter une requête sans raisonnement.²⁶¹ Dans Claude Code en particulier : Fable 5 prend en charge toute l’échelle d’effort (low/medium/high/xhigh/max, avec high par défaut), comme Opus 5. La réflexion ne peut pas être désactivée sur Fable 5 — ni le bouton de réflexion de la session, ni le paramètre alwaysThinkingEnabled, ni MAX_THINKING_TOKENS=0 n’ont d’effet ; le modèle raisonne toujours de manière adaptative. La famille fable dispose d’un ensemble complet de paramètres de configuration équivalents à ceux d’Opus : ANTHROPIC_DEFAULT_FABLE_MODEL fixe le modèle auquel renvoie l’alias fable (utile sur Bedrock/Vertex/Foundry), DISABLE_PROMPT_CACHING_FABLE désactive la mise en cache des prompts pour Fable, et le basculement automatique selon le contenu s’applique aux passerelles d’entreprise. /model opus sélectionne désormais Opus 5.5 (v2.1.280 ; effort medium par défaut, /effort xhigh pour les tâches les plus difficiles), et le modèle par défaut ne dépend plus de votre forfait — Opus 5.5 est le modèle par défaut de tous les forfaits exploités par Anthropic, à l’exception de Microsoft Foundry ; choisissez explicitement la gamme Fable avec /model fable lorsque vous souhaitez les capacités maximales — ce qui, depuis la v2.1.257, correspond à Fable 5.1.^{261197207242220221}

Opus 4.7 (16 avril 2026) : Le modèle phare de la génération précédente, toujours pleinement disponible. Fenêtre de contexte de 1 million de tokens au tarif standard — sans supplément pour les contextes longs. Sortie maximale de 128 000 tokens, réflexion adaptative uniquement (la réflexion étendue a été supprimée) et nouveau niveau d’effort xhigh, recommandé comme point de départ pour le développement et les tâches agentiques.¹⁴⁵ Date limite des connaissances fiables : janvier 2026. Date limite des données d’entraînement : janvier 2026. Identifiant du modèle : claude-opus-4-7. Les tarifs sont identiques à ceux d’Opus 4.6, soit 5 $/25 $ par MTok, avec l’écriture en cache de 5 minutes à 6,25 $, l’écriture en cache de 1 heure à 10 $ et la lecture du cache à 0,50 $ par MTok.¹⁴⁴ Opus 4.7 résout 3× plus de tâches de production sur SWE-Bench qu’Opus 4.6, atteint 70 % sur CursorBench (contre 58 % pour la version 4.6) et améliore de 13 % le taux de résolution sur le benchmark interne de Anthropic, composé de 93 tâches de développement.¹⁴⁴ Il utilise un nouveau tokenizer — prévoyez environ 1× à 1,35× plus de tokens pour un même texte ; augmentez la marge de max_tokens et ajustez les seuils de déclenchement de la compaction.¹⁴⁵ La vision prend en charge des images jusqu’à 2 576 px / 3,75 MP avec des coordonnées de pixels à l’échelle 1:1.¹⁴⁵

Benchmarks de développement d’Opus 4.7 (avril 2026) :¹⁵¹

Modèle par défaut selon le forfait (Claude Code) :²⁰⁷²²¹

Depuis la v2.1.280 (22 septembre 2026), la distinction entre forfaits a disparu : tous les forfaits exploités par Anthropic et tous les fournisseurs directs utilisent Opus 5.5 par défaut, Microsoft Foundry restant la seule exception. La question auparavant décisive ici — « quel est mon forfait ? » — ne change plus la réponse.

Changements incompatibles de Messages API dans Opus 4.7 (visibles côté appelant) :¹⁴⁵

• Le paramètre budget_tokens de la réflexion étendue est supprimé. Utilisez thinking: {type: "adaptive"} à la place. La réflexion adaptative est désactivée par défaut ; les requêtes sans champ thinking s’exécutent sans réflexion.
• Définir temperature, top_p ou top_k sur une valeur autre que celle par défaut renvoie une erreur HTTP 400. Omettez ces paramètres et orientez le modèle à l’aide de vos prompts.
• Le contenu de la réflexion est omis des réponses par défaut. Définissez thinking.display: "summarized" pour rendre le raisonnement de nouveau visible (nécessaire si votre produit diffuse la réflexion en continu aux utilisateurs).

Les budgets de tâche (en-tête bêta task-budgets-2026-03-13) permettent d’indiquer au modèle un nombre cible de tokens pour une boucle agentique complète via output_config.task_budget ; minimum de 20 000 tokens.¹⁴⁵

Opus 4.6 (ancienne génération) : Toujours disponible sous l’identifiant claude-opus-4-6, avec un contexte de 1 million de tokens et une sortie maximale de 128 000 tokens. Envisagez de migrer vers Opus 4.7 pour de meilleures performances en développement agentique. Opus 4.6 est sorti le 5 février 2026.⁷⁹¹⁴⁴ Depuis la v2.1.117 (22 avril 2026), les abonnés Pro et Max utilisent par défaut le niveau d’effort high sur Opus 4.6 et Sonnet 4.6 (auparavant medium) ; Opus 4.7 reste à xhigh. Ce changement a rétabli les capacités de raisonnement après la réduction de l’effort appliquée du 4 mars au 7 avril, documentée dans l’analyse rétrospective du 23 avril.¹⁵²¹⁵³

Sonnet 5 (30 juin 2026 ; génération Sonnet précédente) : Le modèle sélectionné par l’alias sonnet sur Anthropic API de la v2.1.197 jusqu’à son remplacement par Sonnet 5.5 dans la v2.1.284. Au lancement, Anthropic le présentait comme « la meilleure combinaison de vitesse et d’intelligence ». Selon Anthropic, ses performances sont proches de celles d’Opus 4.8, mais à des tarifs inférieurs, et il représente une amélioration substantielle par rapport à Sonnet 4.6 en matière de raisonnement agentique, d’utilisation des outils, de développement et de travail intellectuel — tout en affichant un taux global de comportements indésirables plus faible et des capacités en cybersécurité nettement inférieures à celles des modèles Opus (le compromis de sécurité qui a permis sa sortie sans blocage lié au contrôle des exportations). Identifiant du modèle : claude-sonnet-5 (version figée sans date). Fenêtre de contexte de 1 million de tokens, sortie maximale de 128 000 tokens (jusqu’à 300 000 sur Batches API avec l’en-tête bêta output-300k-2026-03-24), réflexion adaptative uniquement. Date limite des connaissances fiables : janvier 2026. Tarifs : 2 $/10 $ par MTok en entrée/sortie, désormais au tarif catalogue standard. Anthropic avait annoncé au lancement un tarif de lancement de 2 $/10 $ valable jusqu’au 31 août 2026, puis l’a maintenu : la page des tarifs indique que la hausse à 3 $/15 $ prévue le 1er septembre « n’aura pas lieu », et la v2.1.243 a mis à jour le sélecteur /model et le skill claude-api intégré pour afficher 2 $/10 $ comme tarif catalogue plutôt que comme promotion à durée limitée.²⁵¹ C’est 50 % de moins que les 4 $/20 $ d’Opus 5.5 (et 60 % de moins que les 5 $/25 $ facturés pour Opus 5). Dans Claude Code, le paramètre effort est défini par défaut sur high pour Sonnet 5 (définissez-le explicitement pour le modifier). Sélectionnez ce modèle avec /model claude-sonnet-5.¹⁸⁰²³⁰

La v2.1.197 (30 juin 2026) a fait de Sonnet 5 le modèle par défaut dans Claude Code pour les nouvelles sessions à cette date, et il est resté le modèle des forfaits standard (Pro, Team Standard) jusqu’à ce que la v2.1.280 fasse passer ces forfaits à Opus le 22 septembre 2026. Sonnet 5 n’est plus le modèle par défaut d’aucun forfait dans Claude Code, et depuis la v2.1.284, /model sonnet sélectionne Sonnet 5.5 sur Anthropic API ; /model claude-sonnet-5 ou ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 vous permet de rester sur Sonnet 5. Consultez le tableau des forfaits ci-dessus.^{181207220221228}

Sonnet 4.6 (17 février 2026, désormais remplacé par Sonnet 5) : Modèle équilibré ; il a remplacé Sonnet 4.5 comme modèle par défaut sur claude.ai et Claude Cowork.⁹³ Tarifs identiques à ceux de Sonnet 4.5 (3 $/15 $ par MTok). Performances améliorées en recherche agentique, avec une consommation de tokens réduite. Prend en charge la réflexion étendue, la réflexion adaptative et une fenêtre de contexte de 1 million de tokens (bêta). Sortie maximale de 64 000 tokens (plafond de 128 000 dans la v2.1.77).¹¹⁹ Date limite des connaissances : août 2025 (connaissances fiables), janvier 2026 (données d’entraînement). Identifiant du modèle : claude-sonnet-4-6. Claude Mythos Preview (7 avril 2026) : Un modèle de pointe proposé en préversion de recherche pour les travaux de cybersécurité défensive, dans le cadre de Project Glasswing.¹³⁹ Accessible uniquement sur invitation ; il n’est pas disponible pour le grand public. Anthropic présente Opus 4.7 comme délibérément moins performant que Mythos en cybersécurité — un compromis en faveur de la sécurité — et a ouvert un Cyber Verification Program à l’adresse https://claude.com/form/cyber-use-case pour les chercheurs en sécurité légitimes qui ont besoin d’un accès étendu.¹⁴⁶

Pourquoi ces écarts de prix comptent : Une session de développement typique consomme entre 50 000 et 200 000 tokens en entrée et entre 10 000 et 50 000 tokens en sortie. Avec Haiku 5.5, aux tarifs des prompts jusqu’à 100 000 tokens, cela représente environ 0,01 à 0,05 $ par session. Avec Opus 5.5 à 4 $/20 $, la même session coûte entre 0,40 et 1,80 $, soit environ 40 fois plus (avant les remises liées à la mise en cache des prompts). Utilisez Sonnet ou Haiku lorsqu’une tâche ne nécessite pas Opus.¹²²²

Quand utiliser chaque modèle

Haiku : Utilisez-le pour les subagents chargés d’explorer, pour les recherches simples de fichiers et pour les questions rapides. Aux tarifs des prompts jusqu’à 100 000 tokens, il coûte environ 40 fois moins cher qu’Opus 5.5 (8 fois moins pour un prompt dépassant 100 000 tokens) et répond plus vite. Idéal pour les tâches en arrière-plan qui ne nécessitent pas de raisonnement approfondi.

Sonnet : Le modèle polyvalent pour le développement quotidien lorsque le coût compte – Sonnet 5.5 sur API de Anthropic depuis la v2.1.284, aux mêmes tarifs de 2 $/10 $ que Sonnet 5²²⁸ – et, depuis que la v2.1.280 a fait passer Pro et Team Standard à Opus, il n’est plus le modèle par défaut d’aucune offre (contexte natif de 1 million de tokens, tarif catalogue standard de 2 $/10 $ par million de tokens ; l’augmentation prévue le 1er septembre a été annulée).^181251207220 Voici le changement à retenir : Sonnet est désormais un modèle que vous choisissez, et ce choix se justifie par le calcul – un coût par token deux fois inférieur à celui d’Opus 5.5, avec le même contexte de 1 million de tokens. Il prend en charge la plupart des tâches de développement : implémentation de fonctionnalités, correction de bugs, rédaction de tests et revue de code. Historique : la v2.1.197 (30 juin 2026) a longtemps été présentée – y compris ici – comme ayant fait de Sonnet 5 le modèle par défaut partout. Pourtant, d’après la documentation de configuration des modèles par offre, le modèle par défaut pour les offres premium et API correspondait à Opus 4.8 dès la v2.1.154, puis à Opus 5 dès la v2.1.219. « Partout » désignait donc en réalité les offres standard – et la v2.1.280 a mis fin à cela aussi. Sonnet 4.6 occupait la place de Sonnet jusqu’en juin 2026.^93147207221 Utilisez Sonnet pour réduire le coût des tokens, obtenir des réponses plus rapides ou maîtriser le coût des subagents.

Opus : Le modèle dédié au raisonnement approfondi — depuis la v2.1.280, l’alias opus sélectionne Claude Opus 5.5 (4 $/20 $ par million de tokens, contexte de 1 million de tokens, effort réglé sur medium par défaut), et depuis cette version, toutes les offres démarrent également avec Opus. Le choix consiste donc à décider quand le quitter : conservez Opus pour les décisions d’architecture, le débogage délicat, la compréhension de systèmes complexes, l’analyse de sécurité et les tâches agentiques de longue haleine. Passez à /model sonnet lorsqu’une tâche est suffisamment courante pour qu’un coût par token divisé par deux compte davantage que le raisonnement supplémentaire.²²⁰²²¹ (L’alias opus correspondait à Opus 5, à 5 $/25 $, de la v2.1.219 à la v2.1.278.)¹⁹⁷ La suite de ce paragraphe décrit Opus 4.7 lors de son lancement le 16 avril 2026 et est conservée à titre historique.¹⁴⁴¹⁴⁷ Opus 4.7 résout 3 fois plus de tâches de production sur SWE-Bench qu’Opus 4.6, atteint 70 % sur CursorBench (contre 58 %) et améliore de 13 % le taux de résolution sur un banc d’essai interne de 93 tâches de développement.¹⁴⁴ Claude Code utilise par défaut le niveau d’effort xhigh avec Opus 4.7, réglable via /effort (v2.1.111+).¹⁴⁶¹⁴⁷ Le mode automatique est disponible pour les abonnés Max sur Opus 4.7 via API de Anthropic, sans nécessiter --enable-auto-mode ; pour les autres offres et fournisseurs, sa disponibilité dépend de l’offre et des paramètres définis par l’administrateur.¹⁴⁶ Contexte de 1 million de tokens au tarif standard — aucun supplément pour les contextes longs. Changements de comportement à connaître : Opus 4.7 suit les instructions plus littéralement, adapte la longueur de ses réponses à la complexité de la tâche, exécute moins de subagents par défaut et adopte un ton plus direct, moins porté sur les formulations approbatrices. Si vos prompts contiennent des consignes supplémentaires pour imposer des messages de progression intermédiaires ou des vérifications systématiques, essayez de les supprimer.¹⁴⁵

Opusplan : Un mode hybride qui utilise Opus pour la planification (où la qualité du raisonnement compte le plus) et Sonnet pour l’exécution (où la rapidité compte). Excellent pour les refactorisations complexes lorsque vous souhaitez le meilleur plan sans avoir besoin d’un raisonnement de niveau Opus pour chaque modification.

Changer de modèle

Pendant une session :

> /model opus
> /model sonnet
> /model haiku

Au démarrage :

claude --model opus

Via l’environnement :

export ANTHROPIC_MODEL=opus

Dans settings.json :

{
  "model": "claude-sonnet-5"
}

Personnaliser le sélecteur lui-même (modelPicker, v2.1.242+) : un fichier de paramètres utilisateur ou administrés peut définir les modèles proposés par /model, dans l’ordre et avec les libellés de votre choix, au lieu de vous limiter à la liste intégrée. Chaque entrée indique un model (toute forme acceptée par --model, y compris les identifiants Vertex et Bedrock), avec un label et une description facultatifs ; définissez replaceBuiltInOptions sur true pour n’afficher que ces entrées, ainsi que Par défaut et le modèle actuel de la session. Les paramètres du projet et les paramètres locaux sont ignorés pour cette clé, et une liste d’autorisation availableModels continue de filtrer les entrées. Claude Code supprime les entrées correspondant à des modèles qu’il ne peut pas utiliser, grise celles que vous ne pouvez pas encore sélectionner en indiquant la raison, et revient à la liste intégrée si aucune entrée n’est conservée.²⁵⁰²⁴⁸

{
  "modelPicker": {
    "options": [
      { "model": "us.anthropic.claude-opus-4-8", "label": "Opus (production)" },
      {
        "model": "us.anthropic.claude-sonnet-4-6",
        "label": "Sonnet (production)",
        "description": "Day-to-day work"
      }
    ]
  }
}

Pour les subagents en particulier :

export CLAUDE_CODE_SUBAGENT_MODEL=haiku

Depuis la v2.1.251, CLAUDE_CODE_SUBAGENT_MODEL définit le modèle par défaut des subagents au lieu de remplacer tous les autres choix : le champ model: d’une définition d’agent et le modèle explicitement choisi lors de la création d’un subagent sont prioritaires.²⁰⁶ Depuis la v2.1.257, CLAUDE_CODE_SUBAGENT_MODEL_FORCE permet de rétablir l’ancien comportement sur activation explicite : cette variable applique CLAUDE_CODE_SUBAGENT_MODEL (ou le modèle de la conversation principale si cette dernière n’est pas définie) à tous les subagents, en ignorant les choix faits lors de leur création et le champ model: des définitions d’agents.²¹¹

Chaîne de modèles de secours (v2.1.166+) : le paramètre fallbackModel permet de configurer jusqu’à trois modèles de secours, essayés dans l’ordre lorsque le modèle principal est surchargé ou indisponible. L’option --fallback-model (auparavant réservée à un changement en cours de session) s’applique désormais aussi aux sessions interactives dès leur démarrage.²⁶³

{
  "model": "claude-opus-4-8",
  "fallbackModel": ["claude-sonnet-4-6", "claude-haiku-4-5"]
}

Lorsque API renvoie une erreur inattendue qui ne permet pas de réessayer, Claude Code tente désormais aussi de traiter le tour une fois avec le modèle de secours avant de signaler l’échec. Ainsi, un problème passager du modèle principal peut être contourné sans perdre le tour.²⁶³ Depuis la v2.1.286, lorsque API de Anthropic refuse le modèle auquel correspond votre choix par défaut ou un alias, Claude Code réessaie une fois avec le modèle précédent de la même gamme au lieu d’échouer à chaque tour. Les nouvelles tentatives déclenchées par un refus ou par --fallback-model s’exécutent à vitesse standard si le modèle de secours ne prend pas en charge le mode rapide.²³¹

Depuis la v2.1.178, la compaction respecte elle aussi la chaîne de secours — si le modèle principal est surchargé ou indisponible pendant la compaction, cette étape utilise la chaîne configurée avec fallbackModel/--fallback-model au lieu de faire échouer le tour. Lors d’une longue exécution autonome, cela évite qu’une erreur passagère du modèle interrompe la session alors que la compaction aurait pu aboutir avec un autre modèle.¹⁷³

Contexte étendu

Pour les bases de code volumineuses ou les longues sessions, activez le contexte de 1 million de tokens :

claude --model sonnet[1m]
claude --model opus[1m]           # 1M for a model that reaches it only through [1m], such as Opus 4.6

Ou au sein d’une session :

> /model sonnet[1m]
> /model opus[1m]

Quand le suffixe a un effet (octobre 2026) : sur API de Anthropic, Fable 5.1, Fable 5, Sonnet 5.5, Sonnet 5 et Opus 4.7 et versions ultérieures (Opus 5.5 compris) utilisent la fenêtre de 1 million de tokens pour toutes les offres ; [1m] n’y change donc rien. Depuis la v2.1.287, il en va de même sur Amazon Bedrock, Agent Platform de Google Cloud, Microsoft Foundry et la passerelle d’applications Claude : Opus 4.7 et versions ultérieures ainsi que Fable utilisent par défaut la fenêtre de 1 million de tokens sans suffixe [1m], tandis que CLAUDE_CODE_DISABLE_1M_CONTEXT=1 les limite à 200 000 tokens. Avant la v2.1.287, Opus 4.8 et versions ultérieures utilisaient 200 000 tokens chez ces fournisseurs, sauf si l’identifiant de modèle fixé dans ANTHROPIC_DEFAULT_OPUS_MODEL comportait [1m] ; les pages de documentation de Bedrock et d’Agent Platform, consultées le 1er octobre, présentent encore le suffixe comme le moyen d’y obtenir 1 million de tokens. Sonnet 5 dispose de 1 million de tokens chez tous les fournisseurs. Le suffixe reste nécessaire pour Opus 4.6 et Sonnet 4.6, qui n’atteignent 1 million de tokens qu’avec leur variante [1m].^223232233

Opus 4.7, Opus 4.6 et Sonnet 4.6 incluent tous la fenêtre de contexte complète de 1 million de tokens au tarif standard — sans supplément pour les contextes longs.¹⁴⁸ Une requête de 900 000 tokens est facturée au même tarif par token qu’une requête de 9 000 tokens. Les remises liées à la mise en cache des prompts et au traitement par lots s’appliquent aux taux standard sur l’ensemble de la fenêtre de contexte. L’accès aux variantes [1m] dépend de l’abonnement : Opus 4.6 avec un contexte de 1M est inclus dans les offres Max, Team et Enterprise, tandis que Sonnet 4.6 avec un contexte de 1M nécessite des crédits d’utilisation avec tous les abonnements, y compris Max.²³³ (Opus avec un contexte de 1M est devenu le modèle par défaut sur Max, Team et Enterprise dans la v2.1.75, le 13 mars 2026.)¹¹⁷¹⁴⁷ Les utilisateurs de API et ceux facturés à l’usage ont pleinement accès au contexte de 1M aux tarifs standard par token.¹⁴⁷

Pour désactiver les variantes à contexte de 1M dans le sélecteur de modèles, définissez CLAUDE_CODE_DISABLE_1M_CONTEXT=1. Depuis la v2.1.223, la portée de cette variable a changé : elle limite à 200K tout modèle doté d’une fenêtre native de 1M grâce à la compaction automatique — et ne s’applique plus seulement à une liste fixe de variantes connues — et un avertissement s’affiche au démarrage lorsque la compaction automatique ne maintient pas effectivement la session dans la limite de 200K. Si vous l’utilisez pour rendre les coûts prévisibles sur une famille de modèles, elle s’applique désormais aux nouveaux modèles de 1M dès leur sortie, au lieu de cesser silencieusement de les couvrir. Cette même version maintient aussi, grâce à la compaction automatique, les sessions utilisant des identifiants de modèles non reconnus dans la fenêtre de contexte présumée, au lieu de les laisser la dépasser ; CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT=1 rétablit l’ancien comportement pour les passerelles qui déclarent des identifiants personnalisés avec des fenêtres réelles plus grandes.²⁰⁰ Depuis la v2.1.287, cette variable permet également de maintenir Opus 4.7 et versions ultérieures ainsi que Fable à 200K sur Bedrock, Vertex, Foundry et la passerelle d’applications Claude, où 1M est devenu la valeur par défaut.²³²

Depuis la v2.1.247, la fenêtre par défaut utilisée pour la compaction automatique de Sonnet 5 couvre l’intégralité de son contexte de 1M : les sessions utilisant cette fenêtre sont désormais compactées automatiquement à environ 967K tokens, contre environ 934K auparavant.²⁴⁵ La v2.1.260 étend cette compaction automatique à proximité de la limite aux autres modèles de la catégorie 1M : les sessions Opus et Fable sont elles aussi compactées peu avant la limite de 1M tokens, et la compaction de récupération sur les très grands contextes n’expire plus au bout de 10 minutes.²¹²

Les URL de base personnalisées bénéficient de la fenêtre de 1M (v2.1.285). Les sessions passant par une ANTHROPIC_BASE_URL personnalisée utilisent désormais la fenêtre de contexte de 1M des modèles qui en disposent (Opus 4.7 et versions ultérieures, Sonnet 5 et versions ultérieures, Fable). Si votre passerelle est limitée à 200K, exécutez /autocompact 200k.²²⁹²³³

Depuis la v2.1.271, --resume conserve la fenêtre [1m] : reprendre une session dont la famille de modèles diffère du modèle configuré par défaut ne supprime plus le suffixe [1m].²¹⁶

La v2.1.273 corrige le compteur de contexte et le calcul de la compaction automatique, qui comptabilisaient les tours utilisant l’outil conseiller à environ deux fois leur taille réelle dans le contexte – la compaction automatique se déclenchait à environ la moitié de la fenêtre réelle.²¹⁷

Vérifier le modèle actuel

> /status

La commande affiche le modèle actuel, les informations du compte, les paramètres appliqués et d’autres informations sur l’état de la session.

Libellés du sélecteur de modèles (v2.1.51+) : le sélecteur /model affiche désormais des libellés lisibles (par exemple, « Sonnet 4.6 ») au lieu des identifiants bruts pour les versions épinglées, avec des indications de mise à niveau lorsque des versions plus récentes sont disponibles.⁹⁸ La v2.1.219 corrige la ligne regroupant les variantes d’Opus, qui affichait simplement « Opus » au lieu de « Opus (contexte de 1M) », et limite la mise en évidence des nouveautés au seul nom du modèle le plus récent, afin de signaler ce qui vient réellement de sortir plutôt qu’une portion arbitraire de la liste.¹⁹⁶ La v2.1.283 supprime « (contexte de 1M) » de la ligne Opus et du nom du modèle par défaut lorsque Opus dispose déjà d’une fenêtre de contexte de 1M ; la fenêtre elle-même reste inchangée.²²⁶

Mode rapide (v2.1.36+)

Le mode rapide accélère nettement la génération du même modèle ; il ne bascule pas vers un modèle moins cher. Activez-le ou désactivez-le pendant une session avec /fast.⁸⁶

> /fast            # Toggle fast mode on/off

Modèles concernés (depuis la v2.1.280) : le mode rapide s’applique à Claude Opus 5.5, Opus 5 et Opus 4.8, et Opus 5.5 est le modèle par défaut du mode rapide depuis la v2.1.280 (Opus 5 l’était depuis la v2.1.219). La v2.1.219 a retiré Opus 4.7 du mode rapide, et cette fonctionnalité n’a jamais été disponible sur Sonnet, Haiku ou Fable. Elle reste proposée en préversion de recherche, uniquement sur Claude API (y compris Claude Managed Agents) — pas sur Amazon Bedrock, Google Cloud, Microsoft Foundry ni Claude Platform on AWS. L’accès est restreint : contactez votre responsable de compte ou inscrivez-vous sur la liste d’attente.^196198223

Sessions distantes (v2.1.271) : le mode rapide est désormais disponible dans les sessions Claude Code Remote – sessions cloud et runners autohébergés. Le paramètre de mode rapide de l’hôte s’applique, ou vous pouvez saisir /fast directement dans la session ; ces deux méthodes ne fonctionnent que si votre organisation autorise le mode rapide. Cette même version corrige /fast off : la commande désactive désormais le mode rapide au lieu de répondre « Mode rapide indisponible » lorsque l’organisation l’a désactivé.²¹⁶

Tarifs (mode rapide) :^198222223

Le piège d’Opus 4.7 (v2.1.219). Les modèles non pris en charge ne se comportent pas tous de la même façon. Une requête à claude-opus-4-7 avec speed: "fast" renvoie désormais une erreur — elle ne revient pas silencieusement à la vitesse standard. Opus 4.6 fait exception, d’où l’intérêt de connaître cette distinction : il accepte speed: "fast", s’exécute malgré tout à la vitesse standard, facture aux tarifs standard et indique usage.speed: "standard". Si votre environnement d’orchestration était épinglé sur la version 4.7 et comptait sur le retour silencieux des requêtes en mode rapide à la vitesse standard, ces requêtes échouent désormais purement et simplement ; épinglez plutôt Opus 5.5, Opus 5 ou Opus 4.8.¹⁹⁸

Quand utiliser le mode rapide : - Pour enchaîner rapidement de petites modifications lorsque la latence est le facteur limitant - Pour générer des tests, du code standard ou répétitif lorsque la vitesse compte davantage que le coût - Pour traiter successivement une liste de tâches similaires

Quand NE PAS utiliser le mode rapide : - Pour les tâches agentiques de longue durée (le coût reste doublé sur l’ensemble de l’exécution) - Pour le travail des subagents en arrière-plan (personne n’attend le résultat) - Pour les sessions où le budget est une priorité

Le mode rapide inclut l’intégralité de la fenêtre de contexte de 1M (v2.1.50+). Le même multiplicateur tarifaire s’applique à l’ensemble du contexte, y compris aux requêtes dépassant 200K tokens d’entrée — sans supplément pour les longs contextes — et se cumule avec les multiplicateurs liés à la mise en cache des prompts et à la résidence des données.⁹⁶¹⁹⁸

Notes pratiques. Le mode rapide dispose de sa propre limite de débit, distincte des limites standard d’Opus ; tout dépassement renvoie un 429 avec retry-after (les en-têtes de réponse anthropic-fast-*-tokens-* indiquent la capacité restante). Passer du mode rapide au mode standard, ou inversement, invalide le cache des prompts — les requêtes effectuées à des vitesses différentes ne partagent pas leurs préfixes en cache ; basculer avec /fast en cours de session vous fait donc perdre le bénéfice du cache. Le mode rapide n’est pas disponible avec Batch API ni avec un engagement Priority Tier.¹⁹⁸

Conseil d’expert : le mode rapide se combine mal avec opusplan (opusplan associe déjà Opus et Sonnet ; le mode rapide n’agit que sur la partie exécutée par Opus). Utilisez-le lorsque la latence compte davantage que le coût, et désactivez-le pour les tâches autonomes ou par lots. /fast nécessite une utilisation supplémentaire ; les administrateurs Team/Enterprise peuvent devoir l’activer au préalable (correctif de la v2.1.37). Désactivez-le complètement avec CLAUDE_CODE_DISABLE_FAST_MODE=1. Depuis la v2.1.218, Claude Code vous avertit lorsqu’un changement de modèle via /config model=<x> ou Remote Control modifie l’état du mode rapide, et la v2.1.219 a corrigé les clients Remote Control qui conservaient un état obsolète du mode rapide après un changement, une reconnexion ou un échec de vérification de l’organisation.^86149195196

L’outil conseiller (expérimental)

L’outil conseiller permet à Claude de consulter un second modèle, généralement plus puissant, à des moments clés d’une tâche : avant de s’engager dans une approche, lorsqu’une erreur se répète ou avant de déclarer le travail terminé. Le conseiller s’exécute côté serveur sur l’infrastructure de Anthropic, en tant qu’outil serveur ; il reçoit l’intégralité de la conversation, y compris chaque appel d’outil et son résultat, puis renvoie des recommandations que Claude applique avant de poursuivre. Claude décide quand l’appeler ; vous pouvez demander une consultation dans un prompt, mais aucun paramètre ne permet de limiter ou d’imposer les appels. Expérimental, il est disponible sur Anthropic API pour les comptes avec abonnement et ceux facturés via API, et il est arrivé sur Claude Platform on AWS dans la v2.1.300 (la page de documentation indique encore que cette plateforme n’est pas prise en charge). Avec une passerelle, son fonctionnement dépend de la transmission intacte de la requête à Anthropic API, et il nécessite la récupération des indicateurs de fonctionnalités ; une variable telle que DISABLE_TELEMETRY le maintient donc désactivé.²⁷³²⁷⁴ Activation. Trois possibilités : /advisor <model> en cours de session, qui enregistre le choix dans advisorModel dans vos paramètres utilisateur (la commande /advisor seule ouvre un sélecteur dans le terminal et affiche le conseiller actuel dans les sessions -p, SDK, de l’application de bureau et de Remote Control, où la forme textuelle fonctionne depuis la v2.1.260 ; /advisor off le désactive) ; "advisorModel": "opus" dans un fichier de paramètres ; ou claude --advisor <model> pour une seule session, une option absente de --help qui prime sur le paramètre et provoque l’arrêt au lancement si l’association est invalide. Les alias sont fable, opus et sonnet ; vous pouvez aussi utiliser un identifiant de modèle complet. CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1 supprime la commande, ignore le paramètre et rend l’option sans effet.²⁷⁴

Associations, coût et affichage. Un conseiller doit être de rang égal ou supérieur au modèle principal : Opus 4.7 et 4.8 acceptent Fable, Opus 4.7 ou ultérieur, et Sonnet 5.5 (depuis la v2.1.287) ; Sonnet 5.5 accepte Fable, Opus 5 ou ultérieur, et Sonnet 5.5 ; Opus 5 et 5.5 acceptent Fable et Opus 5 ou ultérieur ; Fable 5.1 accepte uniquement Fable 5.1 ; Haiku 4.5 peut faire appel au conseiller, mais ne peut pas remplir ce rôle. Un conseiller de rang inférieur au modèle principal n’est pas associé à la session, et une notification vous en informe ; un conseiller refusé par API est désactivé sans notification pour le reste de la conversation. Les subagents héritent du conseiller, sous réserve de la même vérification de compatibilité, et toute liste d’autorisation availableModels est respectée. Chaque appel est facturé aux tarifs d’entrée et de sortie du modèle conseiller, ou décompté des limites de votre forfait, sauf pour un conseiller Fable : sur les forfaits où Fable est facturé en crédits d’utilisation, il consomme ces crédits après le consentement unique donné via /model fable. L’activation ou la désactivation du conseiller préserve le cache de prompt du modèle principal ; la lecture de la conversation par le conseiller n’est jamais mise en cache. Dans la transcription, une ligne Advising indique Reviewed, Declined ou Unavailable, et Ctrl+O affiche les recommandations. Les mods voient les appels au conseiller sous la forme de serverToolUses sur turn.step (v2.1.290).²⁷⁴

Réglage de l’effort (v2.1.111+, Opus 4.7)

Opus 4.7 introduit un nouveau réglage de l’effort qui ajuste le compromis entre rapidité et intelligence. Utilisez /effort pendant une session :

> /effort              # opens an interactive slider (arrow keys + Enter)
> /effort xhigh        # set directly

Mémorisation par modèle (v2.1.251+) : /effort enregistre désormais votre niveau d’effort par défaut pour chaque modèle, de sorte que chacun conserve son propre réglage lorsque vous en changez — votre habitude d’utiliser xhigh sur Opus ne se répercute plus sur Haiku (CHANGELOG : « Modification de /effort pour enregistrer votre niveau d’effort par défaut par modèle, afin que chacun conserve son propre réglage lorsque vous en changez »). L’exception de max, limité à la session, reste en vigueur.²⁰⁶ Touches du curseur en v2.1.284 : les actions de raccourcis clavier effortSlider:decreaseEffort, increaseEffort et toggleUltracode vous permettent de réaffecter les touches fléchées et Tab du curseur dans keybindings.json.²²⁸ La v2.1.257 affine les deux réglages : /effort accepte s pour un choix limité à la session, suivant la convention de /model, et l’option --effort est désormais limitée à la session — elle lève le maintien du niveau d’effort par défaut d’un nouveau modèle pour cette seule session, et non définitivement (la référence CLI indique qu’elle « remplace » le niveau par défaut « pour cette session, sans persistance »).²¹¹²⁴³

Mode automatique sur Max (v2.1.111+)

Le mode automatique est le mode d’autorisation initial intégré pour les sessions interactives dans le terminal et VS Code, sur tous les forfaits et chez tous les fournisseurs (v2.1.283-284). Il l’a également été, de la v2.1.285 jusqu’au retour en arrière de la v2.1.302, pour les sessions claude -p et Python Agent SDK chez les fournisseurs tiers ou lorsque la télémétrie était désactivée ; il était déjà le mode par défaut sur Pro, Max et Team depuis le 14 août 2026 (annonce du 7 août). Consultez les Modes d’autorisation pour les chiffres de l’étude citée dans l’annonce, les moyens de désactiver ce comportement et les sessions qui démarrent encore en mode manuel.^{203226227228229}

Un modèle de classification distinct, Claude Sonnet 5 depuis la v2.1.210, examine chaque action avant son exécution pour vérifier qu’elle correspond à votre intention et qu’elle est sûre.¹⁸⁷ Démarrez une session en mode automatique avec --permission-mode auto ; la v2.1.111 a supprimé l’ancienne option --enable-auto-mode.

Évolution de la disponibilité :

• Désactivation : CLAUDE_CODE_AUTO_MODE_SERVER=0 conserve le classificateur local, dont les requêtes sont décomptées de votre utilisation, tandis que 1 active les vérifications côté serveur. Avant la v2.1.281, la variable n’était pas lue lors d’une connexion directe Anthropic API ; la v2.1.281 l’applique aussi dans ce cas, et la documentation sur la facturation du mode automatique précise désormais qu’une connexion directe nécessite la v2.1.281 ou une version ultérieure.²²⁴²²⁷ La documentation présente cette variable comme temporaire. Définir CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 alors que cette variable n’est pas définie désactive également les vérifications côté serveur.
• Lorsque les vérifications du serveur ne peuvent pas atteindre une session : la cause la plus fréquente est une passerelle ou un proxy qui supprime le champ safeguards des requêtes, retire safeguard_results des réponses ou réécrit les identifiants d’utilisation des outils. Claude Code affiche un avertissement unique (« cette session n’est pas éligible »), nomme la passerelle lorsqu’il peut l’identifier et utilise ses propres requêtes de classification facturées pour le reste de la session. En mode -p, l’avertissement est envoyé sur stderr, et la sortie stream-json émet un avertissement system. Les sessions Pro, Max et Team ne le voient jamais. Pour corriger le problème sur une passerelle, il faut transmettre les champs des requêtes et les clés des réponses sans les modifier.
• Vérification d’une session : /status affiche une ligne Serveur du mode automatique indiquant Enabled lorsque les vérifications du serveur déterminent les actions de la session, et Disabled après le basculement vers le classificateur local.²¹⁹

Ce que le mode automatique n’est pas : une frontière de sécurité. La plupart des mesures qui suivent renforcent un classificateur, et un classificateur n’est pas un environnement isolé. Le 26 août 2026, Johann Rehberger, chercheur spécialisé dans l’injection de prompt, a publié une chaîne d’attaque fonctionnelle contre Claude Code Opus 5 en mode automatique. Il rapporte un taux de réussite de 60 à 80 % sur de petits échantillons : 3 exécutions sur 5 pour la chaîne principale, qui lance un processus enfant python3 isolé, et respectivement 3 et 4 exécutions sur 5 pour deux configurations d’une variante dont la charge utile lance une instance claude -p sans interface. Il précise lui-même qu’il s’agit de petits échantillons, et non d’une mesure universelle du taux de réussite des attaques.²¹⁰ Cette chaîne mérite d’être comprise, car chaque étape, prise séparément, paraît raisonnable : un serveur répond à WebFetch avec le code HTTP 415, si bien que l’agent se rabat sur curl ; l’archive téléchargée est décompressée dans un répertoire temporaire contenant un manifeste, sept enregistrements de données encodés en Base85/zlib, un binaire natif et un fichier struct.py ; Claude refuse d’exécuter le binaire non fiable, puis écrit son propre décodeur Python et l’exécute depuis ce répertoire ; le décodeur importe base64, base64 importe struct, et Python trouve d’abord le fichier struct.py de l’attaquant. Aucune instruction de cette séquence n’est manifestement malveillante : il suffit que l’injection fasse du chemin compromis la façon la plus raisonnable de terminer la tâche. Rehberger rapporte aussi que, lors de quelques exécutions, Claude a tenté d’arrêter le processus malveillant après avoir détecté la compromission, et que le mode automatique a refusé la commande de nettoyage.²¹⁰ Il met l’ensemble de ses résultats en regard d’un chiffre mis en avant par Anthropic : une évaluation commandée à un tiers faisait état d’un taux de réussite de 0,00 % pour les attaques par injection de prompt contre Opus 5 en mode automatique, sur 72 scénarios exécutés dix fois chacun. Sa chaîne ne figurait pas dans cet ensemble, ce qui explique qu’un résultat de 0,00 % au banc d’essai et une chaîne fonctionnelle d’exécution de code puissent être vrais simultanément ; à ses yeux, les deux messages restent difficiles à concilier.²¹⁰ La qualification de l’attaque compte également : dans sa mise à jour du 30 août, Simon Willison approuve la remarque d’un lecteur selon laquelle il ne s’agit pas d’une injection de prompt classique — le modèle ne lit ni ne suit jamais d’instructions de l’attaquant — mais d’une attaque par confusion de l’environnement.²¹⁰

Anthropic a clos le signalement avec le statut Informatif — le comportement étant conforme à la conception — et la position rapportée par Rehberger doit guider la conception de vos protections : le mode automatique est un classificateur qui fait de son mieux, pas une garantie de sécurité ; les chaînes d’injection élaborées avec persévérance à partir d’étapes individuellement bénignes dépassent ce qu’un classificateur est censé détecter ; et la véritable frontière de confinement repose sur l’isolation au niveau du système d’exploitation et le contrôle du trafic réseau sortant.²¹⁰ Cela ne contredit pas les mesures de renforcement ci-dessous : c’est le cadre dans lequel il faut les comprendre. Le mode automatique réduit le nombre de demandes auxquelles vous devez répondre et bloque une liste documentée d’opérations destructrices ; il ne sécurise pas une session qui traite des entrées non fiables. Si une session doit manipuler du contenu sur lequel un attaquant peut avoir une influence — pages récupérées, archives téléchargées, texte de tickets, serveurs MCP tiers — les protections qui limitent réellement les dégâts se trouvent en dehors du modèle : un conteneur ou une machine virtuelle, un trafic réseau sortant restreint, une surveillance des actions réelles de l’agent et un répertoire personnel ne contenant pas les clés SSH ni les identifiants cloud que vous ne voudriez pas perdre. Une autorisation accordée par le mode automatique ne prouve pas qu’une action était sûre.

Des règles personnalisées sans perdre les règles par défaut (v2.1.118+). Dans les versions précédentes, autoMode.allow, autoMode.soft_deny et autoMode.environment imposaient un choix exclusif : définir votre propre liste faisait disparaître les règles de sécurité intégrées. La sentinelle $defaults résout ce problème : elle est remplacée par la liste intégrée exactement à l’endroit où vous la placez, ce qui vous permet d’ajouter des règles personnalisées avant et après celle-ci :¹⁵²

// .claude/settings.json
{
  "autoMode": {
    "allow": [
      "Bash(npm test:*)",        // your additions, prepended
      "$defaults",                // built-in allow list inserted here
      "Bash(git push:origin/feature/*)"  // appended after
    ]
  }
}

Modifier les règles du classificateur depuis /permissions (v2.1.246). Exécutez /permissions et ouvrez l’onglet Mode automatique, qui n’apparaît que lorsque ce mode est disponible pour la session. Il répertorie les entrées allow, soft_deny, hard_deny et environment de chaque niveau de configuration lu par le classificateur et indique si les règles intégrées sont actives pour chaque section ; les entrées provenant des paramètres gérés ou de --settings sont en lecture seule, et chaque modification est enregistrée dans ~/.claude/settings.json. L’ajout de la première règle à une section insère également "$defaults" pour que les règles intégrées restent actives. Vous pouvez activer ou désactiver ces dernières par section, à condition que la section contienne au moins une de vos propres règles avant de pouvoir les désactiver. Quant à environment, il s’ouvre sous la forme d’un document unique dans votre éditeur.²⁴⁹²⁴⁷

Option « Ne plus demander » à l’activation (v2.1.118+). L’invite d’activation du mode automatique propose désormais une option « Ne plus demander », qui permet aux utilisateurs réguliers de masquer l’explication sans devoir automatiser l’ajout d’un indicateur.¹⁵²

Protections contre les commandes destructrices (v2.1.183). Le mode automatique bloque désormais strictement un ensemble de commandes irréversibles, sauf si vous les avez explicitement demandées dans la session : les opérations git destructrices (git reset --hard, git checkout -- ., git clean -fd, git stash drop) lorsque vous n’avez pas demandé d’abandonner le travail local ; git commit --amend lorsque le commit n’a pas été créé par l’agent au cours de cette session ; et la suppression d’infrastructures (terraform destroy, pulumi destroy, cdk destroy), sauf si vous avez nommé précisément la pile concernée. Cela limite les dégâts potentiels liés aux décisions du classificateur, précisément pour les opérations qui font perdre du travail en silence ou démantèlent des environnements : l’agent peut toujours les exécuter, mais uniquement sur votre instruction explicite, jamais de sa propre initiative.¹⁷⁴

Classifier chaque commande shell (v2.1.193). Par défaut, le classificateur du mode automatique n’examine que les commandes shell correspondant à des motifs d’exécution de code arbitraire ; les commandes courantes échappent à cet examen. Le nouveau paramètre autoMode.classifyAllShell fait au contraire passer toutes les commandes Bash/PowerShell par le classificateur, au prix d’une légère latence supplémentaire, pour renforcer la protection lorsque vous souhaitez que chaque appel au shell soit vérifié. Cette version affiche également les motifs de refus du mode automatique dans la transcription, la notification de refus et les refus récents de /permissions : le blocage d’une commande s’accompagne désormais d’une explication.¹⁷⁹

Trois règles de renforcement supplémentaires (v2.1.205). Le mode automatique bloque désormais l’altération des fichiers de transcription des sessions — la piste d’audit elle-même est hors d’atteinte de l’agent ; il demande une autorisation avant d’exécuter rm -rf sur une variable dont il ne peut pas déterminer la valeur à partir du contexte — ce qui prévient les accidents de type rm -rf $DIR avec un $DIR inconnu ; et les notifications des tâches en arrière-plan indiquent désormais explicitement qu’aucune intervention humaine n’a eu lieu, afin qu’une fausse ligne « l’utilisateur a approuvé » dans une transcription ne puisse pas être transformée en autorisation effective.¹⁸³ La troisième règle illustre un principe de défense contre l’injection de prompt à retenir : l’autorisation doit parvenir par le canal prévu à cet effet, et l’environnement d’exécution de l’agent rend désormais cette exigence explicite. La substitution de commandes ne peut plus masquer une catastrophe (v2.1.208). Les suppressions catastrophiques comme rm -rf ~ déclenchent désormais une demande de confirmation même lorsqu’elles se cachent dans $(...), des accents graves ou une substitution de processus (<(...)) — et cette demande apparaît même avec --dangerously-skip-permissions et en mode auto. Envelopper une commande destructrice dans une substitution ne permet plus de contourner le filet de sécurité.¹⁸⁶

Réinitialiser l’état du mode auto : claude auto-mode reset (v2.1.212). Une nouvelle sous-commande réinitialise l’état du mode auto depuis le terminal ; ajoutez --yes pour passer la demande de confirmation :¹⁸⁹

claude auto-mode reset          # Confirmation prompt
claude auto-mode reset --yes    # Skip confirmation (scripts)

Moins de boîtes de dialogue, un contrôle toujours aussi rigoureux (v2.1.218). Trois vérifications qui interrompaient auparavant le mode auto avec une demande d’autorisation — rm dangereux, & en arrière-plan et chemins Windows suspects — ne le font plus ; le classificateur du mode auto tranche à leur place. Le contrôle de sécurité a donc toujours lieu, sans vous solliciter à chaque détection. Cette version étend également ce comportement au mode plan avec auto : les commandes Bash dont l’analyseur statique ne peut pas prouver qu’elles sont en lecture seule ne déclenchent plus de demande — le classificateur les évalue au lieu de recourir à une boîte de dialogue.¹⁹⁵

Règle contre les sorties du périmètre d’isolation (v2.1.257). La liste des actions que le classificateur n’approuve jamais automatiquement s’enrichit d’une règle « Containment Escape » : la récupération d’identifiants via les métadonnées cloud, le contournement des restrictions de trafic réseau sortant et les accès entre locataires ne sont plus approuvés automatiquement, sauf si l’environnement les indique comme attendus. Interprétez cette évolution dans le cadre de la réserve formulée plus haut : le renforcement du classificateur se poursuit, avec une catégorie de refus documentée supplémentaire, sans modifier la nature du mode auto.²¹¹

Une seule demande pour les lectures en dehors des répertoires de travail (v2.1.257). Le mode auto demande désormais votre accord une fois, avant la première lecture de fichier de la session en dehors des répertoires de travail ; depuis la v2.1.284, cette demande propose aussi Oui, mais redemander la prochaine fois.²²⁸ Le paramètre associé permissions.blockReadsOutsideWorkingDirectories transforme cette demande en refus : ces lectures sont purement et simplement bloquées.²¹¹ La v2.1.273 étend ces deux comportements aux cas que le vérificateur ne peut pas examiner : une commande Bash qu’il ne peut pas analyser entièrement déclenche une demande au lieu d’échapper au contrôle, et, lorsque le blocage est activé, un répertoire de mémoire choisi par les paramètres d’un dépôt n’est plus chargé dans le prompt, consulté, indexé ni utilisé par l’extraction de mémoire.²¹⁷

Les URL de moteurs de rendu de diagrammes sont considérées comme des envois de données (v2.1.261). Un lien qui intègre du contenu dans l’URL d’un moteur public de rendu de diagrammes — comme mermaid.live, où les données sont encodées dans l’URL elle-même — n’est plus approuvé automatiquement, sauf si vous l’avez demandé. Le classificateur traite ce lien comme un envoi de données : celles-ci sont transportées dans l’URL, où les scripts du site de rendu peuvent les lire dès l’ouverture de la page. Les liens de type mermaid.live placent les données dans le fragment de l’URL, que le navigateur transmet au JavaScript de la page au lieu de l’envoyer avec la requête réseau. La réserve formulée plus haut s’applique ici aussi : c’est un canal d’exfiltration supplémentaire qui est fermé dans le cadre du renforcement du classificateur, pas une nouvelle limite.²¹⁴

Les deux modes de défaillance du classificateur disposent de conditions d’arrêt (v2.1.280). Jusqu’à cette version, le mode auto ne savait pas quoi faire lorsqu’un contrôle de sécurité ne renvoyait aucun verdict exploitable. Pour la personne qui supervisait la session, ces deux lacunes avaient le même résultat : un tour qui tournait en boucle, consommant des tokens pour une action qui ne serait jamais approuvée. La v2.1.280 donne à chacun de ces cas une issue définitive.

L’examen côté serveur couvre davantage de commandes (v2.1.281). Lorsque l’examen par le classificateur s’effectue côté serveur, les commandes shell en lecture seule et celles exécutées dans la sandbox attendent désormais elles aussi cet examen et sont bloquées s’il les signale. Le message de refus a également changé, afin que Claude comprenne que le refus porte sur le résultat visé, et pas seulement sur la commande exacte. Lorsqu’une session reprend dans un nouveau processus, le classificateur peut réutiliser son cache de prompt précédent au lieu de le réécrire. Enfin, /insights propose une recommandation sur le mode auto qui estime combien de demandes d’autorisation ce mode aurait pu traiter au cours de vos sessions récentes.²²⁴

Les sessions sans surveillance ne restent plus bloquées sur les demandes liées à rm (v2.1.281). En mode auto et avec --dangerously-skip-permissions, la demande de confirmation pour un rm dangereux attend désormais une réponse pendant 2 minutes, puis refuse la commande en suggérant une réécriture, ce qui permet à une session sans surveillance de continuer ; CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT=1 désactive ce délai. Un rm récursif dont la cible provient uniquement du résultat d’une substitution de commandes, comme rm -rf "$(pwd)", s’exécutait auparavant sans confirmation dans les deux modes ; il déclenche désormais une demande même lorsqu’une règle d’autorisation Bash correspond, sauf si CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT=1 est défini. La vérification des rm dangereux signale également les suppressions ciblant une variable shell suivie d’un nom de répertoire de premier niveau, une variable dérivée du répertoire de travail ou une cible composée uniquement de barres obliques inverses.²²⁴ Depuis la v2.1.299, un script shell -c qui n’exécute pas rm ne déclenche plus de demande, et un rm construit à l’exécution dans un script que Claude Code ne peut pas lire n’en déclenche une que si CLAUDE_CODE_STRICT_INLINE_SHELL_RM_PROMPT=1 est défini.²⁷¹

Les commandes shell intégrées avec ! quittent le classificateur ; les retours des subagents y entrent (v2.1.271). Il s’agit de deux changements de fonctionnement, plutôt que de nouvelles catégories de refus. Les commandes shell intégrées avec ! dans un skill ou une slash command suivent désormais les règles d’autorisation du mode par défaut plutôt que le classificateur : une commande pour laquelle aucune règle ne tranche est exécutée sous forme d’appel d’outil soumis à examen. Par ailleurs, un subagent rend désormais compte à son appelant via un appel de retour dédié, examiné par le classificateur de sécurité, au lieu de voir son dernier message examiné après coup : le contrôle passe d’une vérification après la transmission à une vérification au moment même de celle-ci.²¹⁶

Nouveautés des v2.1.309 et v2.1.310

Claude Code 2.1.309 est sorti le 22 octobre 2026 (npm à 20:34 UTC ; publication GitHub à 22:18 UTC, 79 points) et la 2.1.310 le 23 octobre (npm à 21:20 UTC ; publication GitHub à 23:39 UTC, 26 points), tous deux identiques au CHANGELOG de référence. Sur npm, latest et next sont en 2.1.310, et stable est passé de la 2.1.292 à la 2.1.308, une version dont la note se résume à « Corrections de bugs et améliorations de la fiabilité » ; la 2.1.303 (18 octobre) reprend cette même ligne. Aucune version n’a été omise entre la 2.1.302 et la 2.1.310.²⁷⁸

Corrections de la sandbox et des autorisations (v2.1.309). Sur macOS et Linux, les commandes Bash exécutées dans la sandbox n’exécutent plus les fichiers de démarrage du shell en dehors de celle-ci avant chaque commande ; sur macOS, les motifs glob denyWrite s’appliquent à l’emplacement réel d’un chemin lorsque le dossier du motif est atteint via un lien symbolique ; les commandes exécutées dans la sandbox et les modifications acceptées automatiquement ne peuvent plus modifier le fichier de configuration MCP fourni avec --mcp-config ; sous Linux, les interdictions d’écriture ne sont plus levées lorsqu’une commande en arrière-plan se poursuit après la fin de la session ; enfin, les commandes exclues de la sandbox par les paramètres demandent désormais une autorisation avant d’écrire dans les chemins de sa liste d’écriture lorsque la sandbox est activée mais ne peut pas fonctionner, le repli vers une exécution hors sandbox étant alors refusé. Les vérifications d’autorisation Bash cessent de faire confiance à une variable définie par une commande dont la redirection peut échouer, demandent une autorisation pour un cd encapsulé ou préfixé avant git, et appliquent une règle de refus Edit(path) à une redirection Bash dans un sous-shell ; la protection d’isolation des worktrees refuse davantage de commandes préfixées par des paramètres régionaux et de commandes arithmétiques zsh ; la protection en écriture du stockage des profils s’applique aussi lorsque le répertoire de configuration est un lien symbolique. sed -i déclenche désormais la demande d’autorisation Bash standard et s’exécute tel quel, au lieu de passer par un aperçu simulé de modification de fichier ; comme les autres modifications effectuées via Bash, ses changements ne sont plus annulés par /rewind. Consultez Mode sandbox.²⁷⁸ Confiance, worktrees et skills (v2.1.309). claude ultrareview exige que vous accordiez votre confiance à l’espace de travail : la commande vous le demande dans un terminal et refuse de s’exécuter dans les autres cas ; les scripts doivent passer --trust-workspace, qui ne prend aucune valeur, ou définir CLAUDE_CODE_DISABLE_ULTRAREVIEW_TRUST_CHECK=1. En mode de contournement des permissions dans l’application de bureau et VS Code, la demande de confirmation pour les commandes dangereuses rm et rmdir refuse désormais immédiatement la commande et suggère une reformulation, ce qui permet aux sessions sans surveillance de continuer. La création et la réutilisation de worktrees ne récupèrent plus les objets git à la demande (un clone partiel avec un environnement Bash isolé les récupère au préalable), et les worktrees comme les changements de branche ignorent les références de remplacement git. Lorsqu’un fichier CLAUDE.md imbriqué dépasse la limite de taille, seul son début est désormais chargé, ce qui évite les compactages répétés après la lecture de fichiers placés sous ce fichier. Un skill situé dans un dossier --add-dir dont le nom est déjà utilisé par un autre skill est proposé sous la forme <folder>:<name>, et /verify et /code-review trouvent le skill propre à un paquet imbriqué. Les agents coéquipiers affichés dans des volets séparés héritent des règles d’interdiction d’outils et des règles --tools du chef d’équipe, et /rewind répertorie les tours qui ont modifié des fichiers suivis par les points de contrôle via /code-review --fix, un subagent ou une commande shell.²⁷⁸

v2.1.310. L’outil Monitor et les moniteurs des plugins fonctionnent sur Bedrock, Vertex et Foundry, ainsi que lorsque la télémétrie ou le trafic non essentiel sont désactivés ; les longues mises en veille au premier plan y sont désormais également bloquées. Les requêtes passant par des passerelles et des serveurs compatibles qui rejettent la valeur bêta effort-2025-11-24 ou les messages système en cours de conversation sont réessayées sans ces éléments. Le compactage après une erreur « Prompt is too long » ne conserve plus trop de texte dense, comme du base64 ou du SVG ; le nettoyage en arrière-plan ne supprime plus les fichiers récents, tels que les images collées, lorsque cleanupPeriodDays est très élevé ; les demandes d’autorisation de lecture de fichiers affichent la destination des liens symboliques ; la demande du mode automatique avant la première lecture en dehors des dossiers de travail précise quand le blocage de ces lectures oblige les commandes shell à demander une autorisation ; les sessions non interactives utilisent moins de mémoire lors du compactage d’un historique très volumineux ; sur Ubuntu, /sandbox et l’avertissement au démarrage indiquent la restriction AppArmor sur les espaces de noms utilisateur et comment la lever ; le composant Image d’un mod s’affiche dans tmux lorsque allow-passthrough et focus-events sont activés, ainsi que dans kitty, Ghostty et iTerm2 3.5+ avec le rendu plein écran ; enfin, lorsqu’un appel d’outil MCP expire dans une session non interactive alors qu’une demande de saisie du serveur est restée sans réponse, il indique à Claude de ne pas le répéter. Les permissions des sessions cloud et de Remote Control sont désormais intégrées aux rôles personnalisés Enterprise.²⁷⁸

Nouveautés de la v2.1.307

Claude Code 2.1.307 est sorti le 21 octobre 2026 (npm à 20 h 47 UTC ; version GitHub à 22 h 17 UTC ; 43 points, identiques au CHANGELOG de référence), après la version 2.1.306 (21 octobre à 02 h 28 UTC), qui apporte deux corrections : claude -p dans les sessions cloud ne signale plus « Not logged in » en l’absence des variables d’environnement de la session, et une erreur API n’est plus remplacée par « prompt is too long » suivi d’un compactage inutile dans les sessions comportant de nombreux outils MCP. La version 2.1.308 (22 octobre à 04 h 19 UTC), dont la note de version tient en une ligne et porte sur la fiabilité, est devenue la version stable.²⁷⁸

Télémétrie et skill API. L’événement OpenTelemetry claude_code.safety_event est déclenché pour chaque appel d’outil qu’une règle de permission, le mode automatique, un contrôle de sécurité, un hook ou le bac à sable a bloqué, soumis à confirmation ou renvoyé (voir la Référence des variables d’environnement). /claude-api api-version fait passer le code API de Claude à la version 2026-10-21 de API, et /claude-api managed-agents-secure (v2.1.304) compare les paramètres d’un agent Managed Agents au guide de sécurité publié par Anthropic, sans rien modifier ; le skill crée désormais des équipes de subagents Managed Agents sur multiagent_20261001, avec les workflows dynamiques activés par défaut (v2.1.309).²⁷⁸²⁷⁹

Corrections et comportement. L’utilisation de CLAUDE_CODE_DISABLE_1M_CONTEXT avec un alias portant le suffixe [1m], tel que opus[1m], ne provoque plus d’erreur de modèle introuvable ; l’en-tête bêta prompt-caching-scope n’est plus envoyé derrière les passerelles personnalisées ANTHROPIC_BASE_URL ni sur Foundry ; les serveurs MCP inaccessibles lorsque le trousseau de session macOS était verrouillé en indiquent désormais la raison, et l’exécution suivante après le déverrouillage se connecte sans nouvelle authentification ; les appels d’outils MCP HTTP ne sont plus envoyés deux fois lorsque la connexion se ferme en cours d’appel, car seuls les outils en lecture seule ou idempotents font l’objet d’une nouvelle tentative ; les erreurs « Autocompact is thrashing » lors des tours qui lisent de nombreuses pages PDF ou images sont corrigées ; les appels d’outils impossibles à analyser sont réessayés jusqu’à deux fois avant que le tour ne se termine par une erreur ; les subagents lancés ensemble par bifurcation sont chacun informés du lancement qui leur correspond ; /permissions > Refus récents affiche la commande shell refusée ; le paramètre axScreenReader et CLAUDE_AX_SCREEN_READER dans un bloc env ne s’appliquent que s’ils proviennent des paramètres utilisateur, des paramètres gérés ou de --settings (depuis la version 2.1.305) ; enfin, les hooks de récupération du code des runners autohébergés sont arrêtés après 30 minutes par défaut (--checkout-hook-timeout-min, 0 pour aucune limite). Code Review ajoute @claude review stop (ainsi que off et pause) pour mettre fin à un abonnement @claude review always.²⁷⁸

Nouveautés des v2.1.304 et v2.1.305

Claude Code 2.1.304 est sorti le 19 octobre 2026 (npm à 19 h 47 UTC ; version GitHub à 21 h 34 UTC ; 76 points) et la version 2.1.305 le 20 octobre (npm à 19 h 29 UTC ; version GitHub à 20 h 46 UTC ; 38 points), avec des notes toutes deux identiques au CHANGELOG de référence ; la version 2.1.303 (18 octobre) est une version consacrée à la fiabilité dont la note tient en une ligne.²⁷⁸

Configuration du mode automatique et corrections de /usage. /auto-mode-setup (v2.1.304) propose une configuration guidée qui lit votre projet et vos sessions récentes pour préparer des entrées autoMode.environment ; elle est également disponible sur Bedrock, Vertex, Foundry, la passerelle des applications Claude et dans les sessions où la télémétrie est désactivée. La documentation de configuration du mode automatique la décrit. /usage (v2.1.305) transforme chaque avertissement en une correction d’une ligne qui en indique la source, et f applique ces corrections, également affichées dans VS Code et /doctor ; /usage indique aussi quand la limitation de débit d’accès aux données d’utilisation prend fin. Sur Pro et Max, la reprise d’une conversation inactive qui consommerait une part notable du quota d’utilisation sur 5 heures affiche désormais un avertissement et propose de démarrer une nouvelle conversation (v2.1.304). Voir Mode automatique sur Max et la ligne /usage dans Commandes slash.²⁷⁸²⁷⁹

Paramètres et environnement. sandbox.allowNestedUserNamespaces (v2.1.305) permet aux commandes exécutées dans le bac à sable sous Linux de créer des espaces de noms utilisateur (Chromium, podman sans privilèges root), mais leur permet aussi de contourner les protections des fichiers du bac à sable. CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS (v2.1.305) permet au mode de nouvelle tentative sans surveillance de détecter qu’une limite d’utilisation a été levée avant sa réinitialisation. CLAUDE_CODE_AUTO_COMPACT_WINDOW accepte les suffixes k et M, comme --autocompact, et avertit en cas de valeur hors limites (200k définissait silencieusement une fenêtre de 100 000). allowedMcpServers cesse de filtrer les serveurs stdio de managed-mcp.json qui utilisent ${VAR} uniquement dans env : un serveur absent de votre liste d’autorisation sera donc chargé après la mise à niveau (utilisez deniedMcpServers pour le maintenir désactivé). La recherche d’outils est activée par défaut derrière une passerelle personnalisée ANTHROPIC_BASE_URL (v2.1.304), et la v2.1.305 corrige la régression de la version 2.1.304 qui faisait échouer toutes les requêtes sur Vertex, Bedrock et les autres fournisseurs dont le point de terminaison rejette la recherche d’outils : Claude Code réessaie désormais sans celle-ci. Les plugins que Claude Desktop monte à partir d’un chemin perdent leurs allowed-tools lorsque allowManagedPermissionRulesOnly est activé. Au 23 octobre, tous ces éléments figurent dans la documentation, à l’exception de l’activation par défaut de la recherche d’outils.²⁷⁸²⁷⁹

Mods, skills et hooks. L’événement tool.check d’un mod contient e.isReadOnly, sa réponse peut définir decider: "person" pour que seuls la boîte de dialogue de permission ou un rappel de l’hôte puissent donner leur approbation, les hooks settings.read reçoivent chaque couche de paramètres et réécrivent les paramètres fusionnés, une ligne de l’historique indique le plugin qui a ignoré l’un de vos hooks, et un volet ancré ne dépasse pas 45 % de la largeur du terminal (v2.1.305). Après le compactage, la liste des skills est renvoyée à Claude, et /reload-skills n’envoie que les skills nouveaux ou modifiés ; les skills d’une même source peuvent enregistrer au maximum 1 024 hooks et 16 384 caractères de motifs de correspondance par session ; le hook once d’un skill ne supprime plus le hook identique d’un autre skill. Lors de la reprise d’un workflow, les résultats des agents pipeline() et parallel() déjà terminés sont récupérés dans le journal de l’exécution au lieu de relancer ces agents (v2.1.305) ; les réveils de /loop à cadence autonome au délai maximal d’une heure ne surviennent plus juste après l’expiration du cache des prompts ; claude --worktree ne supprime plus le worktree et sa branche sans confirmation à la fermeture lorsque HEAD était détaché ou pointait vers une autre branche ; rm -r sur un lecteur monté ou un dossier situé à sa racine déclenche la demande de confirmation de sécurité ; enfin, Code Review ajoute des niveaux de revue (Rapide, Standard, Approfondie) et une option permettant de passer en revue tous les dépôts d’une organisation GitHub. La boîte de dialogue /fast abandonne la mention « (research preview) » sur Opus 5.5.²⁷⁸

Nouveautés de la v2.1.302

Claude Code 2.1.302 est sorti le 16 octobre 2026 : npm l’a publié à 16:48 UTC, puis la version GitHub a suivi à 20:53 UTC avec les mêmes 63 points que le CHANGELOG de référence. Les étiquettes npm latest et next pointent toutes deux vers cette version, tandis que stable reste à 2.1.292. Elle succède à 2.1.301 (15 octobre, 51 points) ; aucune version n’a été sautée. La documentation, consultée le 17 octobre, décrit le déplacement vim et le rendu des formules mathématiques dans VS Code introduits dans 2.1.301, mais aucun des éléments ci-dessous pour l’instant : le CHANGELOG est donc la source de chacun d’eux.²⁷⁵²⁷⁶

claude -p et le SDK démarrent à nouveau en mode manuel. Une session claude -p ou Agent SDK sans mode d’autorisation défini démarre désormais en default (manuel) avec les fournisseurs tiers, lorsque la télémétrie est désactivée et sur une nouvelle installation ; --permission-mode auto conserve le mode automatique. Cela annule la règle de la v2.1.285 qui faisait démarrer ces sessions en mode automatique, sans modifier les sessions interactives du terminal et de VS Code : elles restent en mode automatique pour tous les forfaits et fournisseurs. La documentation sur les modes d’autorisation décrit encore le comportement de la v2.1.285. Consultez Modes d’autorisation.²⁷⁵²⁷⁶

Subagents fork et exécution en arrière-plan par défaut. Les subagents fork (subagent_type: "fork") sont activés par défaut dans claude -p, l’Agent SDK, l’application de bureau et VS Code, comme ils l’étaient déjà dans le terminal ; CLAUDE_CODE_FORK_SUBAGENT=0 les désactive, et claude mcp serve ne les propose jamais. L’application de bureau et VS Code exécutent désormais toujours les subagents de la conversation principale en arrière-plan, comme le terminal, au lieu de laisser Claude choisir. En revanche, les appels Agent effectués par un subagent lui-même dans claude -p, le SDK, l’application de bureau et VS Code s’exécutent par défaut au premier plan. Les hooks de type prompt et agent s’exécutent désormais à raison de 12 au maximum à la fois pour un même événement ; les autres attendent leur tour. La documentation sur les variables d’environnement et les subagents indique encore que le mode fork n’est activé que dans les sessions interactives. Consultez Que sont les subagents ?.²⁷⁵²⁷⁶

Mode automatique et compactage. CLAUDE_CODE_AUTO_MODE_MODEL choisit le modèle utilisé par le classificateur du mode automatique côté client ; cette variable ne change pas le modèle du mode automatique côté serveur. Avec le classificateur côté serveur, une conversation trop longue pour le contrôle de sécurité est désormais compactée, au lieu de voir chaque appel d’outil contrôlé refusé. /config propose une ligne Compactage en cas d’inactivité pour désactiver ou réactiver ce compactage, et l’avis affiché après un tel compactage indique comment le désactiver. L’erreur « Le prompt est trop long », qui survenait à l’arrêt d’un tour pendant le compactage, est corrigée. Par ailleurs, /autocompact et /effort enregistrent les paramètres pour le bon modèle lorsqu’une passerelle désigne Opus 4 ou 4.1 avec un préfixe tel que anthropic/claude-opus-4-1.²⁷⁵

Claude Design fermera au plus tard le 14 décembre 2026. /design-sync et /design-login affichent désormais un avis annonçant la fermeture de la version autonome de Claude Design (claude.ai/design) au plus tard à cette date. De leur côté, /design consent et /design revoke orientent les sessions cloud vers claude.ai/design/settings au lieu de /design-login. Consultez la ligne /design dans Commandes slash.²⁷⁵

Correctifs à connaître. L’outil Read ne charge plus intégralement en mémoire une image de n’importe quelle taille, ni un tube ou un périphérique dont le nom ressemble à celui d’une image : les sources d’images de plus de 128 Mo sont refusées. Un outil ajouté en cours de session puis chargé à nouveau via ToolSearch ou après un compactage ne provoque plus de défaut de cache du prompt. claude plugin et les autres sous-commandes attendent la fin des écritures de paramètres ou de configuration en attente avant de quitter : une modification n’est donc plus perdue ni laissée dans un fichier .tmp. Les catalogues de plugins ne sont plus reclonés à chaque actualisation et les plugins git n’affichent plus la version « inconnue » lorsque git utilise par défaut le format de références reftable ; l’isolation par worktree fonctionne avec git 2.56 ou ultérieur lorsqu’un fichier .git résiduel pointe vers un répertoire inexistant. Les serveurs MCP qui négocient la version 2026-07-28 du protocole mais omettent resultType, ttlMs ou cacheScope affichent désormais leurs outils. Les suggestions de prompts sont omises après une réponse facturée sur les crédits d’utilisation. Les requêtes n’échouent plus avec le message « diagnostics : les entrées supplémentaires ne sont pas autorisées » après un passage à Vertex ou Bedrock en cours de session. Le démarrage avec de nombreux plugins est plus rapide, surtout sous Windows, et les écritures de fichiers sur des lecteurs exFAT ou FAT32 sous Windows ne sont plus refusées.²⁷⁵

Sessions cloud et Claude Tag. La page d’une routine affiche une bannière expliquant pourquoi sa dernière exécution n’a pas démarré, par exemple en raison de la limite de sessions cloud simultanées de l’organisation ; « Revenir à ce point » fonctionne sur tous les messages (les runners autohébergés nécessitent la v2.1.246 ou une version ultérieure) ; une exécution ayant échoué en cours de route n’est plus relancée depuis le début une heure plus tard ; et le coût ainsi que l’utilisation d’une session cloud ne repartent plus de zéro lorsqu’elle reprend dans un nouveau processus. Les paramètres d’administration de Claude Tag sont réorganisés en onglets Lots, Connecteurs, Skills et plugins, et Canaux ; les images HEIC, SVG, TIFF et BMP jointes dans Slack parviennent désormais à Claude sous forme de fichiers ; et le rôle de gestionnaire donne désormais aussi accès à Claude Tag dans Slack lorsque les organisations en restreignent l’accès selon le rôle.²⁷⁵

Nouveautés de la v2.1.301

Claude Code 2.1.301 est sorti le 15 octobre 2026 (npm à 14:34 UTC ; la version GitHub publiée à 19:22 UTC reprend les mêmes 51 points que le CHANGELOG de référence). L’étiquette npm latest est passée à 2.1.302 le lendemain ; les deux versions sont donc traitées ensemble ici.²⁷⁵

Les nouvelles tentatives sans supervision ont désormais une attente maximale en cas de limite d’utilisation. CLAUDE_CODE_RETRY_WATCHDOG_MAX_USAGE_LIMIT_WAIT_MS permet au mode de nouvelle tentative sans supervision (CLAUDE_CODE_RETRY_WATCHDOG) de mettre fin à une requête lorsque la réinitialisation d’une limite d’utilisation est trop lointaine, au lieu d’attendre ; cette variable figure aux côtés de CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS dans la Référence des variables d’environnement. Autres changements pour les opérateurs : lors du passage à un modèle doté d’une fenêtre de contexte plus petite, le modèle précédent résume désormais toute conversation trop longue pour le nouveau, au lieu de dépenser des crédits d’utilisation pour produire un résumé sans demander votre accord ; les alias fable et best réessaient une fois avec le modèle Fable précédent lorsque le plus récent n’est pas disponible pour votre organisation ; et une conversation passant par une passerelle LLM dont les réponses désignent un modèle différent de celui demandé n’est plus compactée en boucle.²⁷⁵

Télémétrie, vim et mods. Les événements OpenTelemetry tool_decision incluent désormais classifier_verdict et permission_mode, ce qui permet de distinguer les décisions du classificateur du mode automatique des règles d’autorisation. Lorsque OTEL_LOG_TOOL_DETAILS=1, ils incluent également classifier_category, qui indique la règle intégrée ayant déclenché un blocage par le classificateur. Le mode Vim gagne le déplacement % : il permet d’aller au délimiteur correspondant, seul ou avec d, c ou y (la documentation du mode interactif le mentionne déjà). Les mods disposent désormais de rows sur Input pour créer un champ de texte de plusieurs lignes dans le terminal : Entrée envoie le contenu, tandis que Maj+Entrée, ou une barre oblique inverse avant Entrée, insère une nouvelle ligne ; le gestionnaire .catch d’un hook de mod ne s’exécute désormais que lorsque le hook lève une exception ou dépasse le délai imparti ; $.env.set se résout avec {} une fois la variable définie ou supprimée, ou avec { deny } pour en indiquer la raison ; $.model.fork ne renvoie plus nothing-to-fork avant la première réponse d’un nouveau processus ; et, dans VS Code ainsi que dans les applications de bureau et mobiles, une arborescence affichée au-dessus de la boîte de dialogue de question peut contenir du Markdown et jusqu’à 48 lignes. Consultez Mods et Mode Vim.²⁷⁵²⁷⁶

Correctifs à connaître. Quitter l’application ne supprime plus sans demander votre accord un worktree créé par un hook WorktreeCreate lorsqu’il peut contenir des commits non poussés. Grep et Glob signalent une erreur lorsque le programme de recherche échoue, au lieu d’indiquer « aucun résultat ». Les skills et les commandes comportant un très grand nombre de noms d’arguments ou des noms très longs ne bloquent plus pendant plusieurs secondes : seuls les 64 premiers noms, limités à 64 caractères chacun, sont complétés. L’outil Read ne lit plus les fichiers binaires tels que .xlsm, .parquet, .epub et .heic comme du texte. La liste des skills est de nouveau transmise au modèle après /rewind. Un appel d’outil interrompu par un message envoyé en cours de tour pendant la vérification de ses autorisations n’est plus présenté au modèle comme ayant été refusé par vous. En mode vim, Échap n’efface plus une réponse AskUserQuestion saisie : le champ de texte libre prend en charge le mode NORMAL, et Échap n’annule la saisie que depuis ce mode. Un disque plein produit désormais une erreur qui identifie le disque, au lieu du message trompeur « Veuillez exécuter /login ». Les runners autohébergés démarrés depuis Slack peuvent joindre un dépôt lorsque les paramètres gérés restreignent les serveurs MCP (utilisez deniedMcpServers pour maintenir ces outils désactivés). VS Code affiche les formules mathématiques LaTeX dans les réponses, y compris les blocs $$ et \[ ... \], et propose un lien « Obtenir davantage d’utilisation » sur la bannière de limite d’utilisation pour Pro et Max.²⁷⁵

Nouveautés de la v2.1.300

Claude Code 2.1.300 est sorti le 14 octobre 2026, quelques heures après 2.1.299 : npm l’a publié à 14:27 UTC sous next, puis la version GitHub a suivi à 18:24 UTC avec les mêmes 88 points que le CHANGELOG de référence. En soirée, les étiquettes npm latest et next pointaient toutes deux vers 2.1.300, tandis que stable était passé de 2.1.287 à 2.1.292. Aucune version n’a été sautée.²⁷³ L’outil advisor arrive sur Claude Platform on AWS. /advisor fonctionne désormais sur Claude Platform on AWS ; aucun conseiller ne s’exécute tant que vous n’en avez pas choisi un avec /advisor, advisorModel ou --advisor, et CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1 désactive l’outil. Au 14 octobre, la page de documentation d’advisor classe encore Claude Platform on AWS parmi les fournisseurs non pris en charge. L’outil lui-même, qui permet à Claude de consulter un second modèle aux étapes de décision, existait avant cette version et est décrit dans L’outil Advisor.²⁷³²⁷⁴

Mods et télémétrie. Les mods bénéficient de décorations de prompt virtualText (du texte affiché dans la zone de saisie qui n’est jamais intégré au brouillon), de $.ui.view({ agentId }) pour afficher la transcription d’un agent dans la vue principale ($.ui.view({}) permet de revenir en arrière), d’une propriété dir sur Text pour les lignes de droite à gauche, et du hook prompt.change pour les modifications de la zone de saisie qui ne proviennent pas de la frappe (rappel d’une entrée de l’historique, effacement, annulation, remplissage par un plugin) ; agent.spawn peut désormais réécrire le prompt et le model d’un agent de workflow au lieu de seulement refuser son lancement, et la documentation de référence des mods fait remonter la cause rewritten sur next.error.cause à la v2.1.300. Les événements OpenTelemetry api_request distinguent les écritures en cache avec cache_creation_5m_tokens et cache_creation_1h_tokens, les spans de trace portent des attributs issus des conventions sémantiques GenAI tels que gen_ai.provider.name, gen_ai.conversation.id, gen_ai.tool.name et error.type, et un prompt réécrit ou supprimé par le hook prompt.submit d’un mod n’est plus enregistré comme ayant été saisi dans l’événement user_prompt. Les transcriptions locales enregistrent désormais aussi le prompt système, les outils et les paramètres de chaque requête API, de sorte qu’une transcription partagée permet de reproduire exactement une requête (voir Mods et Télémétrie).²⁷³²⁷⁴

Changements de fonctionnement et de comportement. Les requêtes volumineuses vers api.anthropic.com utilisent gzip même lorsque la télémétrie est désactivée ; CLAUDE_CODE_GZIP_REQUEST_BODIES=0 désactive cette compression. La valeur updatedInput des hooks PreToolUse et PermissionRequest est validée comme les entrées de Claude lui-même : les clés inconnues sont supprimées et toute entrée rejetée par l’outil entraîne le refus de l’appel. À la fermeture, les commandes en arrière-plan encore actives 1,5 seconde après avoir reçu une demande d’arrêt sont arrêtées de force. claude remote-control supprime ses options --sandbox et --no-sandbox, qui étaient sans effet ; passer l’une ou l’autre provoque une sortie avec erreur, et il faut utiliser sandbox.enabled dans les paramètres pour exécuter ces sessions dans un bac à sable. Les sessions sous CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST ignorent les variables de fichiers de certificats CA, de proxy d’outils, de TLS Git et de configuration Git définies dans les paramètres, telles que SSL_CERT_FILE. Dans les sessions cloud Cowork, la valeur setMode d’un hook PermissionRequest est ignorée, tandis que le reste de son approbation s’applique. L’onglet Code de Claude Desktop applique les paramètres gérés lorsque forceLoginGatewayUrl désigne une passerelle exploitée par Anthropic qui dessert le nom d’hôte de la session, et claude gateway s’arrête au démarrage s’il rencontre une clé de politique desktop: qu’il ne peut pas utiliser. Les options de /sandbox portent le libellé « Exécuter les commandes dans un bac à sable ». VS Code bénéficie de claudeCode.attachSelection pour empêcher l’ajout des sélections de l’éditeur à vos messages. Dans Slack, Claude Tag peut répondre dans les canaux Slack Connect lorsqu’un administrateur l’autorise.²⁷³

Corrections à connaître. Les hooks SessionEnd s’exécutent lorsque vous quittez alors qu’une commande tourne encore en arrière-plan ; ENABLE_TOOL_SEARCH=auto ne se désactive plus en cours de conversation ; une connexion refusée par forceLoginOrgUUID ne laisse plus de jeton de cette organisation enregistré ; les sessions sans interface et SDK reprises après une compaction conservent les messages préservés par celle-ci ainsi que son résumé ; une conversation n’échoue plus à chaque tour avec une erreur 400 lorsque l’API rejette le schéma d’entrée d’un outil MCP (l’outil est alors envoyé sans paramètres) ; les hooks d’agent respectent leur model ; les sessions --worktree démarrent depuis le bon commit lorsqu’un tag ou une branche porte un nom identique à un identifiant de commit, et peuvent être rouvertes dans les dépôts reftable ; claude daemon stop --any attend, arrête de force un service bloqué et se termine avec le code 1 si celui-ci est toujours présent ; Write et Edit dans les sessions cloud Cowork ne signalent plus de réussite pour un chemin situé sur votre propre ordinateur ; les sessions cloud ne restent plus bloquées cinq minutes par tour lorsque la politique de l’organisation ne peut pas être lue ; et les runners auto-hébergés ne se figent plus lorsque personne ne lit leur sortie.²⁷³

Nouveautés de la v2.1.299

Claude Code 2.1.299 est sorti le 14 octobre 2026 (npm à 00:23 UTC ; la version GitHub publiée à 02:49 UTC reprend les mêmes 190 points que le CHANGELOG de référence). Les versions 2.1.297 et 2.1.298 n’ont jamais été publiées : aucune version n’est donc omise. Sur npm, latest pointait vers la version 2.1.299 jusqu’à ce que la version 2.1.300 la remplace plus tard dans la journée (voir Nouveautés de la v2.1.300).²⁷¹²⁷³ Passez à cette version si vous utilisez la 2.1.296 : elle corrige deux régressions introduites par cette dernière, à savoir l’échec des actions de modification et de nouvelle tentative dans les sessions cloud Cowork et claude.ai sur un message arrêté pendant l’exécution de ses hooks UserPromptSubmit ou de mod prompt.submit, et la double exécution d’un appel d’outil approuvé dans les sessions cloud ou sans interface lorsqu’un nouveau message arrivait pendant la reprise de la session après un redémarrage.

Compaction en période d’inactivité (v2.1.299). Une conversation dans le terminal comptant au moins 200 000 tokens et laissée inactive pendant environ 54 minutes est désormais compactée avant l’expiration de son cache de prompts d’une heure, afin que le message suivant ne nécessite pas de retraiter tout le contexte. CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS modifie ce seuil de 200 000 tokens (les valeurs inférieures à 100 000 sont relevées à 100 000), et "idleCompaction": false dans settings.json désactive cette fonctionnalité ; la documentation de référence des paramètres et la page des variables d’environnement répertorient ces deux réglages et indiquent leur disponibilité à partir de la v2.1.290. Avec CLAUDE_CODE_DISABLE_FILE_MENTIONS=1, une mention @ transmet à Claude le chemin à lire avec ses outils de fichiers plutôt que le contenu du fichier, ce qui déclenche vos hooks PreToolUse lors de la lecture ; les paramètres du projet et les paramètres locaux ne peuvent pas définir cette variable (voir Référence des variables d’environnement).²⁷¹²⁷² La v2.1.302 ajoute une ligne Compaction en période d’inactivité dans /config pour désactiver ou réactiver cette fonctionnalité, et l’avis affiché après une telle compaction explique comment procéder.²⁷⁵

Autorisations et MCP. Une règle d’autorisation telle que mcp__a ne s’applique désormais qu’au serveur nommé a, et non à a__b ou a_ ; utilisez mcp__<server>__* avec le nom normalisé complet du serveur, et désignez de la même manière un serveur dont le nom contient __ dans la liste tools: d’un agent, qui n’ajoute désormais que les outils de ce serveur. Les règles de refus et de demande de confirmation s’appliquent de nouveau aux serveurs dont le nom normalisé contient un double trait de soulignement. Les descriptions d’outils et les instructions des serveurs MCP officiels de Anthropic sur api.anthropic.com parviennent intégralement à Claude, au lieu d’être tronquées à 4 096 caractères. Les connecteurs des sessions cloud et de Remote Control négocient par défaut le protocole MCP 2026-07-28 sur les installations qui ne récupèrent aucun indicateur de fonctionnalité (MCP_PROTOCOL_NEGOTIATION=legacy désactive ce comportement), les requêtes vers le proxy de connecteurs de claude.ai et vers les serveurs MCP hébergés par Anthropic ne suivent plus les redirections HTTP, le OAuth MCP envoie désormais les valeurs configurées pour headers et headersHelper, un fichier .mcp.json vide n’est plus signalé comme invalide, et les serveurs nommés constructor ou prototype parviennent à se connecter. Une commande exécutée dans un bac à sable ne peut plus écrire dans un dossier --plugin-dir ni accéder à un chemin interdit via un lien symbolique, les demandes de confirmation pour rm ne se déclenchent plus sur un script shell -c qui n’exécute pas rm, et une commande rm construite à l’exécution dans un script que Claude Code ne peut pas lire ne déclenche une demande de confirmation qu’avec CLAUDE_CODE_STRICT_INLINE_SHELL_RM_PROMPT=1.²⁷¹

Hooks et mods. Les hooks UserPromptSubmit s’exécutent avant le développement d’un skill ou d’une commande slash personnalisée : un hook qui bloque le prompt empêche donc aussi l’exécution des commandes shell qu’il contient, et le hook UserPromptSubmit défini dans les métadonnées d’en-tête d’un skill s’exécute pour la première fois sur le prompt qui suit celui qui l’invoque. Un hook de plugin auquel il est impossible de transmettre une action, ou qui ne peut pas renvoyer sa réponse, refuse désormais l’action au lieu de la laisser passer ; si l’outil s’est déjà exécuté, son résultat n’est pas transmis. Pour les mods, le hook turn.start reçoit aussi les tours des subagents et des coéquipiers (e.agentId permet de les distinguer), skill.prompt reçoit les métadonnées d’en-tête, la source, le nom du plugin et le chemin du fichier du skill (la documentation de référence des mods fait remonter ces ajouts à la v2.1.299), $.prompt.media permet au hook prompt.submit d’un mod chargé via les paramètres gérés de lire une image ou un document joint, $.session.identity() indique le mode de connexion de la session, Text accepte size, weight, mono et tabular, et Box des niveaux d’espacement nommés (bold est obsolète au profit de weight), session.append bénéficie d’un point d’entrée queue, et agent.spawn se déclenche lors de la reprise d’un subagent ou d’un coéquipier avec resume défini. Les mods désactivés à distance sont déchargés entre les tours, et /plugin ainsi que claude plugin validate indiquent les hooks ignorés lorsqu’une organisation gère Claude Code (voir Mods).²⁷¹²⁷² Commandes, interfaces et opérations. /usage vous avertit des effets de l’effort maximal, des workflows, du contexte permanent et des résultats d’outils volumineux. Dans la vue des agents, /effort et /fast définissent les paramètres de démarrage des nouvelles sessions, /model, /effort ou /fast sans argument ouvre un sélecteur, et le panneau d’aperçu affiche une ligne indiquant le mode sécurisé pour les sessions démarrées avec --safe-mode. Le mode plan affiche une seule fois une note lorsqu’il ne demandera pas votre accord avant la plupart des modifications parce que le contournement des autorisations est disponible. claude plugin eval accepte --disallow-tools et un champ disallowed_tools par cas de test, et une exécution qui se termine sur une erreur API obtient un score de 0 et fait échouer la suite. claude self-hosted-runner orchestrator --shutdown-drain-sec laisse aux interrogations en cours et aux hooks de lancement le temps de se terminer à la réception de SIGTERM. Derrière une passerelle d’applications Claude, CLAUDE_CODE_ATTRIBUTION_HEADER=0 dans le champ env d’une politique code ou cli supprime le bloc d’attribution. Dans les sessions cloud de Cowork, un hook PermissionRequest ne peut plus approuver de commandes shell ni de subagents en mode automatique, et une action de Claude dans Chrome signalée par le classificateur de sécurité sur un site approuvé vous demande votre accord au lieu d’être refusée. La commande de reprise affichée à la fermeture désigne la session par son identifiant ; /btw dans les sessions non interactives expire après 11 minutes ; une session locale peut surveiller 25 artefacts publiés, contre 10 auparavant ; et l’avis de protection contre les risques cyber ne vous demande plus de vous inscrire au Cyber Verification Program.²⁷¹

Correctifs à connaître. Les flux passant par une valeur personnalisée de ANTHROPIC_BASE_URL attendent les données pendant 300 secondes au lieu de s’interrompre après 180 ; les requêtes adressées à Anthropic pour les indicateurs de fonctionnalités, le démarrage, le mode rapide, le profil et les paramètres gérés par le serveur ne transmettent plus la clé API d’une passerelle tierce ; /usage et la ligne d’état n’affichent plus une utilisation supérieure à 100 % ; les tâches planifiées et les boucles ne se relancent plus après chaque tour pendant l’heure répétée lors du passage à l’heure d’hiver ; la mémoire ne croît plus sans limite avec --debug ou lorsqu’un processus parent cesse de lire stderr ; SendMessage retrouve un subagent par son nom après un redémarrage ; Read gère les fichiers UTF-16LE avec un indicateur d’ordre des octets et Write refuse de convertir silencieusement en UTF-8 les fichiers Windows-1252, Shift-JIS, GBK ou UTF-16BE ; enfin, sous Windows, les hooks PreToolUse et PermissionRequest qui ne définissent aucun shell bloquent l’appel lorsque Git for Windows est absent, au lieu de le laisser passer.²⁷¹

Nouveautés des versions v2.1.293 à v2.1.296

Quatre versions sont sorties entre le 7 et le 9 octobre 2026. Sur npm, latest et next sont en version 2.1.296 ; stable passe de 2.1.285 à 2.1.287.²³⁸ La principale nouveauté est un modèle : Claude Haiku 5.5 arrive dans la v2.1.293 et devient le modèle sélectionné par haiku sur l’API Anthropic (voir Modèles disponibles). Passez à la v2.1.296 si vous vous connectez à une passerelle d’applications Claude à partir de paramètres gérés : elle corrige une régression de la v2.1.295 qui ignorait une connexion enregistrée à la passerelle lorsque forceLoginMethod valait gateway sans forceLoginGatewayUrl.

v2.1.296 (9 octobre). Les lectures du cache de Sonnet 5.5 sont facturées à 0,10 $ par million de tokens dans /cost, la ligne d’état, --max-budget-usd et les montants de coûts du SDK, qui utilisaient auparavant 0,20 $. La limite par défaut des descriptions d’outils MCP envoyées dès le départ et des instructions des serveurs MCP passe de 2 048 à 4 096 caractères. Le frontmatter des subagents et les définitions --agents acceptent autoCompactWindow, ce qui permet à un subagent de compacter automatiquement son contexte plus tôt que la conversation principale. CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL fait fonctionner tous les agents de workflow avec un même modèle, tandis que les autres subagents conservent le leur, et CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS définit un délai maximal plus long pour l’attente progressive après une erreur 529. L’outil Read accepte allow_large, ce qui permet à Claude de lire un fichier texte dépassant la limite de taille habituelle en un seul appel lorsque le contexte dispose de suffisamment de place. Les hooks PreToolUse des paramètres gérés qui refusent un appel d’outil avec "continue": false, ainsi que les hooks prompt gérés qui en bloquent un, mettent désormais également fin au tour. --debug indique les champs de frontmatter non reconnus dans les fichiers d’agents personnalisés et consigne la commande, le plugin, le résultat et la durée de chaque hook de commande. Les passerelles d’applications Claude disposent d’une clé code sous managed.policies[], avec les mêmes paramètres que cli, également appliqués dans l’onglet Code de Claude Desktop. Un tour ou une commande ! lancé pendant que ← fait passer la session en arrière-plan est désormais arrêté au lieu de se terminer hors de vue. La documentation a depuis intégré deux de ces changements : la référence des hooks situe l’ajout des lignes --debug par hook à la v2.1.296, et la documentation des passerelles d’applications Claude décrit la clé de politique code ; autoCompactWindow et CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS ont été ajoutés à la documentation des subagents et des variables d’environnement au plus tard le 14 octobre ; au 14 octobre 2026, CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL ne figure encore que dans les notes de version.^238240270272

v2.1.295 (8 octobre). Les hooks de commande et HTTP acceptent onFailure: "block" : un hook qui ne peut pas démarrer, dépasse le délai imparti ou se termine avec un code inattendu bloque l’action au lieu de la laisser passer (voir Protocole d’entrée/sortie des hooks). CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS plafonne le temps pendant lequel le mode de nouvelle tentative sans surveillance attend face aux erreurs 429 et 529. Les subagents préchargent au maximum 32 skills à partir du champ skills, et les descriptions d’outils MCP chargées par la recherche d’outils sont tronquées à 16 384 caractères au lieu de 2 048. forceLoginMethod: "gateway" et forceLoginGatewayUrl fonctionnent désormais dans vos propres paramètres utilisateur sur une machine sans paramètres gérés, de sorte que /login s’ouvre sur cette passerelle, une configuration maintenant décrite dans la documentation des passerelles ; chaque service en amont d’une passerelle accepte une liste facultative models, avec * comme caractère générique, et les services cloud en amont respectent timeouts.upstream_ttfb_ms. Les terminaux qui implémentent le Program Status Protocol (OSC 7501) peuvent indiquer si Claude Code travaille, attend votre intervention ou a terminé. Les requêtes en arrière-plan derrière une passerelle d’applications Claude utilisent Haiku 4.5 à la place du modèle de la session lorsque la passerelle le propose. Une requête destinée à un modèle [1m], dont la bêta context-1m est refusée par une passerelle, Bedrock, Vertex ou Foundry, est renvoyée sans cette bêta au lieu d’échouer. Ctrl+C à l’invite inactive d’une session en arrière-plan à laquelle vous êtes rattaché laisse intact le réveil /loop en attente : deux pressions vous détachent donc de la session, tandis que la boucle continue de fonctionner ; Échap l’arrête. Les connecteurs claude.ai négocient par défaut la version 2026-07-28 du protocole MCP sur les installations qui ne récupèrent aucun indicateur de fonctionnalités. /copy propose le texte cité, claude -p indique sur stderr ce qu’il attend après son dernier tour, et les mods disposent de $.ui.notify. Les recherches Web et les évaluations des hooks agent ne prennent plus beaucoup plus de temps aux niveaux d’effort xhigh et max.²³⁸²⁴⁰

v2.1.294 (8 octobre). Deux correctifs concernent les hooks prompt et agent rédigés sous forme d’instructions : un hook tel que « Bloquez les commandes qui… » n’autorise plus ce qu’il devrait bloquer, et les hooks Stop et SubagentStop tels que « Continuez si la compilation échoue » sont évalués de manière à réduire le risque que Claude s’arrête trop tôt.²³⁸

v2.1.293 (7 octobre). Claude Haiku 5.5 (claude-haiku-5-5) est le modèle Haiku par défaut sur l’API Anthropic : contexte de 1 million de tokens, 0,10 $/0,50 $ par million de tokens, 0,50 $/2,50 $ pour les prompts de plus de 100 000 tokens. Les données de subagentStatusLine intègrent agentType, ce qui permet à un script de ligne d’état de distinguer les types de subagents personnalisés ; les mods disposent de isDeferred sur $.tool.register. Deux changements sont annulés : le message de refus du mode automatique de la v2.1.281, qui indiquait à Claude qu’un refus porte sur le résultat et pas seulement sur la commande exacte, et le correctif de la v2.1.290 pour les sessions cloud qui perdaient un réveil /loop après le redémarrage d’un conteneur, ce qui signifie qu’une telle session reste à nouveau en veille. Autres changements : Claude ne considère plus ses dernières actions précédant un compactage comme terminées après celui-ci, une connexion HTTP MCP ne conserve plus toutes les requêtes envoyées jusqu’à sa fermeture, claude purge répertorie ce qu’il n’a pas pu supprimer et se termine avec le code 1 au lieu de s’arrêter silencieusement, la synchronisation des skills de claude.ai effectue une vérification toutes les 40 minutes au lieu de 10 lorsqu’aucune session n’est utilisée, et le démarrage sur Team et Enterprise récupère plus tôt la politique et les paramètres gérés, en relançant une requête bloquée après 3 secondes.²³⁸²⁴⁰

Nouveautés des versions v2.1.288 à v2.1.292

Cinq versions sont sorties entre le 2 et le 6 octobre 2026. Sur npm, latest et next sont en version 2.1.292 ; stable reste à la version 2.1.285.²³⁴ Mettez à jour si vous utilisez la version 2.1.288, 2.1.289 ou 2.1.290 : la v2.1.291 corrige une régression de la 2.1.288 qui pouvait entraîner la perte des derniers messages d’une session à la fermeture, ainsi qu’une régression de la 2.1.290 qui pouvait faire perdre aux sessions cloud les réponses aux demandes d’autorisation.²³⁵ v2.1.292 (6 octobre). Le paramètre CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS permet d’allonger le délai de base entre les nouvelles tentatives d’une requête ayant reçu une erreur de surcharge (529) ; la documentation des variables d’environnement précise désormais la valeur par défaut, 500 ms, et la plage acceptée, de 500 à 32 000. L’outil Agent accepte un paramètre effort, qui permet à Claude d’exécuter un subagent au niveau d’effort demandé ; la documentation des subagents décrit désormais ce paramètre propre à chaque invocation, qui remplace le champ du frontmatter et reste actif à la reprise du subagent, tandis que CLAUDE_CODE_EFFORT_LEVEL prévaut sur les deux. claude plugin install --marketplace <source> ajoute une marketplace et installe un plugin depuis celle-ci en une seule commande shell. Les serveurs MCP locaux (stdio) négocient désormais par défaut la version 2026-07-28 du protocole sur toutes les installations, y compris Bedrock, Vertex et Foundry ; MCP_PROTOCOL_NEGOTIATION=legacy permet de désactiver ce comportement. La documentation MCP indique désormais que cette révision est demandée par défaut aux serveurs stdio. Les noms d’agents sont limités à 256 caractères : tout nom plus long est rejeté, un champ name plus long dans un fichier de skill ou de plugin est ignoré, et la documentation des subagents précise désormais cette limite pour le champ name ; les fichiers de subagents dont le nom dépasse cette limite sont ignorés et une erreur est consignée dans le journal de débogage. Un correctif de sécurité empêche les approbations du hook PreToolUse et le mode automatique de contourner la demande de confirmation lors de la lecture de fichiers depuis des chemins réseau (UNC). Les mods bénéficient de prompt.autocomplete, de la mise en cache des prompts dans $.model.complete et d’agents de workflow dans agent.spawn, et claude plugin test échoue désormais lorsqu’une réponse simulée est refusée. Au 6 octobre 2026, les autres éléments n’étaient mentionnés que dans les notes de version.^236237240

v2.1.290 (5 octobre). Le quota interactif de WebSearch se renouvelle à raison de 100 appels par heure (CLAUDE_CODE_WEB_SEARCH_REFILLS_PER_HOUR ; 0 désactive ce renouvellement), au lieu de s’épuiser après 200 appels. claude attach et claude logs acceptent une partie du nom d’une session. /claude-api managed-agents-onboard <url> transforme une page décrivant le modèle Managed Agents en fichiers ant apply, et /claude-api managed-agents-onboard <quickstart-name> génère un modèle de démarrage rapide de la Console, tel que deep-researcher, avec CLI ant. Plusieurs comportements par défaut deviennent plus stricts : les paramètres d’un projet ne peuvent plus activer Claude dans Chrome, les fichiers .claude/settings.json ou .claude/settings.local.json d’un dépôt ne peuvent plus définir CLAUDE_CODE_DISABLE_ATTACHMENTS, pyright et davantage de variantes de ps demandent une confirmation avant de s’exécuter, et un fichier de paramètres gérés qui pointe hors du dossier des paramètres gérés déclenche un avertissement. WebFetch indique désormais la quantité de texte non lue au-delà de 100 000 caractères dans une page et accepte un offset pour poursuivre la lecture, alors qu’il supprimait auparavant ce texte sans le signaler. CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC désactive également le préchauffage des connexions au démarrage, et CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS=5m n’est plus interprété comme 5 ms : les valeurs comportant un suffixe d’unité entraînent l’utilisation du paramètre dialogExpiry.²³⁵²³⁷

v2.1.290, équipes et passerelles. La page d’approbation de connexion de la passerelle d’applications Claude dispose désormais d’un bouton Refuser, et la version minimale de PostgreSQL prise en charge passe de 14 à 11. Sur les runners autohébergés, claude --environment <id> crée sa session via la version actuelle de API Sessions. claude --teleport et /teleport refusent un stash qui supprimerait des fichiers dans un dossier ayant remplacé un fichier suivi du même nom, et le relais --channels ignore un identifiant de réponse répété au lieu d’approuver une autre demande. Dans Slack, !fast fait passer un fil de discussion en mode rapide et !fast off rétablit le mode précédent. VS Code affiche les horodatages des messages par défaut (le paramètre Claude Code : Afficher les horodatages des messages permet de les désactiver).²³⁵

v2.1.289 (3 octobre). Les mods disposent de agent.spawn pour les coéquipiers, d’un identifiant d’agent unique pour tous les événements des hooks de plugins, ainsi que des états inactif et en attente dans $.agent.list() ; claude plugin validate n’ignore plus les plugins dont le dossier contient également un manifeste de marketplace ; deux failles dans les règles de refus Bash en cas d’autorisation automatique dans le bac à sable sont corrigées.²³⁵²³⁷

v2.1.288 (2 octobre). claude project purge devient claude purge ; l’ancien nom fonctionne toujours et affiche un message d’information. La limite de durée des commandes en arrière-plan ne s’applique qu’aux sessions sans supervision (-p, Agent SDK, CI, cloud). /code-review --max-findings <n>|all modifie le nombre maximal de problèmes signalés jusqu’à ce que vous utilisiez --max-findings default. /autocompact enregistre sa fenêtre pour chaque modèle. CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS désactive les sorties structurées pour Mantle ou les passerelles qui les rejettent. Les règles propres à certains chemins et les fichiers CLAUDE.md imbriqués sont chargés lors des appels à Write et Edit, et plus seulement à Read. Les serveurs de langage expirent après 60 secondes (requestTimeout par serveur) au lieu de rester bloqués. En mode automatique, une conversation trop longue pour le classificateur côté client est compactée au lieu de déclencher une demande de confirmation à chaque appel d’outil ; par ailleurs, le classificateur côté client ignore une valeur de ANTHROPIC_DEFAULT_SONNET_MODEL imposant Claude Sonnet 5.5 ou Opus 5.5 et utilise Claude Sonnet 5 à la place. Les mods bénéficient de $.ui.selection(), les sessions cloud sans GitHub CLI disposent d’un gh api intégré, et la touche Flèche haut dans une invite vide restaure un brouillon effacé par Ctrl+C.²³⁴²³⁷

Nouvelles commandes dans les versions v2.1.105–v2.1.114¹⁴⁶¹⁵⁰

Récapitulatif de session (v2.1.108+)

Une nouvelle fonctionnalité propre à chaque session qui restitue le contexte lorsque vous reprenez une session en pause. Activée par défaut, elle peut être désactivée via /config ou CLAUDE_CODE_ENABLE_AWAY_SUMMARY=0. Le modèle peut également invoquer les commandes slash intégrées (/init, /review, /security-review) via l’outil Skill, ce qui étend le fonctionnement des subagents et des skills.¹⁴⁶

Notifications push (v2.1.110+)

Lorsque Remote Control est configuré avec l’option « Envoyer une notification push lorsque Claude le décide » activée, Claude peut désormais envoyer des notifications push sur mobile de sa propre initiative grâce à un nouvel outil de notification push. Cette fonctionnalité complète l’interface mobile/web existante de Remote Control.¹⁴⁶ /context, /exit et /reload-plugins fonctionnent désormais également depuis les clients Remote Control.

Outil Windows PowerShell (v2.1.111+, déploiement en cours)

Claude Code déploie un outil Windows PowerShell natif. Sur Linux/macOS, activez-le avec CLAUDE_CODE_USE_POWERSHELL_TOOL=1 (nécessite pwsh dans PATH). Sur Windows, la même variable contrôle son activation ou sa désactivation pendant le déploiement.¹⁴⁶

Approbation automatique en mode de permissions (v2.1.119+). Les commandes de l’outil PowerShell peuvent désormais être approuvées automatiquement en mode de permissions, comme les commandes Bash. Les règles d’autorisation telles que PowerShell(Get-*:*) et la syntaxe de motifs existante permettent désormais d’éviter la demande de confirmation pour les opérations en lecture seule, offrant aux équipes la même facilité d’utilisation que sur Linux/macOS.¹⁵²

Réduire les demandes de permission : Bash en lecture seule (v2.1.111+)

Les commandes Bash en lecture seule avec des arguments glob (par exemple ls *.ts, cat src/*.md) et les commandes commençant par cd <project-dir> && ne déclenchent plus de demande d’autorisation.¹⁴⁶ Avec /less-permission-prompts, attendez-vous à nettement moins d’interruptions dans vos tâches quotidiennes.

Traçage distribué (v2.1.110+)

SDK et les sessions sans interface lisent désormais TRACEPARENT et TRACESTATE dans l’environnement, ce qui permet de rattacher les exécutions de Claude Code à des traces distribuées. Associez-les à OTEL_LOG_RAW_API_BODIES=1 (v2.1.111+) pour consigner l’intégralité des corps de requête et de réponse API sous forme d’événements de journal OpenTelemetry à des fins de débogage.¹⁴⁶

Distribution sous forme de binaire natif (v2.1.113+)¹⁵⁰

La v2.1.113 modifie le lancement de CLI : claude lance désormais un binaire natif de Claude Code via une dépendance facultative propre à chaque plateforme, au lieu d’exécuter le JavaScript inclus. Les commandes d’installation et de mise à jour restent identiques, et les équipes n’ont pas besoin de modifier leurs scripts de déploiement.

Raccourcis de l’éditeur de prompts (v2.1.113+)¹⁵⁰

L’éditeur de prompts propose désormais une navigation de type readline dans la saisie multiligne, ainsi que le défilement de la zone d’affichage en plein écran :

Délai d’expiration des subagents bloqués (v2.1.113+)¹⁵⁰

Les subagents qui se bloquent en cours de flux s’arrêtent désormais avec un message d’erreur clair après 10 minutes, au lieu de rester suspendus sans indication. Associez ce mécanisme à CLAUDE_STREAM_IDLE_TIMEOUT_MS (v2.1.84+) pour mieux couvrir les cas de processus bloqués lors des échanges en streaming avec les API.

Correctif de stabilité de la v2.1.114¹⁵⁰

La v2.1.114 (18 avril 2026) apporte un seul correctif : la boîte de dialogue d’autorisation pouvait planter lorsqu’un coéquipier agent-teams demandait l’autorisation d’utiliser un outil. Effectuez la mise à jour si vous utilisez Agent Teams.

Marquage du contenu : filigranes textuels et métadonnées C2PA des fichiers (août 2026)

Anthropic a annoncé un marquage lisible par machine pour le contenu généré par Claude, en réponse à l’article 50 du règlement européen sur l’IA (applicable à compter du 2 août 2026 aux nouveaux systèmes d’IA). Le système comporte deux composantes : un filigrane statistique invisible dans le texte généré, et des métadonnées de provenance signées — conformes à la norme ouverte C2PA — dans les fichiers générés, notamment .svg, .png et .jpg.²⁵²²⁰⁴ Le détail que les gros titres brouillent : les deux composantes suivent le même calendrier selon les modèles. D’après la page d’assistance, « les modèles Claude lancés à partir du 2 août 2026 prendront en charge le marquage lisible par machine dès leur lancement » — les modèles lancés avant cette date, soit toute la gamme actuelle (Fable 5, Opus 5, Sonnet 5, Haiku 4.5), relèvent de la période transitoire prévue par la législation européenne, et Anthropic « travaille à ajouter la prise en charge du marquage à ces modèles également ».²⁰⁴

Cette liste date d’août. Fable 5.1 (1er septembre), Opus 5.5 (22 septembre) et Sonnet 5.5 (28 septembre) ont été lancés après la date limite : cette règle les place donc parmi les modèles marqués dès leur lancement ; les notes de lancement de Fable 5.1 citent la provenance du contenu parmi les nouveautés, tandis que la page du modèle et le guide de migration d’Opus 5.5, ainsi que la page du modèle et la page des nouveautés de Sonnet 5.5, ne mentionnent pas le marquage.^241222230 Les contenus produits par les modèles antérieurs à août ne portent aucun marquage, qu’il s’agisse de texte ou de fichiers ; ceux des modèles plus récents en porteront, sur toutes les interfaces — Claude Platform (API), claude.ai, Claude Code, Claude Cowork, Claude Tag et les passerelles cloud — puisque le marquage s’effectue au niveau du modèle. Une conséquence mérite d’être précisée, car un fil de discussion viral affirmait l’inverse : tout changement de style ou de comportement que vous percevez dans l’un des modèles antérieurs à août ne peut pas être dû au filigranage, puisque le marquage n’y est pas actif.

Fonctionnement : une variante de SynthID-Text de Google DeepMind. Le filigrane modifie « la source de l’aléatoire utilisé pour choisir entre les mots » lorsque Claude choisit entre des formulations de sens équivalent — aucun caractère ajouté, aucun post-traitement et, selon les tests internes de Anthropic, « aucun effet du filigranage sur le contenu, le niveau de créativité ou la lisibilité ».²⁵²

Ce qui intéressera les utilisateurs de Claude Code : le code porte un filigrane peu dense. Le code fonctionnel laisse peu de place aux choix arbitraires ; le marquage se concentre donc là où une liberté existe — commentaires, choix des noms — avec ce que Anthropic décrit comme « un effet négligeable sur le code effectivement produit ».²⁵² La persistance du marquage est probabiliste et varie selon la composante : pour le texte, de légères modifications « ne supprimeront probablement pas complètement le filigrane », une réécriture complète le supprimera, et une traduction produite par Claude portera son propre nouveau marquage ; pour les métadonnées des fichiers, la conversion de format, un nouvel enregistrement et les captures d’écran peuvent supprimer la signature C2PA.²⁰⁴ Une API de détection est prévue ; un résultat positif établit que « Claude est probablement intervenu sur le contenu à un moment donné », sans pouvoir explicitement distinguer « Claude a écrit ceci » de « Claude a largement remanié ceci » — et, selon la page d’assistance, l’absence de marquage ne prouve rien non plus. Aucune possibilité de désactivation n’est mentionnée, quelle que soit l’offre souscrite.²⁵²²⁰⁴

Combien coûte Claude Code ?

Comprendre et maîtriser les coûts est essentiel pour utiliser Claude Code de manière durable. Consultez également Sélection du modèle pour connaître les capacités des modèles et Cadres de décision pour choisir le modèle adapté à chaque tâche.

Consultation des coûts

> /cost

Sortie :

Total cost:            $0.55
Total duration (API):  6m 19.7s
Total duration (wall): 6h 33m 10.2s
Total code changes:    247 lines added, 89 lines removed

Les utilisateurs disposant d’un abonnement voient dans /cost une ventilation par modèle et par accès au cache, indiquant précisément quels modèles ont consommé des tokens et quelle quantité a été fournie depuis le cache (v2.1.92+).¹³⁷

Tarifs contractuels au lieu du prix catalogue (modelPricing, géré, v2.1.243+) : les organisations bénéficiant de tarifs négociés par modèle ou d’un multiplicateur de remise peuvent les déployer via le paramètre géré modelPricing ; /cost, la ligne d’état et les données de coût de la télémétrie utilisent alors ces tarifs au lieu du prix catalogue, afin que les montants affichés aux développeurs correspondent à ce que paie l’organisation.²⁵⁰ Depuis la v2.1.271, le multiplicateur peut également dépasser 1 — jusqu’à 10 — pour les organisations qui refacturent des tarifs majorés à leurs équipes internes.²¹⁶

Ligne du cache de prompt par session (v2.1.251+) : /cost ajoute une ligne consacrée au cache de prompt de la session — taux d’accès, échecs, tokens remis en cache et état chaud ou froid du cache — ainsi qu’un objet prompt_cache correspondant pour les scripts de ligne d’état. L’objet apparaît après la première réponse de API de la conversation principale, ne comptabilise pas les requêtes des subagents et est calculé à partir du nombre de tokens mis en cache dans les réponses de API ; il fonctionne donc avec tous les fournisseurs. /usage affiche les mêmes statistiques sur sa ligne Prompt cache (main).²⁰⁶²⁰⁹ Depuis la v2.1.260, la ligne /cost et l’objet prompt_cache de la ligne d’état indiquent également une cause probable des échecs du cache — par exemple, une modification des définitions d’outils ou du prompt système, ou une session restée inactive au-delà de la durée de vie du cache.²¹²

Le trafic des agents ne rompt plus son propre préfixe de cache (v2.1.265) : deux correctifs colmatent des fuites du cache de prompt dans le travail délégué. La reprise d’un subagent lancé au premier plan ne modifie plus sa liste d’outils ni le préfixe de son prompt système, et les coéquipiers agents comme les subagents repris ne déplacent plus, lors des tours suivants, le contexte du hook SubagentStart et les skills préchargés hors du préfixe du prompt. Ces deux bugs empêchaient la réutilisation du cache de prompt — le préfixe changeait, de sorte que tout ce qui suivait était renvoyé comme entrée non mise en cache — précisément dans les longues sessions agentiques où l’économie du cache compte le plus (le même mode de défaillance que la v2.1.260 avait corrigé pour les tours d’appel d’outils de Fable 5.1).²¹⁵

La série de correctifs de stabilité du cache de la v2.1.267 : une version, une dizaine de correctifs environ, tous liés au même mode de défaillance — un élément réécrivait le préfixe du prompt en cours de conversation, et tout ce qui suivait était renvoyé comme entrée non mise en cache. Les sessions reprises ne réécrivent plus les listes d’outils, ne régénèrent plus les descriptions des outils et ne réécrivent plus les annonces antérieures des outils MCP avant la reconnexion de leurs connecteurs ; changer de modèle avec /model ne renvoie plus toutes les définitions d’outils (le texte d’attribution des commits et PR arrive désormais sous forme de note de conversation actualisée lors des changements de modèle) ; les subagents et les sessions lancés avec --system-prompt ou --append-system-prompt n’enregistrent le prompt système et les définitions d’outils qu’une seule fois ; enfin, les outils MCP et ceux des plugins ajoutés en cours de session parviennent aux sessions sans ToolSearch sous forme de définitions différées, au lieu de provoquer la réécriture de la liste d’outils. Cette série étend les correctifs des v2.1.260 et v2.1.265 aux reprises, aux changements de modèle et aux reconnexions de MCP.²¹⁶

La v2.1.273 maintient le fil de la conversation : /login, /upgrade et /extra-usage supprimaient les raisonnements antérieurs de la conversation, ce qui imposait une réécriture complète du cache de prompt lors de la requête suivante.²¹⁷

La v2.1.277 colmate trois autres fuites de préfixe : dans les sessions poursuivies après /clear (redémarrage, --continue, --resume), une partie du premier message manquait lorsqu’un hook SessionStart produisait une sortie, ce qui provoquait un échec complet du cache de prompt ; les subagents et coéquipiers repris régénéraient les définitions des outils MCP qu’ils avaient chargées, ce qui rompait la mise en cache du prompt pour cet agent ; enfin, les pièces jointes enregistrées plus tôt dans une conversation étaient régénérées après une reprise ou une relance, supprimant le raisonnement étendu et manquant le cache de prompt. Il s’agit du même mode de défaillance que dans les séries v2.1.265-267 — un élément réécrivait le préfixe, puis tout ce qui suivait était renvoyé sans cache — désormais corrigé pour la sortie de SessionStart, les définitions MCP des agents repris et les pièces jointes enregistrées.²¹⁹

La v2.1.280 en ajoute deux autres : un changement de modèle effectué depuis une application hôte (Claude Desktop, VS Code, le SDK) pendant que Claude travaille ne provoque plus d’échec du cache de prompt à l’invite suivante, et un subagent fork repris renvoie désormais la liste d’outils qu’il utilisait initialement au lieu de la reconstruire, ce qui rompait auparavant la mise en cache du prompt pour cet agent.²²⁰

La v2.1.281 en ajoute trois autres : une session reprise après un redémarrage alors qu’une demande d’autorisation était en attente n’envoie plus un historique différent de celui d’avant, ce qui rompait le cache de prompt à partir de ce point ; un serveur MCP qui se déconnecte en cours de conversation, ou qui est encore en cours de connexion après une reprise, ne pénalise plus le cache lorsque la recherche d’outils est désactivée (par exemple derrière un proxy ou une passerelle) ; enfin, les sessions reprises ne renvoient plus les tours précédents sous une forme modifiée, ce qui pouvait amener le API à abandonner le raisonnement antérieur de la conversation.²²⁴

Formules d’abonnement

Limites de débit (août 2025) : Anthropic a instauré des limites de débit hebdomadaires pour les abonnés payants. Les abonnés Max peuvent acheter de l’utilisation supplémentaire au-delà de la limite de débit, aux tarifs standards de API.¹⁴

Doublement des limites de débit (6 mai 2026) : lors de l’événement Code with Claude SF, Anthropic a doublé les limites de débit de Claude Code sur 5 heures pour les formules Pro, Max, Team et Enterprise par siège, supprimé la réduction aux heures de pointe pour les comptes Pro et Max, et augmenté « considérablement » les limites de débit de API pour les modèles Claude Opus. L’accord SpaceX Colossus 1 constitue la capacité de secours : « plus de 300 mégawatts de capacité supplémentaire (plus de 220 000 NVIDIA GPUs) dans le mois ».¹⁵⁷

Limites hebdomadaires à compter du 14 septembre 2026 (annonce du 29 août) : l’augmentation temporaire de 50 % des limites hebdomadaires, en vigueur depuis la hausse de mai, prend fin le 14 septembre. Elle est remplacée par une augmentation permanente de 25 % par rapport au niveau de référence antérieur, pour les formules Pro, Max, Team et Enterprise par siège. Voici le calcul fourni par Anthropic : « Par rapport à aujourd’hui, cela représente une réduction de 17 % des limites hebdomadaires sur Claude Code. » Si votre plafond hebdomadaire actuel est de 150 unités, il passera à 125 le 14 septembre. Les limites sur 5 heures ne sont pas concernées par cette annonce ; le doublement de mai reste en vigueur. Anticipez dès maintenant ce plafond inférieur si vous exécutez de longues sessions sans surveillance : l’option de poursuite automatique après réinitialisation (v2.1.234) et /usage sont les deux contrôles essentiels.²¹³

Tarification des tokens de API (octobre 2026)^1144222239

Pour les utilisateurs facturés via API, tarification par million de tokens :

Tarification du contexte de 1M (avril 2026) : Opus 4.7, Opus 4.6, Sonnet 4.6 et Mythos Preview incluent tous un contexte de 1M aux tarifs standards par MTok — sans supplément pour les contextes longs.¹⁴⁸ Il s’agit d’une harmonisation récente ; les anciennes indications selon lesquelles Opus 4.6 ou Sonnet 4.6 coûtaient 2× le tarif d’entrée et 1,5× le tarif de sortie au-delà de 200K tokens d’entrée ne sont plus valables. Les anciens modèles Opus 4.5 et antérieurs conservent leur structure tarifaire d’origine.

Tarification de la résidence des données : imposer une inférence exclusivement aux États-Unis via inference_geo applique un multiplicateur de 1,1× à l’ensemble de la tarification des tokens, y compris les lectures et écritures du cache (modèles Opus 4.6+).¹⁴⁸

La mise en cache des prompts réduit considérablement le coût des entrées répétées : les écritures dans le cache coûtent 1,25× le tarif de base (cache de 5 minutes) ou 2× (cache de 1 heure), tandis que les lectures ne coûtent que 0,1×, soit une économie de 90 %. Deux exceptions descendent plus bas : les lectures de Claude Opus 5.5 sont facturées à 0,05× (0,20 $/MTok, soit 95 % d’économie), et celles de Claude Fable 5.1 et Mythos 5.1 à 0,025× (0,25 $/MTok pour Fable 5.1, soit 97,5 % d’économie).²⁴¹²²² Pour les systèmes RAG et les assistants de programmation utilisant un contexte répété, la mise en cache peut réduire les coûts de 88 à 95 %.

Le API par lots offre une réduction de 50 %, avec un délai de traitement de 24 heures, pour les tâches non urgentes telles que les suites de tests nocturnes.

Politique relative aux comptes multiples⁵²

Pouvez-vous disposer de plusieurs comptes Claude ? Oui, pour des usages légitimes. Anthropic autorise explicitement plusieurs comptes lorsqu’ils répondent à des besoins distincts.

Ce qui est autorisé :

Limites techniques : - Jusqu’à 3 comptes peuvent être vérifiés avec le même numéro de téléphone - Plusieurs abonnements payants provenant de la même adresse IP ou du même réseau sont explicitement pris en charge - Les comptes sont entièrement séparés ; aucun transfert de chat ou de projet n’est possible entre eux

Ce qui est interdit (selon la Politique d’utilisation) : - Créer des comptes pour contourner une interdiction après avoir été banni - Coordonner des activités malveillantes entre plusieurs comptes afin d’échapper à la détection - Utiliser plusieurs comptes pour contourner les limites de débit ou les crédits de l’offre gratuite

Exemple concret : en janvier 2026, les 22 comptes Max de l’utilisateur intensif Jeffrey Emanuel (@doodlestein) ont été automatiquement signalés et temporairement suspendus. Thariq (@trq212), employé de Anthropic, a résolu le problème en moins de 4 heures après avoir confirmé la légitimité de l’utilisation. Si vous utilisez intensivement Claude Code pour des projets professionnels et personnels répartis sur plusieurs comptes, le service est précisément conçu pour cela ; n’essayez toutefois pas de détourner le système.

En cas de doute : contactez l’assistance de Anthropic afin d’obtenir une confirmation écrite concernant votre configuration particulière.

Facteurs de coût

Exemples de coûts réels

Coûts calculés aux prix catalogue (0,10 $/0,50 $ pour Haiku 5.5 avec des prompts allant jusqu’à 100K tokens, 2 $/10 $ pour Sonnet 5.5 et 4 $/20 $ pour Opus 5.5 par MTok), avant les réductions liées à la mise en cache des prompts.

Conseil pour réduire les coûts : utiliser Haiku pour les subagents d’exploration et Sonnet pour l’implémentation réduit généralement les coûts de 40 à 50 % par rapport à l’utilisation systématique de Sonnet.

Gestion des coûts en équipe

TPM/RPM recommandés selon la taille de l’équipe :

Frais d’outils non apparents

Au-delà de la tarification par token, certains outils entraînent des frais distincts :⁹

Ces frais s’accumulent dans les boucles d’agents. Un cycle de débogage de 100 itérations avec Bash coûte à lui seul environ 24 500 tokens d’entrée supplémentaires en surcoût.

Stratégies de réduction des coûts

1. Utilisez Haiku pour les subagents : la plupart des explorations ne nécessitent pas Sonnet
2. Activez la mise en cache des prompts : elle l’est par défaut, mais vérifiez qu’elle n’a pas été désactivée
3. Définissez un nombre maximal de tours : claude --max-turns 5 évite les conversations incontrôlées
4. Définissez un plafond en dollars : claude --max-budget-usd 5 arrête immédiatement la session lorsqu’elle atteint le plafond de dépenses. Depuis la v2.1.217, ce plafond s’applique également aux subagents en arrière-plan : une fois celui-ci atteint, les nouveaux lancements sont refusés et les agents d’arrière-plan en cours d’exécution sont arrêtés (auparavant, ils échappaient au budget)¹⁹⁴
5. Utilisez le mode plan pour l’exploration : aucune exécution = aucune opération coûteuse accidentelle
6. Compactez de manière proactive : moins de contexte = moins de tokens
7. Limitez la sortie : export CLAUDE_CODE_MAX_OUTPUT_TOKENS=2000
8. Utilisez le API par lots pour les tâches non urgentes : 50 % de réduction sur les tokens d’entrée et de sortie
9. Analysez les dépenses de API de Claude d’un projet : /claude-api cost-optimize (v2.1.247+) analyse les dépenses de API de Claude d’un projet existant et examine les leviers de réduction des coûts (mise en cache, maîtrise des tokens, traitement par lots, effort, choix du modèle), une modification mesurée à la fois — pour les applications que vous créez avec le API, et non pour la session Claude Code elle-même²⁴⁵

Suivi de l’utilisation

• Console Claude : platform.claude.com (rôle Admin ou Billing requis)
• Limites de l’espace de travail : définissez des plafonds de dépenses par espace de travail
• Bedrock/Vertex : utilisez les outils natifs de suivi des coûts du cloud
• LiteLLM : pour un suivi détaillé par utilisateur auprès de fournisseurs tiers

Utilisation des tokens en arrière-plan

Certaines opérations consomment des tokens en arrière-plan : - Résumé de la conversation pour /resume - Commandes /cost et /status - Compactage automatique

Généralement moins de 0,04 $ par session.

API d’analyse de Claude Code (Team/Enterprise)⁴⁶

Accédez par programmation aux données d’utilisation de Claude Code et aux indicateurs de productivité de votre organisation via le API Admin.

Endpoint : GET /v1/organizations/usage_report/claude_code

Prérequis : - Clé API Admin (sk-ant-admin...) - Formule Team ou Enterprise - Rôle Admin, Billing ou Developer

Indicateurs disponibles :

Exemple de requête :

curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?starting_at=2026-01-15" \
  -H "x-api-key: sk-ant-admin..." \
  -H "anthropic-version: 2023-06-01"

Cas d’utilisation : - Analyse de la productivité des développeurs (sessions, commits, PR) - Indicateurs d’utilisation des outils (taux d’acceptation/de rejet pour Edit, Write, etc.) - Suivi et répartition des coûts entre les équipes - Justification de ROI pour les outils de programmation assistée par IA

Remarque : les données apparaissent dans l’heure suivant la fin de l’activité. Pour garantir la cohérence, seules les données datant de plus d’une heure sont incluses dans les réponses.

Cadres de décision

Connaître les fonctionnalités ne suffit pas. Vous devez savoir quand utiliser chacune d’elles. Ces arbres de décision transforment les connaissances en actions.

Quel modèle utiliser ?

START → Is the task simple? (file search, quick question, formatting)
         │
         ├── YES → Use Haiku
         │         Cost: ~$0.03/task
         │         Speed: Fastest
         │
         └── NO → Does it require deep reasoning?
                  (architecture, complex debugging, security analysis)
                  │
                  ├── YES → Use Opus 5.5 (medium effort default; /effort high or xhigh for harder)
                  │         Cost: ~$1.60/task
                  │         Quality: Highest (1M context at standard price, adaptive reasoning)
                  │
                  └── NO → Use Sonnet
                           Cost: ~$0.50/task
                           Balance: Best overall when cost matters

Règle générale : depuis la v2.1.280, le modèle par défaut ne dépend plus de votre abonnement — chaque session démarre avec Opus 5.5, sauf avec Microsoft Foundry — si bien que la démarche autrefois formulée comme « passer à Opus » s’inverse désormais : /model sonnet rétrograde vers un modèle dont le prix par token est divisé par deux lorsqu’une tâche ne nécessite pas ce niveau de raisonnement.^{181197207220221} Passez à Haiku pour les subagents. Restez sur Opus si une réponse obtenue après rétrogradation semble superficielle. Avec les équipes d’agents (v2.1.32+), Opus peut coordonner plusieurs agents travaillant en parallèle sur différentes sous-tâches.⁷⁹

Commande, skill, subagent ou équipe d’agents ?

Do you want explicit control over when it runs?
│
├── YES → Use Slash Command
│         Example: /deploy, /test, /security-review
│         You invoke it. You control timing.
│
└── NO → Should the expertise apply automatically based on context?
         │
         ├── YES → Use Skill
         │         Example: Security patterns, domain rules, code standards
         │         Claude recognizes context and applies expertise.
         │
         └── NO → Does the work need isolated context?
                  │
                  ├── YES → Is there one subtask or many parallel subtasks?
                  │         │
                  │         ├── ONE → Use Subagent (Task tool)
                  │         │         Example: Deep exploration, parallel analysis
                  │         │         Prevents context bloat in main conversation.
                  │         │
                  │         └── MANY → Use Agent Team (v2.1.32+)
                  │                   Example: 5 agents reviewing different modules simultaneously
                  │                   Opus coordinates; each agent works independently.
                  │
                  └── NO → Just prompt directly
                           Not everything needs abstraction.

Hook ou prompt ?

Must the action ALWAYS happen, regardless of Claude's judgment?
│
├── YES → Use Hook (deterministic)
│         Examples:
│         - Format code after every edit
│         - Log all bash commands
│         - Block access to .env files
│         Claude cannot skip, forget, or decide otherwise.
│
└── NO → Use Prompt (probabilistic)
         Examples:
         - "Consider adding tests"
         - "Think about edge cases"
         - "Review for security if relevant"
         Claude decides based on context.

Quand utiliser le raisonnement étendu ?

Is this a genuinely hard problem?
│
├── Architectural decision with many tradeoffs → YES, use thinking
├── Complex debugging with unclear root cause → YES, use thinking
├── Security analysis requiring careful reasoning → YES, use thinking
├── Understanding unfamiliar codebase → YES, use thinking
│
├── Routine bug fix → NO, skip thinking
├── Simple refactoring → NO, skip thinking
├── Code formatting → NO, skip thinking
└── Quick questions → NO, skip thinking

Activez-le ou désactivez-le avec Alt+T pendant la session. Les budgets de raisonnement élevés coûtent plus cher ; commencez au minimum et augmentez-les uniquement si les réponses semblent précipitées.

Raisonnement adaptatif d’Opus 4.6 : Opus 4.6 ajuste automatiquement la profondeur de son raisonnement selon la complexité du problème. Pour la plupart des tâches, il n’est pas nécessaire de contrôler explicitement le budget de raisonnement — Opus l’augmente pour les problèmes difficiles et reste rapide pour les plus simples. Le réglage manuel du raisonnement est surtout utile avec Sonnet lorsque vous souhaitez imposer une analyse plus approfondie.

Quelle surface d’exécution choisir ?

Where should this work happen?
│
├── Requires YOUR local files and tools
│   │
│   ├── Interactive, iterative work → Main REPL session
│   ├── One-shot scripted task → claude -p "prompt" (print mode)
│   ├── CI/CD automation → claude -p --json (non-interactive + structured output)
│   └── Parallel isolated tasks → Subagents via Task tool
│
├── Requires SOMEONE ELSE'S environment
│   │
│   └── Remote codebase or server → Background agent (cloud)
│
└── Doesn't require any environment
    │
    ├── Research or analysis → Subagent with Explore type
    └── Web content extraction → WebFetch / WebSearch tools

Équipes d’agents, subagents ou sessions parallèles

Do you need multiple agents working on related subtasks?
│
├── YES → Are the subtasks independent (no shared state)?
│         │
│         ├── YES → Can they share the same codebase?
│         │         │
│         │         ├── YES → Use Agent Team (v2.1.32+)
│         │         │         Opus coordinates. Agents share repo access.
│         │         │         Example: "Review auth, API, and DB modules in parallel"
│         │         │
│         │         └── NO → Use Parallel Sessions (separate terminals)
│         │                  Each has its own working directory.
│         │                  Example: "Fix repo-A and repo-B simultaneously"
│         │
│         └── NO → Use Sequential Subagents
│                  Results from one feed into the next.
│                  Example: "Explore → Plan → Implement"
│
└── NO → Use Single Subagent or Main REPL