La herramienta de ejecución de código está actualmente en beta pública.Para usar esta función, agregue el encabezado beta
"code-execution-2025-08-25" a sus solicitudes de API.Compatibilidad de modelos
La herramienta de ejecución de código está disponible en los siguientes modelos:| Modelo | Versión de herramienta |
|---|---|
Claude Opus 4.1 (claude-opus-4-1-20250805) | code_execution_20250825 |
Claude Opus 4 (claude-opus-4-20250514) | code_execution_20250825 |
Claude Sonnet 4.5 (claude-sonnet-4-5-20250929) | code_execution_20250825 |
Claude Sonnet 4 (claude-sonnet-4-20250514) | code_execution_20250825 |
Claude Sonnet 3.7 (claude-3-7-sonnet-20250219) (obsoleto) | code_execution_20250825 |
Claude Haiku 4.5 (claude-haiku-4-5-20251001) | code_execution_20250825 |
Claude Haiku 3.5 (claude-3-5-haiku-latest) | code_execution_20250825 |
La versión actual
code_execution_20250825 admite comandos Bash y operaciones de archivos. También está disponible una versión heredada code_execution_20250522 (solo Python). Consulte Actualizar a la versión más reciente de la herramienta para obtener detalles de migración.Las versiones de herramienta más antiguas no tienen garantía de ser compatibles hacia atrás con modelos más nuevos. Siempre use la versión de herramienta que corresponda a su versión de modelo.
Inicio rápido
Aquí hay un ejemplo simple que le pide a Claude que realice un cálculo:Cómo funciona la ejecución de código
Cuando agrega la herramienta de ejecución de código a su solicitud de API:- Claude evalúa si la ejecución de código ayudaría a responder su pregunta
- La herramienta proporciona automáticamente a Claude las siguientes capacidades:
- Comandos Bash: Ejecutar comandos de shell para operaciones del sistema y gestión de paquetes
- Operaciones de archivos: Crear, ver y editar archivos directamente, incluida la escritura de código
- Claude puede usar cualquier combinación de estas capacidades en una única solicitud
- Todas las operaciones se ejecutan en un entorno seguro aislado
- Claude proporciona resultados con cualquier gráfico generado, cálculos o análisis
Cómo usar la herramienta
Ejecutar comandos Bash
Pida a Claude que verifique la información del sistema e instale paquetes:Crear y editar archivos directamente
Claude puede crear, ver y editar archivos directamente en el sandbox usando las capacidades de manipulación de archivos:Cargar y analizar sus propios archivos
Para analizar sus propios archivos de datos (CSV, Excel, imágenes, etc.), cárguelos a través de la API de archivos y haga referencia a ellos en su solicitud:Usar la API de archivos con ejecución de código requiere dos encabezados beta:
"anthropic-beta": "code-execution-2025-08-25,files-api-2025-04-14"- CSV
- Excel (.xlsx, .xls)
- JSON
- XML
- Imágenes (JPEG, PNG, GIF, WebP)
- Archivos de texto (.txt, .md, .py, etc)
Cargar y analizar archivos
- Cargue su archivo usando la API de archivos
- Haga referencia al archivo en su mensaje usando un bloque de contenido
container_upload - Incluya la herramienta de ejecución de código en su solicitud de API
Recuperar archivos generados
Cuando Claude crea archivos durante la ejecución de código, puede recuperar estos archivos usando la API de archivos:Combinar operaciones
Un flujo de trabajo complejo usando todas las capacidades:Definición de herramienta
La herramienta de ejecución de código no requiere parámetros adicionales:JSON
bash_code_execution: Ejecutar comandos de shelltext_editor_code_execution: Ver, crear y editar archivos, incluida la escritura de código
Formato de respuesta
La herramienta de ejecución de código puede devolver dos tipos de resultados según la operación:Respuesta de comando Bash
Respuestas de operación de archivo
Ver archivo:Resultados
Todos los resultados de ejecución incluyen:stdout: Salida de ejecución exitosastderr: Mensajes de error si la ejecución fallareturn_code: 0 para éxito, no cero para fallo
- Ver:
file_type,content,numLines,startLine,totalLines - Crear:
is_file_update(si el archivo ya existía) - Editar:
oldStart,oldLines,newStart,newLines,lines(formato diff)
Errores
Cada tipo de herramienta puede devolver errores específicos: Errores comunes (todas las herramientas):| Herramienta | Código de error | Descripción |
|---|---|---|
| Todas las herramientas | unavailable | La herramienta no está disponible temporalmente |
| Todas las herramientas | execution_time_exceeded | La ejecución excedió el límite de tiempo máximo |
| Todas las herramientas | container_expired | El contenedor expiró y ya no está disponible |
| Todas las herramientas | invalid_tool_input | Parámetros inválidos proporcionados a la herramienta |
| Todas las herramientas | too_many_requests | Límite de velocidad excedido para el uso de la herramienta |
| text_editor | file_not_found | El archivo no existe (para operaciones de ver/editar) |
| text_editor | string_not_found | El old_str no se encontró en el archivo (para str_replace) |
Razón de parada pause_turn
La respuesta puede incluir una razón de parada pause_turn, que indica que la API pausó un turno de larga duración. Puede proporcionar la respuesta tal como está en una solicitud posterior para permitir que Claude continúe su turno, o modificar el contenido si desea interrumpir la conversación.
Contenedores
La herramienta de ejecución de código se ejecuta en un entorno contenedorizado seguro diseñado específicamente para la ejecución de código, con un enfoque más alto en Python.Entorno de ejecución
- Versión de Python: 3.11.12
- Sistema operativo: Contenedor basado en Linux
- Arquitectura: x86_64 (AMD64)
Límites de recursos
- Memoria: 5GiB de RAM
- Espacio en disco: 5GiB de almacenamiento de área de trabajo
- CPU: 1 CPU
Redes y seguridad
- Acceso a Internet: Completamente deshabilitado por seguridad
- Conexiones externas: No se permiten solicitudes de red salientes
- Aislamiento de sandbox: Aislamiento completo del sistema host y otros contenedores
- Acceso a archivos: Limitado solo al directorio de área de trabajo
- Alcance del área de trabajo: Como Archivos, los contenedores están limitados al área de trabajo de la clave de API
- Expiración: Los contenedores expiran 30 días después de su creación
Bibliotecas preinstaladas
El entorno de Python aislado incluye estas bibliotecas comúnmente utilizadas:- Ciencia de datos: pandas, numpy, scipy, scikit-learn, statsmodels
- Visualización: matplotlib, seaborn
- Procesamiento de archivos: pyarrow, openpyxl, xlsxwriter, xlrd, pillow, python-pptx, python-docx, pypdf, pdfplumber, pypdfium2, pdf2image, pdfkit, tabula-py, reportlab[pycairo], Img2pdf
- Matemáticas y computación: sympy, mpmath
- Utilidades: tqdm, python-dateutil, pytz, joblib, unzip, unrar, 7zip, bc, rg (ripgrep), fd, sqlite
Reutilización de contenedores
Puede reutilizar un contenedor existente en múltiples solicitudes de API proporcionando el ID del contenedor de una respuesta anterior. Esto le permite mantener archivos creados entre solicitudes.Ejemplo
Transmisión
Con la transmisión habilitada, recibirá eventos de ejecución de código a medida que ocurran:Solicitudes por lotes
Puede incluir la herramienta de ejecución de código en la API de lotes de mensajes. Las llamadas de herramienta de ejecución de código a través de la API de lotes de mensajes se cotizan igual que las de las solicitudes de API de mensajes regulares.Uso y precios
Code execution tool usage is tracked separately from token usage. Execution time has a minimum of 5 minutes. If files are included in the request, execution time is billed even if the tool is not used due to files being preloaded onto the container. Each organization receives 50 free hours of usage with the code execution tool per day. Additional usage beyond the first 50 hours is billed at $0.05 per hour, per container.Actualizar a la versión más reciente de la herramienta
Al actualizar acode-execution-2025-08-25, obtiene acceso a manipulación de archivos y capacidades de Bash, incluido código en varios idiomas. No hay diferencia de precio.
Qué ha cambiado
| Componente | Heredado | Actual |
|---|---|---|
| Encabezado beta | code-execution-2025-05-22 | code-execution-2025-08-25 |
| Tipo de herramienta | code_execution_20250522 | code_execution_20250825 |
| Capacidades | Solo Python | Comandos Bash, operaciones de archivos |
| Tipos de respuesta | code_execution_result | bash_code_execution_result, text_editor_code_execution_result |
Compatibilidad hacia atrás
- Toda la ejecución de código Python existente continúa funcionando exactamente como antes
- No se requieren cambios en los flujos de trabajo existentes solo de Python
Pasos de actualización
Para actualizar, debe realizar los siguientes cambios en sus solicitudes de API:-
Actualice el encabezado beta:
-
Actualice el tipo de herramienta:
-
Revise el manejo de respuestas (si analiza respuestas mediante programación):
- Los bloques anteriores para respuestas de ejecución de Python ya no se enviarán
- En su lugar, se enviarán nuevos tipos de respuesta para operaciones de Bash y archivos (consulte la sección Formato de respuesta)