Wird geladen

Codeausführung und die Files API

Lektion 4610 Min.
Wird geladen

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.

Unser Server sendet Claude Rohbilddaten und den Text „Was siehst du auf diesem Bild?“, und Claude antwortet „Ich sehe einen hohen Baum“.

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

Unser Server sendet die Datei-ID in einem Bildblock plus „Was siehst du auf diesem Bild?“, und Claude antwortet „Ich sehe einen hohen Baum“.

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.

Unser Server bittet Claude um PI auf die 50. Dezimalstelle; Claude liefert Code, das Ergebnis „3.1415926535“ und eine Textantwort.

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.

Unten aufgeführter Workflow: eine Nutzernachricht mit einem Container-Upload-Block und Text, dann Claudes Antwort aus Code, Ergebnissen und Text.

Hier ist ein typischer Workflow:

  1. Lade deine Datendatei (wie eine CSV) über die Files API hoch
  2. Füge in deiner Nachricht einen Container-Upload-Block mit der Datei-ID ein
  3. Bitte Claude, die Daten zu analysieren
  4. Claude schreibt und führt Code aus, um deine Datei zu verarbeiten
  5. 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).

Datei streaming.csv mit Spalten wie UserID, SubscriptionTier und TotalViewingHoursLastMonth sowie Zeilen ab USER_00001.

Lade zunächst die Datei mithilfe einer Hilfsfunktion hoch:

python
file_metadata = upload('streaming.csv')

Erstelle dann eine Nachricht, die sowohl die hochgeladene Datei als auch eine Analyseanfrage enthält:

python
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

Ausgegebene Antwort: ein Textblock über Kündigungstreiber, ein Server-Tool-Use-Block, dessen Code pandas importiert, dann ein Tool-Ergebnis.

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:

python
download_file("file_id_from_response")

Heruntergeladenes mehrteiliges Churn-Analyse-Diagramm: 500 Nutzer, 38,6 % Kündigungsrate, wichtigster Kündigungstreiber sind Interaktionen mit dem Kundenservice.

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.