DIRTY STATIC / DÉPÊCHE Tutoriels16 NOV. 2026 • 14 MIN DE LECTURE
Un hall de terminal en béton où de petites icônes d'outils se rejoignent en un seul flux de script, avec des bandes de danger jaunes au sol
TutorielsL'INTELLIGENCE POUR L'ÈRE DES MACHINES

Regrouper les appels d'outils avec le mode Code de Claude

Le mode Code est une option expérimentale de Claude Code où Claude écrit du JavaScript qui appelle ses outils, au lieu de demander un outil à la fois et de lire chaque résultat avant de continuer. Ce tutoriel l'active pour une seule session, lance une première tâche qui ne fait que lire et filtrer, lit le script avant de faire confiance à une modification, et couvre les limites de comptes, de modèles, de surfaces, de permissions et de temps.

Commencer la lecture ↓

Une session normale de Claude Code passe beaucoup de tours sur de petites étapes. Claude lit un fichier, attend, lance une commande, attend encore, modifie un fichier et lit aussi ce résultat. Le mode Code change la forme de ce travail. Claude écrit un morceau de JavaScript qui fait les appels d’outils, et Claude Code exécute ce code dans votre session.

Anthropic a ajouté le mode Code dans Claude Code v2.1.323 le 12 novembre 2026, et la documentation le dit expérimental et désactivé par défaut. Cette étiquette compte. La fonction peut changer ou être retirée dans toute version, la documentation ne donne aucun chiffre d’économie de jetons pour elle, et une session lancée avec elle ne peut reprendre qu’avec elle encore active. Essayez la sur un travail que vous pouvez vérifier, et non sur un travail que vous ne pouvez pas vous permettre de refaire.

Ce tutoriel suit la page officielle de documentation de Claude Code pour le mode Code, vérifiée le 16 novembre 2026. Il ne prétend pas avoir fait un essai de son côté. L’ordre est voulu. Vérifiez d’abord la version et le compte, activez le mode pour une seule session, commencez par une tâche qui ne fait que lire, et lisez le script avant de laisser un script modifier des fichiers pour vous.

Ce que vous allez construire ou apprendre

Vous allez activer le mode Code pour une session de terminal et l’utiliser de la façon que recommande Anthropic. Cela veut dire une tâche qui demande beaucoup d’appels d’outils liés, comme un changement qui se répète dans beaucoup de fichiers, une recherche dont les résultats demandent un tri avant que Claude les lise, ou plusieurs commandes qui peuvent rouler en même temps.

Vous apprendrez aussi ce qui ne change pas. Chaque appel d’outil que le code fait passe encore par vos règles de permission de refus et de demande et par vos crochets PreToolUse. Ce qui change est l’unité que vous révisez. En mode auto, le classifieur révise chaque morceau de code avant son exécution, et non chaque appel d’outil en dedans, et il ne voit pas les valeurs que le code calcule pendant qu’il roule.

Un bureau dans un espace en béton avec un écran de terminal montrant un script qui se déploie vers beaucoup de fichiers Un seul script peut contenir les appels qui prenaient avant beaucoup de tours. Illustration : Dirty Static

Avant de commencer

Travaillez dans un dépôt Git et partez d’un état que vous pouvez mesurer. Validez ou remisez votre travail en cours, lancez git status, et notez le résultat. Si un script modifie plus tard un fichier que vous n’attendiez pas, ce premier relevé est la façon de le savoir.

Connaissez les limites de temps avant qu’un long travail commence. Le code que Claude attend arrête après dix minutes, et ce temps inclut le temps passé aux demandes de permission. Le code qui peut rouler en arrière plan peut rouler jusqu’à deux heures. Le code en arrière plan demande une session lancée en mode auto ou en mode bypassPermissions, selon la documentation.

Remote Control, Claude in Chrome et l’usage de l’ordinateur ne marchent pas pendant que le mode Code est actif. Vous ne pouvez pas non plus déplacer une session en mode Code vers l’application de bureau ou la changer en session en arrière plan, et la commande de bifurcation ne peut pas en lancer une copie en arrière plan. Prévoyez une session qui reste dans le terminal où elle a commencé. Pour un contexte plus large sur le fait de garder le travail des agents borné, voyez notre guide pour empêcher Claude Code de laisser fuir des secrets vers GitHub.

