Codeausführung: Claude führt den Code aus, den es schreibt

Die Demo in diesem Video wurde im September 2026 aufgezeichnet. Sie lief auf Claude Sonnet 5 (claude-sonnet-5). Die Ergebnisse können bei neueren Modellen abweichen.

Manche Fragen erfordern Berechnungen über viele Dateien hinweg. Das ist eine Aufgabe für Code.

Nimm Meridian, eine fiktive Ingenieurberatung. Sie hat 12 CSV-Dateien, eine für jede Pumpstation, und jede Datei enthält ein Jahr an Durchflussmesswerten. Sie möchte wissen, ob irgendeine Station jemals ihre Auslegungskapazität überschritten hat, und wenn ja, wann.

Codeausführung ist die Art und Weise, wie Claude diese Aufgabe erledigt. Claude erhält einen Container, in dem es den Python-Code ausführen kann, den es schreibt, und anhand dessen antworten kann, was der Code ausgibt.

Füge das Tool zu deiner Anfrage hinzu

Codeausführung ist ein Server-Tool, ein Tool, das auf der Infrastruktur von Anthropic läuft. Du schreibst dafür keinen Handler, und dein Code sendet kein tool_result zurück.

Das Hinzufügen der Codeausführung erfordert nur einen Eintrag in deiner tools-Liste. Das Datum am Ende des type-Werts des Eintrags ist die Version des Tools, und Meridian verwendet code_execution_20260120. Die aktuellen Versionen sind in der Tool-Referenz aufgeführt, also kopiere den type-Wert von dort.

Meridian speichert die Liste in einer Konstante namens TOOLS, und seine Anfrage übergibt sie als tools=TOOLS:

TOOLS = [{"type": "code_execution_20260120", "name": "code_execution"}]

Stand Oktober 2026 läuft Codeausführung auf der Claude API, Claude Platform auf AWS, den Claude-Modellen bei Google Cloud, die von Anthropic verwaltet werden, und auf Microsoft Foundry-Deployments, die bei Anthropic gehostet werden.

Lege deine Dateien in den Container

Claudes Code läuft in einem Container auf der Seite von Anthropic. Deine Dateien befinden sich nach wie vor auf deinem Rechner, der Container hat sie also noch nicht. Meridians Programm bringt sie in zwei Schritten in den Container:

1. Lade jede Datei mit der Files API hoch, die dir eine Datei-ID zurückgibt.
2. Lege diese Datei-ID in deine Nachricht, in einen container_upload-Block.

Meridians Programm fügt für jede Datei einen container_upload-Block hinzu, in derselben Nachricht wie seine Frage. Die Dateien werden dann auf den Container geladen, wo Claudes Code sie öffnen kann.

Lies Claudes Antwort

Dein Code sendet eine Anfrage und erhält normalerweise die fertige Antwort zurück.

Die API kann einen lange laufenden Turn pausieren und einen stop_reason von pause_turn zurückgeben. In diesem Fall sende den Inhalt der Antwort als Assistant-Nachricht zurück, mit denselben tools, und Claude macht weiter.

Claudes Antwort für Meridian lautet, dass Station 7 ihre Auslegungskapazität von 600 L/s zweimal überschritten hat, im April und Mai 2025. In der Antwort kommt die Antwort nach den Befehlen, die Claude ausgeführt hat.

Setze das Programm zusammen

Meridians Programm unten fügt das Tool hinzu, legt die Dateien in den Container und liest die Antwort. Im Programm enthält paths die 12 CSV-Dateien als pathlib.Path-Objekte, und QUESTION enthält Meridians Frage.

Wichtigste Erkenntnisse

• Codeausführung ist ein Server-Tool. Du fügst einen Eintrag zu tools hinzu, und Claudes Code läuft in einem Container auf der Seite von Anthropic.
• Du lädst jede Datei mit der Files API hoch und legst dann ihre Datei-ID in einen container_upload-Block.