Comment activer le Code Mode dans Claude Code (et quand il vaut le coup)

Le nouveau Code Mode expérimental de Claude Code permet à Claude d’écrire du JavaScript qui exécute de nombreux appels d’outils en une seule étape. Voici comment l’activer, le tester et le désactiver.

Graphic of a terminal with one code block branching into several tool icons, for a guide to Code Mode in Claude Code

Normalement, Claude Code demande chaque appel d’outil directement et lit le résultat avant de décider de la suite. Le Code Mode, ajouté dans la version 2.1.323 le 12 novembre 2026, permet à Claude d’écrire un court morceau de JavaScript qui effectue plusieurs appels d’outils en une seule étape. Ce guide vous montre comment l’activer, l’essayer sur une vraie tâche, lire le code écrit par Claude, puis le désactiver.

Au 15 novembre 2026, le Code Mode est expérimental et désactivé par défaut. La documentation d’Anthropic précise qu’il peut changer ou disparaître à n’importe quelle version.

Ce que fait le Code Mode

Dans une session normale, Claude demande des outils comme Bash, Read ou Edit directement et lit chaque résultat avant l’étape suivante. Dans une session en Code Mode, vous tapez toujours votre prompt en langage courant, mais Claude écrit du JavaScript pour l’exécuter. Un seul morceau de code peut lancer des commandes en parallèle, transmettre un résultat à l’appel suivant et ne renvoyer que la partie de la sortie que Claude doit lire.

La documentation du Code Mode d’Anthropic donne cet exemple de ce que Claude pourrait écrire si on lui demande d’augmenter une limite de tentatives. Le code trouve le fichier, le modifie et lance les tests :

Code
const files = await $`rg -l "function retryPolicy" src`.text();
const target = files.trim().split("\n")[0];
await edit(target, "maxAttempts: 3", "maxAttempts: 5");
({ edited: target, tests: $`npm test -- retryPolicy`.nothrow() });

Vous n’écrivez pas ce code, et par défaut vous ne le voyez pas. La conversation affiche les appels d’outils, comme le diff de la modification.

La documentation suggère de l’essayer sur des tâches qui demandent de nombreux appels d’outils liés :

  • une modification qui se répète dans de nombreux fichiers ;
  • une recherche dont les résultats doivent être filtrés avant que Claude ne les lise ;
  • plusieurs commandes indépendantes qui peuvent tourner en même temps.

Lisez d’abord les limites

Le Code Mode implique de vrais compromis. Vérifiez qu’ils vous conviennent avant de l’activer :

  • Reprise : une session en Code Mode ne peut être reprise que dans le terminal, avec le Code Mode activé.
  • Code de longue durée : sauf si le code peut tourner en arrière-plan (voir l’étape 6), vous l’attendez, et il s’arrête au bout de dix minutes.
  • Fonctions manquantes : Remote Control, Claude in Chrome et computer use ne fonctionnent pas dans une session en Code Mode, et vous ne pouvez pas transférer la session vers l’app de bureau.

Ce qu’il vous faut

  • Claude Code v2.1.323 ou plus récent, installé avec la version native.
  • Un abonnement Claude ou un compte Claude Console. Le Code Mode ne fonctionne pas via une passerelle, Amazon Bedrock, Claude Platform on AWS, l’Agent Platform de Google Cloud ou Microsoft Foundry.
  • L’un de ces modèles : Claude Opus 5.5, Sonnet 5.5, Haiku 5.5 ou Fable 5.2.
  • Une session claude interactive dans un terminal. Cela ne fonctionne pas avec -p, l’Agent SDK, le panneau VS Code, l’app de bureau ni les sessions cloud.
  • Sous Windows, Git for Windows installé.
  • Une organisation qui n’utilise ni la configuration HIPAA ni la conservation zéro des données.

Étape 1 : vérifiez votre version

Code
claude --version

Si le numéro est inférieur à 2.1.323, mettez à jour :

