Exécution de code : Claude exécute le code qu'il écrit

La démonstration de cette vidéo a été enregistrée en septembre 2026. Elle a été réalisée avec Claude Sonnet 5 (claude-sonnet-5). Les résultats peuvent différer avec des modèles plus récents.

Certaines questions nécessitent des calculs sur de nombreux fichiers. C'est un travail pour le code.

Prenons Meridian, un cabinet de conseil en ingénierie fictif. Il dispose de 12 fichiers CSV, un pour chaque station de pompage, et chaque fichier contient un an de relevés de débit. Il souhaite savoir si une station a déjà dépassé sa capacité de conception, et si oui, quand.

L'exécution de code est la manière dont Claude accomplit ce travail. Claude dispose d'un conteneur où il peut exécuter le Python qu'il écrit et répondre à partir de ce que le code affiche.

Ajouter l'outil à votre requête

L'exécution de code est un outil serveur, un outil qui s'exécute sur l'infrastructure d'Anthropic. Vous n'écrivez aucun gestionnaire pour cet outil, et votre code ne renvoie aucun tool_result.

L'ajout de l'exécution de code nécessite une seule entrée dans votre liste tools. La date à la fin du type de l'entrée correspond à la version de l'outil, et Meridian utilise code_execution_20260120. Les versions actuelles sont répertoriées dans la référence des outils, copiez donc la valeur type depuis là.

Meridian conserve la liste dans une constante nommée TOOLS, et sa requête la transmet sous la forme tools=TOOLS :

TOOLS = [{"type": "code_execution_20260120", "name": "code_execution"}]

Depuis octobre 2026, l'exécution de code fonctionne sur Claude API, Claude Platform on AWS, les modèles Claude sur Google Cloud gérés par Anthropic, et les déploiements Microsoft Foundry hébergés sur Anthropic.

Placer vos fichiers dans le conteneur

Le code de Claude s'exécute dans un conteneur du côté d'Anthropic. Vos fichiers se trouvent toujours sur votre machine, donc le conteneur ne les possède pas encore. Le programme de Meridian les transfère dans le conteneur en deux étapes :

1. Téléversez chaque fichier avec Fichiers API, qui vous renvoie un identifiant de fichier.
2. Placez cet identifiant de fichier dans votre message, dans un bloc container_upload.

Le programme de Meridian ajoute un bloc container_upload pour chaque fichier, dans le même message que sa question. Les fichiers sont ensuite chargés sur le conteneur, où le code de Claude peut les ouvrir.

Lire la réponse de Claude

Votre code envoie une seule requête et reçoit généralement la réponse finale.

L'API peut suspendre un tour de longue durée et renvoyer un stop_reason de pause_turn. Lorsque cela se produit, renvoyez le contenu de la réponse sous la forme d'un message assistant, avec les mêmes tools, et Claude continue.

La réponse de Claude pour Meridian est que la station 7 a dépassé sa capacité de conception de 600 L/s à deux reprises, en avril et mai 2025. Dans la réponse, le résultat arrive après les commandes que Claude a exécutées.

Assembler le programme

Le programme de Meridian ci-dessous ajoute l'outil, place les fichiers dans le conteneur et lit la réponse. Dans le programme, paths contient les 12 fichiers CSV sous forme d'objets pathlib.Path, et QUESTION contient la question de Meridian.

Points clés à retenir

• L'exécution de code est un outil serveur. Vous ajoutez une entrée à tools, et le code de Claude s'exécute dans un conteneur du côté d'Anthropic.
• Vous téléversez chaque fichier avec Fichiers API, puis placez son identifiant de fichier dans un bloc container_upload.