Claude Academy
Wird geladen

Codeausführung und die Files API

Lektion 4610 Min.

Die Anthropic API bietet zwei leistungsstarke Funktionen, die außergewöhnlich gut zusammenarbeiten: die Files API und Code Execution. Auf den ersten Blick mögen sie getrennt erscheinen, aber ihre Kombination eröffnet einige wirklich interessante Möglichkeiten, um komplexe Aufgaben an Claude zu delegieren.

Files API

Die Files API bietet eine alternative Möglichkeit, Datei-Uploads zu handhaben. Anstatt Bilder oder PDFs direkt als Base64-Daten in deinen Nachrichten zu kodieren, kannst du Dateien im Voraus hochladen und später darauf verweisen.

So funktioniert es:

  • Lade deine Datei (Bild, PDF, Text usw.) mit einem separaten API-Aufruf zu Claude hoch
  • Erhalte ein Datei-Metadatenobjekt, das eine eindeutige Datei-ID enthält
  • Verweise in zukünftigen Nachrichten auf diese Datei-ID, anstatt die Rohdaten der Datei einzubinden

Dieser Ansatz ist besonders nützlich, wenn du dieselbe Datei mehrmals referenzieren möchtest oder wenn du mit größeren Dateien arbeitest, die umständlich in jede Anfrage einzubinden wären.

Code Execution Tool

Code Execution ist ein serverbasiertes Tool, für das du keine Implementierung bereitstellen musst. 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 durchführen)
  • Claude kann Code während eines einzelnen Gesprächs mehrmals ausführen
  • Ergebnisse werden erfasst und von Claude für die endgültige Antwort interpretiert

Kombination von Files API und Code Execution

Die wahre Stärke entsteht durch die gemeinsame Nutzung dieser Funktionen. Da die Docker-Container keinen Netzwerkzugriff haben, wird die Files API zum primären Weg, um Daten in die Ausführungsumgebung hinein- und herauszubekommen.

Hier ist ein typischer Arbeitsablauf:

  1. Lade deine Datendatei (wie eine CSV) mit der Files API hoch
  2. Füge einen Container-Upload-Block mit der Datei-ID in deine Nachricht 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) generieren, die du herunterladen kannst

Praktisches Beispiel

Schauen wir uns ein echtes Beispiel mit Daten eines Streaming-Dienstes an. Die CSV-Datei enthält Benutzerinformationen, einschließlich Abonnementstufen, Sehgewohnheiten und ob sie abgewandert sind (ihr Abonnement gekündigt haben).

Lade zunächst die Datei mit einer Hilfsfunktion hoch:

python
file_metadata = upload('streaming.csv')

Erstelle dann eine Nachricht, die sowohl die hochgeladene Datei als auch eine Anfrage zur Analyse 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_20250522", "name": "code_execution"}]
)

Die Antwort verstehen

Wenn Claude Code Execution verwendet, 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 zur Ausführung entschieden hat
  • Code-Execution-Tool-Result-Blöcke - Ausgabe der Codeausführung

Claude kann Code während einer einzelnen Antwort mehrmals ausführen und dabei seine Analyse iterativ aufbauen. Jeder Ausführungszyklus umfasst den Code und seine Ergebnisse.

Generierte Dateien herunterladen

Eine der leistungsstärksten Funktionen ist Claudes Fähigkeit, Dateien (wie Diagramme oder Berichte) zu generieren und zum Download verfügbar zu machen. Wenn Claude eine Visualisierung erstellt, wird sie im Container gespeichert, und du kannst sie mit der Files API herunterladen.

Achte auf Blöcke mit type: "code_execution_output" in der Antwort - diese enthalten Datei-IDs für generierte Inhalte:

python
download_file("file_id_from_response")

Das Ergebnis ist eine umfassende Analyse mit professionellen Visualisierungen, deren Erstellung erheblichen manuellen Programmieraufwand erfordert hätte.

Über die Datenanalyse hinaus

Während Datenanalyse eine naheliegende Anwendung ist, eröffnet die Kombination von Files API und Code Execution viele weitere Möglichkeiten:

  • Bildverarbeitung und -bearbeitung
  • Dokumentenanalyse und -umwandlung
  • Mathematische Berechnungen und Modellierung
  • Berichtserstellung mit individueller Formatierung

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. Dies schafft einen leistungsstarken Arbeitsablauf, bei dem Claude zu deinem Coding-Assistenten wird, der Lösungen tatsächlich ausführen und iterieren kann.