Code
claude update

Si vous êtes sur le canal de publication stable et que la mise à jour n’atteint pas encore 2.1.323, la documentation conseille d’attendre que stable rattrape son retard ou de passer à latest.

Étape 2 : lancez Claude Code avec le Code Mode activé

Le Code Mode est contrôlé par une seule variable d’environnement, CLAUDE_CODE_EXPERIMENTAL_CODE_MODE. Pour l’essayer une fois, définissez la variable pour un seul lancement.

macOS, Linux ou WSL :

Code
CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude

Windows PowerShell :

Code
$env:CLAUDE_CODE_EXPERIMENTAL_CODE_MODE = "1"
claude

Pour l’activer dans chaque nouvelle session, ajoutez un bloc env à votre fichier de paramètres utilisateur ~/.claude/settings.json :

Code
{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_CODE_MODE": "1"
  }
}

Claude Code ignore cette variable dans les fichiers de paramètres d’un projet : un dépôt que vous clonez ne peut donc pas activer le Code Mode à votre place.

Étape 3 : confirmez la demande

Avant votre première session en Code Mode, Claude Code vous demande de confirmer. Choisissez Yes, turn on Code Mode (Oui, activer le Code Mode). Claude Code redémarre et affiche cette ligne en haut de la session :

Code
Code Mode (experimental) is on · this session can be resumed only with Code Mode on

Si vous voyez une autre ligne, ou aucune, passez directement à la section sur les erreurs plus bas.

Étape 4 : confiez à Claude une tâche avec de nombreux appels d’outils

Dans un projet que vous connaissez bien, essayez le prompt de la documentation :

Code
Read every Markdown file in this project and list the links that point to local files that don't exist.

Un autre prompt qui correspond à ce schéma :

Code
Run the linter, the type checker and the unit tests at the same time, then summarize only the failures.

Résultat attendu : Claude répond comme d’habitude, et vous voyez les appels d’outils qu’il a effectués.

Étape 5 : lisez le code écrit par Claude

Appuyez sur Ctrl+O pour ouvrir le lecteur de transcription. Chaque morceau de code apparaît sous la forme d’une ligne Code repliée. Dépliez-en une pour voir le JavaScript derrière les appels d’outils, puis appuyez de nouveau sur Ctrl+O pour revenir à la conversation.

Étape 6 : gérez les autorisations et les longues tâches

Vos paramètres de sécurité existants s’appliquent toujours. Chaque appel d’outil effectué par le code passe par vos règles d’autorisation deny et ask et par vos hooks PreToolUse, et vous n’avez besoin de modifier aucune règle pour un outil comme Bash.

Ce qui change, c’est la façon dont le code est vérifié :

  • En mode auto, un classifieur examine chaque morceau de code avant son exécution, et non chaque appel d’outil. Il ne voit pas les valeurs calculées pendant l’exécution, comme un chemin tiré des résultats d’une recherche. Gardez des règles ou des hooks pour tout ce que vous devez contrôler.
  • Dans les autres modes d’autorisation, le code démarre sans vérification, et vous recevez une demande pour chaque appel d’outil qui en déclencherait une normalement.

Pour les longues compilations ou séries de tests, Claude attend le code, qui s’arrête au bout de dix minutes, ou le laisse continuer en arrière-plan, où il peut tourner jusqu’à deux heures pendant que vous continuez à discuter. Le code en arrière-plan nécessite une session lancée en mode auto ou en mode bypassPermissions. Si le mode auto vous est accessible, la documentation indique cette façon de redémarrer dans ce mode :

Code
CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude --continue --permission-mode auto

Pour vérifier le code vous-même avec votre propre script, écrivez un hook PreToolUse qui cible REPL, l’outil qui exécute le code de Claude, et lisez le JavaScript dans tool_input.code.

Étape 7 : reprenez la session ou désactivez-le

