L'Anthropic API propose deux fonctionnalités puissantes qui fonctionnent exceptionnellement bien ensemble : les Fichiers API et l'Exécution de code. Bien qu'elles puissent sembler distinctes à première vue, leur combinaison ouvre des possibilités vraiment intéressantes pour déléguer des tâches complexes à Claude.
Fichiers API
Les Fichiers API offrent un moyen alternatif de gérer les téléchargements de fichiers. Au lieu d'encoder des images ou des PDF directement dans vos messages sous forme de données base64, vous pouvez télécharger des fichiers à l'avance et les référencer ultérieurement.

Voici comment cela fonctionne :
- Téléchargez votre fichier (image, PDF, texte, etc.) vers Claude à l'aide d'un appel API distinct
- Recevez un objet de métadonnées de fichier contenant un identifiant de fichier unique
- Référencez cet identifiant de fichier dans les futurs messages au lieu d'inclure les données brutes du fichier

Cette approche est particulièrement utile lorsque vous souhaitez référencer le même fichier plusieurs fois ou lorsque vous travaillez avec des fichiers volumineux qu'il serait fastidieux d'inclure dans chaque requête.
Outil d'exécution de code
L'exécution de code est un outil côté serveur qui ne nécessite pas que vous fournissiez une implémentation. Vous incluez simplement un schéma d'outil prédéfini dans votre requête, et Claude peut éventuellement exécuter du code Python dans un conteneur Docker isolé.

Caractéristiques clés de l'environnement d'exécution de code :
- S'exécute dans un conteneur Docker isolé
- Pas d'accès réseau (impossible d'effectuer des appels API externes)
- Claude peut exécuter du code plusieurs fois au cours d'une même conversation
- Les résultats sont capturés et interprétés par Claude pour la réponse finale
Combiner les Fichiers API et l'exécution de code
La véritable puissance vient de l'utilisation combinée de ces fonctionnalités. Étant donné que les conteneurs Docker n'ont pas d'accès réseau, les Fichiers API deviennent le principal moyen de faire entrer et sortir des données de l'environnement d'exécution.

Voici un flux de travail typique :
- Téléchargez votre fichier de données (comme un CSV) à l'aide des Fichiers API
- Incluez un bloc de téléchargement vers le conteneur dans votre message avec l'identifiant de fichier
- Demandez à Claude d'analyser les données
- Claude écrit et exécute du code pour traiter votre fichier
- Claude peut générer des résultats (comme des graphiques) que vous pouvez télécharger
Exemple pratique
Examinons un exemple réel utilisant des données de service de streaming. Le fichier CSV contient des informations sur les utilisateurs, notamment les niveaux d'abonnement, les habitudes de visionnage, et s'ils ont résilié (annulé leur abonnement).

Tout d'abord, téléchargez le fichier à l'aide d'une fonction utilitaire :
file_metadata = upload('streaming.csv')Ensuite, créez un message qui inclut à la fois le fichier téléchargé et une demande d'analyse :
messages = []
add_user_message(
messages,
[
{
"type": "text",
"text": """Run a detailed analysis to determine major drivers of churn.
Your final output should include at least one detailed plot summarizing your findings."""
},
{"type": "container_upload", "file_id": file_metadata.id},
],
)
chat(
messages,
tools=[{"type": "code_execution_20250825", "name": "code_execution"}]
)Comprendre la réponse
Lorsque Claude utilise l'exécution de code, la réponse contient plusieurs types de blocs :
- Blocs de texte - L'analyse et les explications de Claude
- Blocs d'utilisation d'outils côté serveur - Le code réel que Claude a décidé d'exécuter
- Blocs de résultat d'outil d'exécution de code - La sortie de l'exécution du code

Claude peut exécuter du code plusieurs fois au cours d'une même réponse, en construisant son analyse de manière itérative. Chaque cycle d'exécution inclut le code et ses résultats.
Télécharger les fichiers générés
L'une des fonctionnalités les plus puissantes est la capacité de Claude à générer des fichiers (comme des graphiques ou des rapports) et à les rendre disponibles au téléchargement. Lorsque Claude crée une visualisation, elle est stockée dans le conteneur et vous pouvez la télécharger à l'aide des Fichiers API.
Recherchez les blocs avec type: "bash_code_execution_output" dans la réponse - ils contiennent des identifiants de fichier pour le contenu généré :
download_file("file_id_from_response")
Le résultat est une analyse complète avec des visualisations professionnelles qui auraient nécessité un codage manuel considérable pour être produites.
Au-delà de l'analyse de données
Bien que l'analyse de données soit un cas d'usage naturel, la combinaison des Fichiers API et de l'exécution de code ouvre de nombreuses possibilités :
- Traitement et manipulation d'images
- Analyse syntaxique et transformation de documents
- Calculs mathématiques et modélisation
- Génération de rapports avec mise en forme personnalisée
L'essentiel est que vous pouvez déléguer des tâches complexes et computationnelles à Claude tout en gardant le contrôle sur les entrées et les sorties grâce aux Fichiers API. Cela crée un flux de travail puissant où Claude devient votre assistant de codage, capable réellement d'exécuter et d'itérer sur des solutions.