Étape 1 : Vérifier la version et la surface

Action : vérifiez votre version dans un terminal, et confirmez que vous travaillerez dans une session de terminal interactive sur la version native.

Terminal

claude --version

Résultat attendu : la version est v2.1.323 ou plus récente. Si elle est plus ancienne, mettez d’abord Claude Code à jour et vérifiez encore. Une version plus ancienne démarre sans le mode Code, avec ou sans une raison qui dit qu’il n’est pas encore ouvert à votre compte. Si vous prévoyez utiliser le panneau VS Code, l’application de bureau, une session infonuagique, le SDK Agent ou le drapeau d’impression pour ce travail, arrêtez ici. Le mode Code ne démarrera pas sur ces surfaces.

Étape 2 : Activer le mode Code pour une session

Action : réglez la variable d’environnement dans votre interpréteur et lancez Claude Code. Cette forme active le mode pour ce lancement seulement, ce qui est la bonne portée pour un premier essai.

macOS, Linux and WSL

CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude

Résultat attendu : Claude Code vous demande de confirmer avant la première session en mode Code, puis redémarre avec une ligne près du haut qui dit que le mode Code est actif et que la session ne peut reprendre qu’avec le mode Code actif. Si vous voyez une ligne qui dit que le mode Code n’est pas disponible, lisez la raison sur cette même ligne et servez vous du tableau de dépannage plus bas. La commande d’état dans la session montre aussi la raison.

Étape 3 : Garder le réglage, seulement si le premier essai le mérite

Action : si vous voulez le mode Code dans chaque nouvelle session, ajoutez la variable au bloc env de votre fichier de réglages utilisateur à ~/.claude/settings.json. Ne mettez pas l’interrupteur dans un fichier de réglages de projet en attendant qu’il marche. La documentation traite ce choix comme un choix d’utilisateur, et un dépôt cloné ne devrait pas pouvoir l’activer pour vous.

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

Résultat attendu : les nouvelles sessions de terminal démarrent avec le même flux de confirmation et la même bannière. Gardez un fait en tête quand vous déboguez ce réglage. Une valeur de 0 à un endroit garde le mode Code désactivé même si un autre endroit règle 1. Cette règle permet aussi à une organisation de bloquer le mode pour tout le monde par les réglages gérés, et les réglages gérés ne peuvent pas l’activer pour les utilisateurs.

Étape 4 : Lancer une première tâche qui ne fait que lire

Action : donnez à Claude une tâche de recherche dont les résultats demandent un tri, et demandez une valeur de retour courte. Changez le mot et le dossier pour une recherche dont vous avez vraiment besoin, et gardez la tâche à la lecture et au rapport.

Claude Code session

Find every file under src that mentions retryPolicy. Return only the file paths and, for each path, the line that sets the retry limit. Do not edit any file.

Résultat attendu : Claude écrit du JavaScript qui fait les appels, lance la recherche, et renvoie la partie de la sortie qu’il doit lire. Dans la conversation, vous voyez les appels d’outils, comme un résultat de recherche ou une lecture de fichier, et non le code. Un morceau de code peut lancer des commandes en parallèle, utiliser un résultat dans l’appel suivant, et renvoyer un résultat filtré au lieu de chaque résultat brut au complet.

Des bras robots qui attendent à une barrière de permission en béton pendant que des fichiers attendent derrière des bandes de danger La barrière existe encore. Chaque appel passe encore par vos règles et vos crochets. Illustration : Dirty Static

Étape 5 : Lire le script avant de faire confiance à une modification

Action : appuyez sur Ctrl+O pour ouvrir la visionneuse de transcription. Chaque morceau de code y apparaît comme une ligne Code repliée, avec un indice sur la façon de l’ouvrir. Lisez le script au complet et vérifiez trois choses. Les fichiers qu’il touche correspondent à votre tâche. Les commandes correspondent au travail que vous avez demandé. La dernière partie du script renvoie seulement ce que Claude doit lire ensuite.