Pour revenir plus tard à une session en Code Mode, gardez la variable définie lors de la reprise :

Code
CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude --continue

Avec le Code Mode désactivé, Claude Code refuse de reprendre cette session. Les sessions lancées sans Code Mode reprennent sans lui, même si la variable est définie.

Pour désactiver le Code Mode, supprimez CLAUDE_CODE_EXPERIMENTAL_CODE_MODE de votre shell et de ~/.claude/settings.json, puis lancez une nouvelle session. Vous pouvez aussi mettre sa valeur à 0. Un 0 à un endroit maintient le Code Mode désactivé même si l’autre endroit indique 1.

Les administrateurs peuvent le bloquer pour toute une organisation en plaçant le même bloc env, avec la valeur "0", dans les paramètres gérés (managed settings). Les paramètres gérés peuvent seulement bloquer le Code Mode. Ils ne peuvent pas l’activer pour les utilisateurs.

Erreurs courantes et solutions

Si la session démarre avec Code Mode (experimental) isn't available, la raison figure sur la même ligne, et /status l’affiche aussi. Corrigez la cause et lancez une nouvelle session. Le tableau couvre plusieurs raisons ; la documentation liste les autres.

Raison affichéeSolution
it isn't open to your account yetMettez à jour si vous êtes en dessous de v2.1.323. Sinon, vérifiez votre réseau et recommencez. Si le problème persiste, réessayez un autre jour
it only works with the Anthropic APISupprimez les paramètres qui font passer les requêtes par un fournisseur cloud, une passerelle ou une ANTHROPIC_BASE_URL personnalisée
it doesn't work with an API key helperSupprimez apiKeyHelper, ANTHROPIC_AUTH_TOKEN et tout en-tête Authorization ou X-Api-Key dans ANTHROPIC_CUSTOM_HEADERS, puis connectez-vous ou définissez ANTHROPIC_API_KEY
it only works with Opus 5.5, Sonnet 5.5 and later modelsDémarrez avec un modèle pris en charge, par exemple claude --model opus
it needs settings that Claude Code downloads from AnthropicRetirez la variable qui désactive la récupération des feature flags, comme DISABLE_TELEMETRY
your organization's settings don't allow itInterrogez votre administrateur sur le paramètre géré

Autres problèmes :

  • Aucune ligne sur le Code Mode : vérifiez la version, assurez-vous que la variable vaut 1 dans votre shell ou vos paramètres utilisateur, et supprimez tout 0.
  • Une demande d’autorisation avec compte à rebours : en mode auto, quand Claude lance du nouveau code alors qu’un code précédent tourne encore, on peut vous interroger sur les appels restants de ce code précédent. Répondez avant la fin du compte à rebours, sinon cet appel est refusé.
  • Claude signale un appel d’outil refusé : un hook PreToolUse a échoué ou a expiré. Corrigez le hook ou augmentez son timeout.

En résumé

Le Code Mode vaut la peine d’être essayé si vos sessions comportent beaucoup de recherches, de modifications et de tests répétés. Activez-le pour une session avec la variable d’environnement, confiez-lui une tâche en plusieurs étapes et lisez le code avec Ctrl+O. Attendez-vous à des changements tant qu’il reste expérimental.

Si vous enrichissez votre configuration Claude Code, nos guides sur les agent skills dans Claude Code et sur la façon de donner un vrai navigateur à votre agent avec Chrome DevTools MCP sont de bonnes lectures pour la suite.

Sources

Liens vérifiés pour la dernière fois le 15 novembre 2026.

Écrit par Mindloop Editorial

The Mindloop Experience editorial team writes clear, carefully sourced explainers and how-tos on tech, science, money and culture, for anyone who likes to know how things actually work.

À propos de Mindloop Experience

Réponses

Écrire une réponse

Plus d’articles de Mindloop Experience

Tout voir de Mindloop Experience

Vous pouvez applaudir jusqu’à 50 fois.