Claude Code Code Mode : Claude écrit du JavaScript pour enchaîner ses outils, comment l'essayer et le désactiver

Le Code Mode de Claude Code laisse Claude écrire du JavaScript qui enchaîne ses outils. Voici comment l'activer avec la variable d'environnement, le couper, et quand il vaut le coup d'être testé.

Le Code Mode est un mode expérimental de Claude Code, apparu avec la version 2.1.323 (12 novembre 2026), où Claude écrit un morceau de JavaScript qui enchaîne plusieurs appels d'outils, au lieu d'en demander un seul à la fois. Il est désactivé par défaut. On l'active avec la variable CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 et on le coupe en la retirant ou en la mettant à 0.

En bref :

  • Le Code Mode est expérimental et arrive avec Claude Code 2.1.323 (12 novembre 2026), désactivé par défaut.
  • Claude écrit du JavaScript qui appelle plusieurs outils d'un coup, puis ne lui renvoie que la partie utile des résultats.
  • Activation : variable CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1, confirmation au premier lancement, puis redémarrage automatique de Claude Code.
  • Désactivation : retirer la variable du shell et de ~/.claude/settings.json, ou la mettre à 0.
  • Aucun gain de vitesse ou de coût n'est chiffré dans les sources : à tester sur un projet sans enjeu.

Qu'est-ce que le Code Mode de Claude Code ?

Le Code Mode est un mode où Claude Code laisse le modèle écrire un script JavaScript qui appelle plusieurs outils (Bash, Read, Edit) à la suite, puis exécute ce script dans la session. En mode normal, Claude demande un outil, lit le résultat, puis décide du suivant. Selon la documentation officielle de Claude Code, la fonction peut changer ou disparaître dans n'importe quelle version.

CritèreMode classiqueCode Mode
Appels d'outilsUn par tour, avec lecture du résultat avant la suitePlusieurs enchaînés dans un seul script
Ce que Claude relitChaque résultat en entierSeulement la partie utile que le script lui renvoie
Dans la conversationLes appels d'outilsLes appels d'outils (le code est replié, visible avec Ctrl+O)
StatutMode par défautExpérimental, désactivé par défaut

La documentation cite trois situations où ça sert : un changement répété sur de nombreux fichiers, une recherche dont il faut filtrer les résultats avant que Claude les lise, plusieurs commandes indépendantes à lancer en même temps. Elle ne publie aucun chiffre de gain. Méfie-toi des pourcentages qui circulent : d'après un article tiers, le chiffre de 37 % très repris vient d'une autre fonction de l'API (l'appel programmatique d'outils), pas du Code Mode de Claude Code, et les tests indépendants reposent sur une ou quelques exécutions, dont au moins une plus lente avec le mode activé. À traiter comme des anecdotes, pas comme une mesure.

Pourquoi enchaîner les outils en JavaScript change-t-il quelque chose ?

Parce que les résultats intermédiaires ne repassent plus tous par le modèle. Le script peut lancer des appels en parallèle, réutiliser un résultat dans l'appel suivant et ne remonter à Claude que ce qui compte. Pour une tâche répétitive, ça évite une longue suite de tours.

Prends un exemple : renommer et réorganiser les livrables d'un dossier client. En mode classique, Claude liste le dossier, ouvre un fichier, décide du nouveau nom, renomme, puis recommence pour le fichier suivant. En Code Mode, il peut écrire une boucle qui parcourt tous les fichiers et ne lui renvoie que la liste des changements faits. Sur une tâche de ce type, c'est la forme de script qui change ce qui repasse dans le contexte.

Il y a une limite à garder en tête : un script écrit par le modèle peut aussi se tromper, et plus vite. Les sources ne donnent ni mesure de fiabilité, ni économie de tokens, ni gain de temps. Le bénéfice dépend de la tâche, et personne chez Ottho ne l'a mesuré.

Comment activer le Code Mode avec CLAUDE_CODE_EXPERIMENTAL_CODE_MODE ?

On le met en route avec la variable d'environnement CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1, posée avant de lancer claude, puis on confirme au premier démarrage. Il faut Claude Code 2.1.323 ou plus, et plusieurs conditions décrites plus bas.

  1. Vérifie ta version avec claude --version, puis mets à jour avec claude update si elle est inférieure à 2.1.323.
  2. Pour essayer dans une seule session, pose la variable dans le shell (macOS ou Linux) :
export CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1
claude
  1. Pour l'activer sur toutes les nouvelles sessions, ajoute-la à la section env de ~/.claude/settings.json.
  2. Au premier lancement, Claude Code demande une confirmation (« Yes, turn on Code Mode »), redémarre, puis affiche « Code Mode (experimental) is on ».
  3. Donne une première tâche simple sur un projet de test, par exemple renommer en lot des fichiers d'un dossier d'essai.

Deux précisions de la documentation. D'abord, Claude Code ignore cette variable dans les réglages d'un projet : un dépôt cloné ne peut pas l'activer à ta place. Ensuite, le mode a des prérequis : abonnement Claude ou compte Console (pas via passerelle, Amazon Bedrock, Google Cloud ou Microsoft Foundry), session interactive dans un terminal, et l'un des modèles Opus 5.5, Sonnet 5.5, Haiku 5.5 ou Fable 5.2. Il ne marche pas dans l'extension VS Code, l'application Desktop ni les sessions cloud. Si le mode ne démarre pas, /status affiche la raison.

Comment désactiver le Code Mode ou revenir au mode normal ?

