Exécuter des appels d'outils depuis du code avec Code Mode

Fonctionnement de Code Mode

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

Quand utiliser Code Mode

• 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 s’exécuter en même temps

Limitations de Code Mode

• Reprise : vous ne pouvez reprendre une session Code Mode que dans le terminal, avec Code Mode activé
• Mode auto : le classifieur du mode auto examine le code, et non chaque appel d’outil
• Code de longue durée : sauf si le code peut s’exécuter en arrière-plan, vous attendez qu’il se termine, et il s’arrête au bout de dix minutes
• Hooks : vous pouvez voir des appels d’outils refusés lorsqu’un hook PreToolUse ne peut pas s’exécuter ou expire, et une sortie de code bloquée par un hook UserPromptSubmit
• Fonctionnalités indisponibles : vous ne pouvez pas utiliser Remote Control, Claude in Chrome ni computer use
• Déplacement de la session : vous ne pouvez pas déplacer la session vers l’application Desktop ni la transformer en session en arrière-plan, et /fork ne peut pas démarrer de copie en arrière-plan

Prérequis

• Version : Claude Code v2.1.323 ou ultérieure, sur l’un ou l’autre canal de publication. Une version plus ancienne démarre sans Code Mode, avec ou sans la raison it isn't open to your account yet
• Compte : un abonnement Claude ou un compte Console. Vous ne pouvez pas utiliser Code Mode via une passerelle, Amazon Bedrock, Claude Platform on AWS, Agent Platform de Google Cloud ou Microsoft Foundry
• Organisation : votre organisation n’utilise ni la configuration HIPAA ni la conservation zéro des données
• Modèle : Claude Opus 5.5, Sonnet 5.5, Haiku 5.5 ou Fable 5.2
• Surface : une session claude interactive dans un terminal. Code Mode ne fonctionne pas avec -p, l’Agent SDK, le panneau VS Code, l’application Desktop ni les sessions cloud
• Installation : le build natif de Claude Code
• Windows : Git for Windows est installé

Essayer Code Mode

CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude

$env:CLAUDE_CODE_EXPERIMENTAL_CODE_MODE = "1"
claude

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

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

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

Désactiver Code Mode

Bloquer Code Mode pour votre organisation

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_CODE_MODE": "0"
  }
}

Permissions et code de longue durée

Vérifications des permissions

• Mode auto : le classifieur examine chaque morceau de code avant son exécution, et non chaque appel d’outil. Il ne voit pas les valeurs calculées à l’exécution, comme un chemin tiré d’une sortie de recherche ; conservez donc des règles ou des hooks pour les appels que vous devez contrôler. Des demandes de permission peuvent toujours vous être présentées lorsqu’un nouveau code démarre alors qu’un code antérieur est en cours d’exécution
• Autres modes de permission : le code démarre sans examen, et une demande de permission vous est présentée pour chaque appel d’outil qui vous en présenterait une dans ce mode

Code de longue durée

• Attente : Claude répond une fois le code terminé, et le code s’arrête au bout de dix minutes, y compris le temps que vous passez sur les demandes de permission
• Arrière-plan : vous pouvez continuer à parler à Claude, et le code peut s’exécuter jusqu’à deux heures

• Vous êtes passé à un autre mode : appuyez sur Shift+Tab jusqu’à revenir au mode dans lequel vous avez démarré
• Vous avez démarré dans un autre mode, ou avez choisi la session dans la liste claude --resume : si le mode auto est disponible pour vous, quittez, puis exécutez claude --continue --permission-mode auto avec Code Mode activé
• Vous avez passé des noms d’outils à --tools : redémarrez en mode auto sans ce flag

Dépannage

Code Mode ne démarre pas

Demande de permission avec compte à rebours

Claude Code will automatically block this request in 1:59, to avoid holding up an unattended session

Appel d’outil refusé par un hook

• the hook failed : lors d’un appel provenant du code de Claude, votre hook n’a pas pu démarrer, a été arrêté de force, s’est terminé avec le code 126, 127 ou un code supérieur à 128, ou a renvoyé une erreur HTTP ou une sortie non valide. Corrigez le hook
• the hook did not finish : votre hook a expiré lors d’un appel provenant du code de Claude, ou lors de tout autre appel d’outil une fois que Claude a exécuté du code dans la session. Augmentez le timeout du hook

Sortie de code retenue par un hook

Ressources associées

• Modes de permission : comparer le mode auto avec les modes qui vous présentent des demandes de permission
• Référence des hooks : écrire des hooks PreToolUse et UserPromptSubmit
• Paramètres gérés : appliquer une configuration unique à l’ensemble d’une organisation