Résultat attendu : vous pouvez expliquer ce que le script fera avant qu’il fasse plus de travail. Si vous ne le pouvez pas, ne passez pas encore à une tâche de modification. Demandez à Claude le texte d’erreur ou le texte du script en forme simple, corrigez la demande, et relancez la tâche.

Étape 6 : Lancer une petite tâche de modification sur une branche

Action : passez à une branche que vous pouvez abandonner, puis donnez à Claude le genre de tâche que la documentation utilise comme exemple. La documentation montre Claude qui relève une limite de tentatives. Dans cet exemple, le script trouve le fichier qui contient la politique de tentatives, modifie la limite dans ce fichier, lance les tests de cette politique, et renvoie le chemin du fichier et la sortie des tests.

Le script dans l’exemple de la documentation prend cette forme. C’est le code que Claude pourrait écrire pour cette demande, montré pour que vous sachiez quoi chercher dans la visionneuse de transcription. Ce n’est pas une commande à coller et à exécuter seule.

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() });

Donnez la tâche dans vos propres mots, avec votre propre limite et votre propre commande de test, et surveillez les demandes de permission quand elles arrivent. Dans les modes qui demandent, vous recevez une demande pour chaque appel d’outil qui vous en ferait une dans ce mode. En mode auto, le classifieur révise d’abord le code, donc gardez des règles de refus ou des crochets pour les appels que vous devez contrôler, car le classifieur ne voit pas les valeurs calculées pendant que le code roule.

Résultat attendu : la conversation montre les appels d’outils que le script a faits, comme la différence de la modification, et le script renvoie le chemin modifié et la sortie des tests. Le code lui-même reste dans la visionneuse de transcription, et non dans la conversation principale.

Étape 7 : Désactiver le mode Code et noter la règle de reprise

Action : pour désactiver le mode, retirez CLAUDE_CODE_EXPERIMENTAL_CODE_MODE de votre interpréteur et de ~/.claude/settings.json, puis lancez une nouvelle session. Vous pouvez aussi garder la variable et changer sa valeur à 0 à l’un ou l’autre endroit.

Résultat attendu : les nouvelles sessions démarrent sans le mode Code. Une session en mode Code peut reprendre seulement dans le terminal, avec le mode Code actif. Si vous essayez de la reprendre avec le mode désactivé, lancez plutôt une session fraîche et portez la tâche dans votre demande, avec la différence et les résultats de tests du travail fait jusque là.

Vérification

Vérifiez quatre choses et notez les résultats. La bannière au début de la session disait que le mode Code était actif. La première tâche n’a changé aucun fichier, ce que git status confirme selon le relevé pris avant le début. La visionneuse de transcription contenait le script comme une ligne Code, et vous l’avez lu avant que la tâche de modification roule. La tâche de modification a renvoyé le chemin qu’elle a changé et la sortie de tests qu’elle a annoncée, et la différence et un nouvel essai des tests sont d’accord avec ce retour.

Terminez par la différence. Lancez git diff et nommez chaque fichier qu’elle liste selon la tâche que vous avez donnée. Un résumé propre de Claude n’est pas une preuve. La différence, la sortie d’état et les tests sont la preuve que vous pouvez vérifier vous-même.

Dépannage

