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 :
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
claudeinteractive 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
claude --version
Si le numéro est inférieur à 2.1.323, mettez à jour :
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 :
CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude
Windows PowerShell :
$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 :
{
"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 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 :
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 :
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 :
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 :
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ée | Solution |
|---|---|
it isn't open to your account yet | Mettez à 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 API | Supprimez 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 helper | Supprimez 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 models | Démarrez avec un modèle pris en charge, par exemple claude --model opus |
it needs settings that Claude Code downloads from Anthropic | Retirez la variable qui désactive la récupération des feature flags, comme DISABLE_TELEMETRY |
your organization's settings don't allow it | Interrogez 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
1dans votre shell ou vos paramètres utilisateur, et supprimez tout0. - 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
PreToolUsea échoué ou a expiré. Corrigez le hook ou augmentez sontimeout.
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.





Écrire une réponse