L’outil d’exécution de code est actuellement en bêta publique.Pour utiliser cette fonctionnalité, ajoutez l’en-tête bêta
"code-execution-2025-08-25" à vos demandes API.Compatibilité des modèles
L’outil d’exécution de code est disponible sur les modèles suivants :| Modèle | Version de l’outil |
|---|---|
Claude Opus 4.1 (claude-opus-4-1-20250805) | code_execution_20250825 |
Claude Opus 4 (claude-opus-4-20250514) | code_execution_20250825 |
Claude Sonnet 4.5 (claude-sonnet-4-5-20250929) | code_execution_20250825 |
Claude Sonnet 4 (claude-sonnet-4-20250514) | code_execution_20250825 |
Claude Sonnet 3.7 (claude-3-7-sonnet-20250219) (obsolète) | code_execution_20250825 |
Claude Haiku 4.5 (claude-haiku-4-5-20251001) | code_execution_20250825 |
Claude Haiku 3.5 (claude-3-5-haiku-latest) | code_execution_20250825 |
La version actuelle
code_execution_20250825 prend en charge les commandes Bash et les opérations sur les fichiers. Une version héritée code_execution_20250522 (Python uniquement) est également disponible. Consultez Mettre à jour vers la dernière version de l’outil pour les détails de migration.Les versions d’outils plus anciennes ne sont pas garanties d’être rétro-compatibles avec les modèles plus récents. Utilisez toujours la version de l’outil qui correspond à votre version de modèle.
Démarrage rapide
Voici un exemple simple qui demande à Claude d’effectuer un calcul :Fonctionnement de l’exécution de code
Lorsque vous ajoutez l’outil d’exécution de code à votre demande API :- Claude évalue si l’exécution de code aiderait à répondre à votre question
- L’outil fournit automatiquement à Claude les capacités suivantes :
- Commandes Bash : Exécuter des commandes shell pour les opérations système et la gestion des paquets
- Opérations sur les fichiers : Créer, afficher et modifier des fichiers directement, y compris l’écriture de code
- Claude peut utiliser n’importe quelle combinaison de ces capacités dans une seule demande
- Toutes les opérations s’exécutent dans un environnement sandbox sécurisé
- Claude fournit les résultats avec tous les graphiques générés, calculs ou analyses
Comment utiliser l’outil
Exécuter des commandes Bash
Demandez à Claude de vérifier les informations système et d’installer des paquets :Créer et modifier des fichiers directement
Claude peut créer, afficher et modifier des fichiers directement dans le sandbox en utilisant les capacités de manipulation de fichiers :Télécharger et analyser vos propres fichiers
Pour analyser vos propres fichiers de données (CSV, Excel, images, etc.), téléchargez-les via l’API Files et référencez-les dans votre demande :L’utilisation de l’API Files avec Code Execution nécessite deux en-têtes bêta :
"anthropic-beta": "code-execution-2025-08-25,files-api-2025-04-14"- CSV
- Excel (.xlsx, .xls)
- JSON
- XML
- Images (JPEG, PNG, GIF, WebP)
- Fichiers texte (.txt, .md, .py, etc)
Télécharger et analyser des fichiers
- Téléchargez votre fichier en utilisant l’API Files
- Référencez le fichier dans votre message en utilisant un bloc de contenu
container_upload - Incluez l’outil d’exécution de code dans votre demande API
Récupérer les fichiers générés
Lorsque Claude crée des fichiers lors de l’exécution de code, vous pouvez récupérer ces fichiers en utilisant l’API Files :Combiner les opérations
Un flux de travail complexe utilisant toutes les capacités :Définition de l’outil
L’outil d’exécution de code ne nécessite aucun paramètre supplémentaire :JSON
bash_code_execution: Exécuter des commandes shelltext_editor_code_execution: Afficher, créer et modifier des fichiers, y compris l’écriture de code
Format de réponse
L’outil d’exécution de code peut retourner deux types de résultats selon l’opération :Réponse de commande Bash
Réponses d’opération sur fichiers
Afficher le fichier :Résultats
Tous les résultats d’exécution incluent :stdout: Sortie de l’exécution réussiestderr: Messages d’erreur si l’exécution échouereturn_code: 0 pour le succès, non-zéro pour l’échec
- Afficher :
file_type,content,numLines,startLine,totalLines - Créer :
is_file_update(si le fichier existait déjà) - Modifier :
oldStart,oldLines,newStart,newLines,lines(format diff)
Erreurs
Chaque type d’outil peut retourner des erreurs spécifiques : Erreurs courantes (tous les outils) :| Outil | Code d’erreur | Description |
|---|---|---|
| Tous les outils | unavailable | L’outil est temporairement indisponible |
| Tous les outils | execution_time_exceeded | L’exécution a dépassé la limite de temps maximale |
| Tous les outils | container_expired | Le conteneur a expiré et n’est plus disponible |
| Tous les outils | invalid_tool_input | Paramètres invalides fournis à l’outil |
| Tous les outils | too_many_requests | Limite de débit dépassée pour l’utilisation de l’outil |
| text_editor | file_not_found | Le fichier n’existe pas (pour les opérations view/edit) |
| text_editor | string_not_found | Le old_str n’a pas été trouvé dans le fichier (pour str_replace) |
Raison d’arrêt pause_turn
La réponse peut inclure une raison d’arrêt pause_turn, qui indique que l’API a mis en pause un tour de longue durée. Vous pouvez fournir la réponse telle quelle dans une demande ultérieure pour permettre à Claude de continuer son tour, ou modifier le contenu si vous souhaitez interrompre la conversation.
Conteneurs
L’outil d’exécution de code s’exécute dans un environnement conteneurisé sécurisé conçu spécifiquement pour l’exécution de code, avec un accent plus élevé sur Python.Environnement d’exécution
- Version Python : 3.11.12
- Système d’exploitation : Conteneur basé sur Linux
- Architecture : x86_64 (AMD64)
Limites de ressources
- Mémoire : 5 GiB de RAM
- Espace disque : 5 GiB de stockage d’espace de travail
- CPU : 1 CPU
Réseau et sécurité
- Accès Internet : Complètement désactivé pour la sécurité
- Connexions externes : Aucune demande réseau sortante autorisée
- Isolation du sandbox : Isolation complète du système hôte et des autres conteneurs
- Accès aux fichiers : Limité au répertoire d’espace de travail uniquement
- Portée de l’espace de travail : Comme Files, les conteneurs sont limités à l’espace de travail de la clé API
- Expiration : Les conteneurs expirent 30 jours après leur création
Bibliothèques pré-installées
L’environnement Python en sandbox inclut ces bibliothèques couramment utilisées :- Science des données : pandas, numpy, scipy, scikit-learn, statsmodels
- Visualisation : matplotlib, seaborn
- Traitement de fichiers : pyarrow, openpyxl, xlsxwriter, xlrd, pillow, python-pptx, python-docx, pypdf, pdfplumber, pypdfium2, pdf2image, pdfkit, tabula-py, reportlab[pycairo], Img2pdf
- Mathématiques et informatique : sympy, mpmath
- Utilitaires : tqdm, python-dateutil, pytz, joblib, unzip, unrar, 7zip, bc, rg (ripgrep), fd, sqlite
Réutilisation de conteneurs
Vous pouvez réutiliser un conteneur existant sur plusieurs demandes API en fournissant l’ID de conteneur d’une réponse précédente. Cela vous permet de maintenir les fichiers créés entre les demandes.Exemple
Streaming
Avec le streaming activé, vous recevrez les événements d’exécution de code au fur et à mesure qu’ils se produisent :Demandes par lot
Vous pouvez inclure l’outil d’exécution de code dans l’API Messages Batches. Les appels d’outil d’exécution de code via l’API Messages Batches sont facturés de la même manière que ceux dans les demandes API Messages régulières.Utilisation et tarification
Code execution tool usage is tracked separately from token usage. Execution time has a minimum of 5 minutes. If files are included in the request, execution time is billed even if the tool is not used due to files being preloaded onto the container. Each organization receives 50 free hours of usage with the code execution tool per day. Additional usage beyond the first 50 hours is billed at $0.05 per hour, per container.Mettre à jour vers la dernière version de l’outil
En mettant à jour verscode-execution-2025-08-25, vous accédez aux capacités de manipulation de fichiers et Bash, y compris le code dans plusieurs langues. Il n’y a pas de différence de prix.
Ce qui a changé
| Composant | Hérité | Actuel |
|---|---|---|
| En-tête bêta | code-execution-2025-05-22 | code-execution-2025-08-25 |
| Type d’outil | code_execution_20250522 | code_execution_20250825 |
| Capacités | Python uniquement | Commandes Bash, opérations sur fichiers |
| Types de réponse | code_execution_result | bash_code_execution_result, text_editor_code_execution_result |
Compatibilité rétroactive
- Tout le code d’exécution Python existant continue de fonctionner exactement comme avant
- Aucune modification requise pour les flux de travail existants Python uniquement
Étapes de mise à jour
Pour mettre à jour, vous devez apporter les modifications suivantes dans vos demandes API :-
Mettez à jour l’en-tête bêta :
-
Mettez à jour le type d’outil :
-
Examinez la gestion des réponses (si vous analysez les réponses par programmation) :
- Les blocs précédents pour les réponses d’exécution Python ne seront plus envoyés
- À la place, les nouveaux types de réponse pour les opérations Bash et fichiers seront envoyés (voir la section Format de réponse)