ProblèmeCause probableCorrection
Le mode Code ne démarre pas et la raison dit qu’il n’est pas encore ouvert à votre compteLa version est plus ancienne que v2.1.323, ou le compte n’a pas encore été ouvert à la fonctionMettez Claude Code à jour, vérifiez votre connexion réseau, et relancez. Si la raison reste, essayez encore un autre jour
La raison dit qu’il marche seulement avec l’API AnthropicLes réglages routent les demandes par un fournisseur infonuagique, une passerelle ou une URL de base sur mesureRetirez ces réglages de routage, puis connectez vous avec un abonnement Claude ou un compte Console et relancez
La raison parle d’un aide de clé APIUn aide de clé API, un jeton d’authentification ou un en tête d’authentification sur mesure est régléRetirez l’aide et les réglages nommés, puis connectez vous ou réglez votre clé API de la façon que nomme la documentation, et relancez
La raison dit qu’il marche seulement avec les modèles pris en chargeLa session a démarré sur un modèle hors de la liste prise en chargeLancez avec un modèle pris en charge, par exemple avec le drapeau de modèle réglé à opus. Haiku 5.5 et Fable 5.2 marchent aussi
La raison parle de télémétrie ou de réglages de fonctionsLa télémétrie est désactivée, l’export OpenTelemetry est actif, ou les équipes d’agents sont activesDésactivez les variables que la raison nomme, si vous pouvez travailler sans ces fonctions, et lancez une nouvelle session
Un appel d’outil est refusé par un crochetUn crochet PreToolUse a échoué, a dépassé son délai ou n’a donné aucune décision sur un appel venu du codeDemandez à Claude le texte d’erreur, corrigez le crochet, ou relevez son délai. Pour laisser les appels passer quand un crochet échoue, réglez onFailure à continue sur ce crochet
La sortie du code est bloquée là où vous attendiez un résultatUn crochet UserPromptSubmit a bloqué la sortie du code qui roule en arrière planChangez le crochet pour qu’il ne bloque pas quand la source dans son entrée est poll_event
Une demande montre un compte à rebours en mode autoDu code nouveau a commencé pendant que du code plus ancien roulait encore, donc le code plus ancien a perdu sa révision par le classifieurRépondez avant la fin du compte à rebours. Sans réponse, cet appel est refusé, et les appels plus tard qui montreraient un compte à rebours sont refusés sans demande
Une session ne reprend pasVous essayez de reprendre une session en mode Code sans le mode Code, ou hors d’un terminalLancez dans un terminal avec le mode Code actif, ou lancez une session fraîche et portez la tâche

Prochaines étapes

Servez vous du mode Code là où la forme convient et sautez le là où elle ne convient pas. Un changement qui se répète dans beaucoup de fichiers, une recherche qui demande un tri, et un ensemble de commandes qui peuvent rouler en même temps sont les tâches que nomme Anthropic. Une tâche avec un ou deux appels gagne peu, et une tâche que vous devez surveiller appel par appel vaut mieux en mode normal.

Ignorez le chiffre d’économie de jetons que vous verrez partagé pour cette fonction jusqu’à ce qu’Anthropic en publie un pour le mode Code lui-même. La documentation du mode Code ne donne aucun tel chiffre. Le chiffre en large circulation vient d’un article d’Anthropic de 2025 sur une fonction d’API liée, et un chiffre pour une surface n’est pas une promesse pour une autre. Mesurez vos propres sessions sur vos propres tâches, et gardez le mode seulement si le travail reste facile à lire, facile à vérifier et facile à annuler.

Sources

  • Anthropic, documentation Claude Code, Run tool calls from code with Code Mode, code.claude.com/docs/en/code-mode, vérifiée le 16 novembre 2026. La source pour le fonctionnement du mode Code, la forme du script d’exemple, les exigences, les étapes d’activation et de désactivation, les règles de permission, les limites de temps et les raisons de dépannage.
  • Anthropic, journal des changements de Claude Code, version 2.1.323, 12 novembre 2026, par code.claude.com. La source pour la date de sortie et la description du mode Code comme une option expérimentale où Claude écrit du JavaScript pour appeler ses outils.
  • Anthropic, Introducing advanced tool use on the Claude Developer Platform, 24 novembre 2025, anthropic.com. Contexte seulement, pour le travail d’API lié sur l’appel d’outils depuis du code. Ce tutoriel n’utilise pas ses chiffres de jetons comme des chiffres pour le mode Code dans Claude Code.
  • Crédit d’image : toutes les images de cet article sont des illustrations de Dirty Static.
■

FIN DE LA TRANSMISSION

Restez curieux. Remettez tout en question.

CONTINUEZ LA DESCENTE

PLUS DE DIRTY STATIC ↘