Die Anthropic API bietet zwei leistungsstarke Funktionen, die außergewöhnlich gut zusammenarbeiten: die Files API und Code Execution. Auch wenn sie auf den ersten Blick getrennt erscheinen mögen, eröffnet ihre Kombination wirklich interessante Möglichkeiten, um komplexe Aufgaben an Claude zu delegieren.
Files API
Die Files API bietet eine alternative Möglichkeit, mit Datei-Uploads umzugehen. Anstatt Bilder oder PDFs direkt als Base64-Daten in deinen Nachrichten zu kodieren, kannst du Dateien im Voraus hochladen und später auf sie verweisen.

So funktioniert es:
- Lade deine Datei (Bild, PDF, Text usw.) über einen separaten API-Aufruf zu Claude hoch
- Erhalte ein Datei-Metadatenobjekt mit einer eindeutigen Datei-ID
- Verweise in zukünftigen Nachrichten auf diese Datei-ID, anstatt die Rohdaten der Datei jedes Mal einzufügen

Dieser Ansatz ist besonders nützlich, wenn du dieselbe Datei mehrfach referenzieren möchtest oder wenn du mit größeren Dateien arbeitest, die umständlich in jede Anfrage einzufügen wären.
Code Execution Tool
Code Execution ist ein serverbasiertes Tool, das keine eigene Implementierung erfordert. Du fügst einfach ein vordefiniertes Tool-Schema in deine Anfrage ein, und Claude kann optional Python-Code in einem isolierten Docker-Container ausführen.

Wichtige Merkmale der Code-Execution-Umgebung:
- Läuft in einem isolierten Docker-Container
- Kein Netzwerkzugriff (kann keine externen API-Aufrufe tätigen)
- Claude kann Code während eines einzelnen Gesprächs mehrfach ausführen
- Ergebnisse werden erfasst und von Claude für die finale Antwort interpretiert
Kombination von Files API und Code Execution
Die eigentliche Stärke entsteht, wenn diese Funktionen zusammen genutzt werden. Da die Docker-Container keinen Netzwerkzugriff haben, wird die Files API zum primären Weg, um Daten in die Ausführungsumgebung hinein- und wieder herauszubekommen.

Hier ist ein typischer Workflow:
- Lade deine Datendatei (wie eine CSV) über die Files API hoch
- Füge in deiner Nachricht einen Container-Upload-Block mit der Datei-ID ein
- Bitte Claude, die Daten zu analysieren
- Claude schreibt und führt Code aus, um deine Datei zu verarbeiten
- Claude kann Ausgaben (wie Diagramme) erzeugen, die du herunterladen kannst
Praktisches Beispiel
Schauen wir uns ein reales Beispiel mit Daten eines Streaming-Dienstes an. Die CSV-Datei enthält Nutzerinformationen, darunter Abonnementstufen, Seh-Gewohnheiten und ob sie gekündigt haben (ihr Abonnement abgebrochen haben).

Lade zunächst die Datei mithilfe einer Hilfsfunktion hoch:
file_metadata = upload('streaming.csv')Erstelle dann eine Nachricht, die sowohl die hochgeladene Datei als auch eine Analyseanfrage enthält:
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"}]
)Die Antwort verstehen
Wenn Claude Code Execution nutzt, enthält die Antwort mehrere Arten von Blöcken:
- Textblöcke – Claudes Analyse und Erklärungen
- Server-Tool-Use-Blöcke – der tatsächliche Code, den Claude ausgeführt hat
- Code-Execution-Tool-Result-Blöcke – Ausgabe der Codeausführung

Claude kann Code während einer einzigen Antwort mehrfach ausführen und seine Analyse dabei iterativ aufbauen. Jeder Ausführungszyklus umfasst den Code und dessen Ergebnisse.
Herunterladen generierter Dateien
Eine der leistungsstärksten Funktionen ist Claudes Fähigkeit, Dateien (wie Diagramme oder Berichte) zu erzeugen und zum Download bereitzustellen. Wenn Claude eine Visualisierung erstellt, wird sie im Container gespeichert, und du kannst sie über die Files API herunterladen.
Achte in der Antwort auf Blöcke mit type: "bash_code_execution_output" – diese enthalten Datei-IDs für generierte Inhalte:
download_file("file_id_from_response")
Das Ergebnis ist eine umfassende Analyse mit professionellen Visualisierungen, die manuell erheblichen Programmieraufwand erfordert hätte.
Jenseits von Datenanalyse
Während Datenanalyse eine naheliegende Anwendung ist, eröffnet die Kombination aus Files API und Code Execution viele weitere Möglichkeiten:
- Bildverarbeitung und -bearbeitung
- Dokumentenanalyse und -umwandlung
- Mathematische Berechnungen und Modellierung
- Berichtserstellung mit individuellem Format
Der Schlüssel liegt darin, dass du komplexe, rechenintensive Aufgaben an Claude delegieren kannst, während du über die Files API die Kontrolle über Eingaben und Ausgaben behältst. Dadurch entsteht ein leistungsstarker Workflow, bei dem Claude zu deinem Coding-Assistenten wird, der Lösungen tatsächlich ausführen und iterativ verbessern kann.