Retire la variable CLAUDE_CODE_EXPERIMENTAL_CODE_MODE du shell et de ~/.claude/settings.json, ou mets-la à 0, puis relance Claude Code. Un 0 posé à un endroit l'emporte sur un 1 posé à l'autre, ce qui sert si tu veux couper le mode sans toucher au reste.

Selon où tu l'avais posée :

  • Variable posée pour la session seulement : unset CLAUDE_CODE_EXPERIMENTAL_CODE_MODE, ou ferme le terminal.
  • Variable écrite dans ton profil shell : supprime la ligne, puis recharge le profil ou ouvre un nouveau terminal.
  • Variable dans les réglages de Claude Code : supprime l'entrée de la section env de ~/.claude/settings.json, ou mets-la à 0.

Pour vérifier, regarde si le message « Code Mode (experimental) is on » apparaît encore au lancement. Si le comportement te semble étrange, ouvre un terminal propre, relance la même tâche sans la variable et compare. Pour une équipe, un administrateur peut bloquer la fonction en mettant la variable à 0 dans les réglages gérés ; l'inverse est impossible, ces réglages ne peuvent pas l'activer pour les utilisateurs.

Dans quels cas le Code Mode vaut-il la peine d'être testé ?

Quand une tâche demande beaucoup d'appels d'outils répétitifs avec peu de jugement entre chaque étape. Dans ce cas, un script évite une longue suite de tours. Si au contraire chaque résultat change la suite, le mode classique reste plus adapté.

Trois situations plausibles côté entrepreneur non développeur :

  • réorganiser et renommer un dossier de livrables client ;
  • extraire la même information de dizaines de fichiers d'un projet ;
  • faire un audit en lot d'un projet existant (liste de pages, vérifications répétées).

Deux cas où rester en mode classique : une tâche exploratoire où tu veux décider après chaque résultat, et du code sensible où tu veux relire chaque action avant la suivante. Côté permissions, chaque appel d'outil passe par tes règles deny et ask et tes hooks. En mode auto, le classifieur relit le code avant exécution, mais il ne voit pas les valeurs calculées à l'exécution, par exemple un chemin tiré d'un résultat de recherche : garde des règles pour les appels à contrôler. Pour examiner le code lui-même, un hook PreToolUse sur l'outil REPL le lit dans tool_input.code. Rappel : la fonction est expérimentale, à essayer d'abord dans un projet de test versionné avec git, jamais sur de la production. Si tu débutes avec l'outil, le point d'entrée est la page installer et configurer Claude Code ; pour tout ce qui concerne la mise en route, voir aussi configurer Claude au quotidien.

Quelques limites pratiques à connaître : une session en Code Mode ne se reprend que dans un terminal où la variable est à 1, Remote Control, Claude in Chrome et computer use ne sont pas disponibles, le code au premier plan s'arrête au bout de dix minutes et le code en arrière-plan peut durer jusqu'à deux heures. Le détail des autres versions de Claude Code se retrouve dans les notes publiées sur le changelog officiel de Claude Code.

Questions fréquentes

Faut-il savoir programmer en JavaScript pour utiliser le Code Mode ?

Non. Le JavaScript est écrit et exécuté par Claude, pas par toi : tu continues à décrire ton besoin en français. Il reste utile de pouvoir relire ce que le script fait si la tâche touche à des fichiers importants.

Le Code Mode est-il disponible sur toutes les versions de Claude Code ?

Il a été introduit avec la version 2.1.323 et reste étiqueté expérimental. Si ta version est plus ancienne, mets à jour Claude Code puis vérifie avec claude --version avant de poser la variable.

Comment savoir si le Code Mode est bien actif dans ma session ?

Au lancement, Claude Code affiche « Code Mode (experimental) is on ». Tu peux aussi vérifier que la variable est présente dans le terminal (echo $CLAUDE_CODE_EXPERIMENTAL_CODE_MODE sous macOS ou Linux) et utiliser /status si le mode ne démarre pas.

Le Code Mode peut-il casser mon projet ?

Il utilise les mêmes outils et les mêmes règles de permission que le mode classique, mais enchaîne les actions plus vite. Travaille dans un dépôt versionné avec git, garde tes règles deny et ask, et teste d'abord sur une copie.

Que faire si le Code Mode donne de moins bons résultats que le mode normal ?

Retire la variable CLAUDE_CODE_EXPERIMENTAL_CODE_MODE, relance Claude Code et refais la même tâche. La fonction étant expérimentale, le résultat peut varier selon la tâche ; le mode classique reste la référence stable.

Et maintenant : mesurer si ça te fait gagner du temps

Une fois le mode essayé, la seule vraie question est de savoir s'il t'apporte quelque chose sur tes tâches. Relance la même tâche répétitive dans les deux modes, puis compare la durée et le nombre de messages échangés. Si le résultat est identique et que le Code Mode n'est pas plus rapide, rien ne t'oblige à le garder. Pour suivre les évolutions, consulte le site d'Anthropic et les notes de version de Claude Code.

Pour aller plus loin que l'essai d'une fonction, tu peux voir comment créer une application avec Claude Code, ou lire le guide pour apprendre Claude de zéro. Et si tu veux passer d'un test isolé à un produit complet, construire ton produit IA en cinq semaines avec un accompagnement structuré est l'étape logique.

Pilier 7 · Mastery

Créer une application avec Claude Code (sans être développeur)

De l'idée au MVP fonctionnel en quelques jours grâce à Claude Code. Le sujet le plus puissant pour les futurs Builders.

Découvrir le pilier complet →