Ejecución de código: Claude ejecuta el código que escribe

La demostración de este video se grabó en septiembre de 2026. Se ejecutó en Claude Sonnet 5 (claude-sonnet-5). Los resultados pueden diferir en modelos más recientes.

Algunas preguntas requieren matemáticas entre muchos archivos. Ese es un trabajo para código.

Toma a Meridian, una consultoría de ingeniería ficticia. Tiene 12 archivos CSV, uno para cada estación de bombeo, y cada archivo contiene un año de lecturas de flujo. Quiere saber si alguna estación superó alguna vez su capacidad de diseño y, si fue así, cuándo.

La ejecución de código es la forma en que Claude hace ese trabajo. Claude obtiene un contenedor donde puede ejecutar el Python que escribe y responder a partir de lo que imprime el código.

Agrega la herramienta a tu solicitud

La ejecución de código es una herramienta de servidor, una herramienta que se ejecuta en la infraestructura de Anthropic. No escribes ningún controlador para ella, y tu código no envía de vuelta ningún tool_result.

Agregar la ejecución de código requiere una entrada en tu lista tools. La fecha al final del type de la entrada es la versión de la herramienta, y Meridian usa code_execution_20260120. Las versiones actuales están listadas en la referencia de herramientas, así que copia el valor de type desde allí.

Meridian guarda la lista en una constante llamada TOOLS, y su solicitud la pasa como tools=TOOLS:

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

A partir de octubre de 2026, la ejecución de código se ejecuta en Claude API, Claude Platform on AWS, los modelos de Claude en Google Cloud que administra Anthropic, y las implementaciones de Microsoft Foundry alojadas en Anthropic.

Coloca tus archivos en el contenedor

El código de Claude se ejecuta en un contenedor del lado de Anthropic. Tus archivos siguen en tu máquina, así que el contenedor todavía no los tiene. El programa de Meridian los lleva al contenedor en dos pasos:

1. Sube cada archivo con la Files API, que te devuelve un ID de archivo.
2. Coloca ese ID de archivo en tu mensaje, en un bloque container_upload.

El programa de Meridian agrega un bloque container_upload por cada archivo, en el mismo mensaje que su pregunta. Los archivos se cargan entonces en el contenedor, donde el código de Claude puede abrirlos.

Lee la respuesta de Claude

Tu código envía una solicitud y generalmente recibe la respuesta terminada.

La API puede pausar un turno de larga duración y devolver un stop_reason de pause_turn. Cuando lo hace, envía el contenido de la respuesta de vuelta como un mensaje de asistente, con los mismos tools, y Claude continúa.

La respuesta de Claude para Meridian es que la Estación 7 superó su capacidad de diseño de 600 L/s en dos ocasiones, en abril y mayo de 2025. En la respuesta, la respuesta llega después de los comandos que Claude ejecutó.

Arma el programa completo

El programa de Meridian a continuación agrega la herramienta, coloca los archivos en el contenedor y lee la respuesta. En el programa, paths contiene los 12 archivos CSV como objetos pathlib.Path, y QUESTION contiene la pregunta de Meridian.

Puntos clave

• La ejecución de código es una herramienta de servidor. Agregas una entrada a tools, y el código de Claude se ejecuta en un contenedor del lado de Anthropic.
• Subes cada archivo con la Files API, y luego colocas su ID de archivo en un bloque container_upload.