---
title: Descripción general de Claude Managed Agents
url: https://platform.claude.com/docs/es/managed-agents/overview
description: Arnés de agente preconstruido y configurable que se ejecuta en infraestructura administrada. Ideal para tareas de larga duración y trabajo asíncrono.
featureMetadata:
topic:
title: Managed Agents
url: https://platform.claude.com/docs/en/managed-agents/overview
status: beta
betaHeader: managed-agents-2026-04-01
---
Anthropic ofrece dos formas de construir con Claude, cada una adecuada para diferentes casos de uso:
| | Messages API | Claude Managed Agents |
| -------------- | --------------------------------------------------- | ------------------------------------------------------------------------------------------- |
| **Qué es** | Acceso directo para enviar prompts al modelo | Arnés de agente preconstruido y configurable que se ejecuta en infraestructura administrada |
| **Ideal para** | Bucles de agente personalizados y control detallado | Tareas de larga duración y trabajo asíncrono |
Claude Managed Agents proporciona el arnés y la infraestructura para ejecutar Claude como un agente autónomo. En lugar de construir tu propio bucle de agente, ejecución de herramientas y entorno de ejecución, obtienes un entorno totalmente administrado donde Claude puede leer archivos, ejecutar comandos, navegar por la web y ejecutar código de forma segura. El arnés admite "prompt caching" (almacenamiento en caché de prompts) integrado, compactación y otras optimizaciones de rendimiento para obtener resultados de agente eficientes y de alta calidad. Para construir tu propio bucle de agente con acceso directo al modelo, consulta [Uso de la Messages API](https://platform.claude.com/docs/es/build-with-claude/working-with-messages).
Claude Managed Agents también está disponible en Claude Platform en AWS, con algunas diferencias en la disponibilidad de funciones y el comportamiento de las sesiones. Consulta [Claude Managed Agents](https://platform.claude.com/docs/es/build-with-claude/claude-platform-on-aws#claude-managed-agents) en la guía de Claude Platform en AWS.
Crea tu primera sesión de agente
Crea una sesión y envía tu primer evento
Tipos de eventos, límites de velocidad, flags de la CLI y otras tablas de consulta
## Conceptos principales
Claude Managed Agents se basa en cuatro conceptos:
| Concepto | Descripción |
| ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Agente** | El modelo, la indicación del sistema, las herramientas, los servidores MCP y las skills |
| **Entorno** | Configuración de dónde se ejecutan las sesiones: un sandbox en la nube administrado por Anthropic, o un sandbox autoalojado en tu propia infraestructura |
| **Sesión** | Una instancia de agente en ejecución dentro de un entorno, que realiza una tarea específica y genera salidas |
| **Eventos** | Mensajes intercambiados entre tu aplicación y el agente (turnos del usuario, resultados de herramientas, actualizaciones de estado) |
## Cómo funciona
Define el modelo, la "system prompt" (indicación del sistema), las herramientas, los servidores MCP y las skills. Crea el agente una vez y haz referencia a él por ID en todas las sesiones.
[Configura dónde se ejecuta el agente](https://platform.claude.com/docs/es/managed-agents/choosing-an-environment): un sandbox en la nube o un [sandbox autoalojado](https://platform.claude.com/docs/es/managed-agents/self-hosted-sandboxes) en tu propia infraestructura.
Lanza una sesión que haga referencia a la configuración de tu agente y entorno.
Envía mensajes de usuario como eventos. Claude ejecuta herramientas de forma autónoma y devuelve los resultados por streaming mediante "server-sent events" (eventos enviados por el servidor), o SSE. El historial de eventos se conserva en el servidor y puede recuperarse completo.
Envía eventos de usuario adicionales para guiar al agente durante la ejecución, o interrúmpelo para cambiar de dirección.
## Cuándo usar Claude Managed Agents
Claude Managed Agents es ideal para cargas de trabajo que necesitan:
* **Ejecución de larga duración:** Tareas que se ejecutan durante minutos u horas con múltiples llamadas a herramientas
* **Infraestructura en la nube:** Sandboxes seguros con paquetes preinstalados y acceso a la red
* **Ejecución autoalojada:** Sandboxes en infraestructura que tú controlas para requisitos de cumplimiento normativo o residencia de datos
* **Infraestructura mínima:** Sin necesidad de construir tu propio bucle de agente, sandbox o capa de ejecución de herramientas
* **Sesiones con estado:** Sistemas de archivos persistentes e historial de conversación a lo largo de múltiples interacciones
* **Ejecución programada:** Ejecuciones recurrentes del agente según una programación cron mediante [despliegues programados](https://platform.claude.com/docs/es/managed-agents/scheduled-deployments)
## Herramientas compatibles
Claude Managed Agents le da a Claude acceso a un conjunto de herramientas integradas:
* **Bash:** Ejecuta comandos de shell en el sandbox
* **Operaciones de archivos:** Lee, escribe, edita y aplica glob y grep a archivos en el sandbox
* **Búsqueda y obtención web:** Busca en la web y recupera contenido de URLs, opcionalmente restringido a una lista de dominios permitidos o bloqueados
* **Servidores MCP:** Conéctate a proveedores de herramientas externos
Consulta [Herramientas](https://platform.claude.com/docs/es/managed-agents/tools) para ver la lista completa y las opciones de configuración.
## Acceso beta
Claude Managed Agents está en beta. Todos los endpoints de Managed Agents requieren el encabezado beta `managed-agents-2026-04-01`. El SDK establece el encabezado beta automáticamente. Los comportamientos pueden refinarse entre versiones para mejorar los resultados.
Para comenzar, necesitas:
1. Una [clave de API de Claude](https://platform.claude.com/settings/keys)
2. El encabezado beta `managed-agents-2026-04-01` en todas las solicitudes
3. Acceso a Claude Managed Agents (habilitado de forma predeterminada para todas las cuentas de API)
Dentro de la beta, los [túneles MCP](https://platform.claude.com/docs/es/agents-and-tools/mcp-tunnels/overview) y [dreaming](https://platform.claude.com/docs/es/managed-agents/dreams) se encuentran en una vista previa de investigación más limitada. [Solicita acceso](https://claude.com/form/claude-managed-agents) para habilitarlos.
Claude Managed Agents tiene estado por diseño: las sesiones son de larga duración, se reanudan sin problemas después de las pausas y almacenan el historial de conversación, el estado del sandbox y los resultados en el servidor. Por este motivo, Managed Agents actualmente no es elegible para [Zero Data Retention](https://platform.claude.com/docs/es/manage-claude/api-and-data-retention#zero-data-retention-zdr-scope) ni para la cobertura del HIPAA Business Associate Agreement (BAA). Tú conservas el control sobre estos datos: puedes [eliminar sesiones](https://platform.claude.com/docs/es/managed-agents/session-operations#deleting-a-session) y, por separado, eliminar cualquier [archivo](https://platform.claude.com/docs/es/build-with-claude/files#delete-a-file) que hayas subido, en cualquier momento a través de la API. Para conocer la elegibilidad de todas las funciones, consulta [API y retención de datos](https://platform.claude.com/docs/es/manage-claude/api-and-data-retention#feature-eligibility).
Consulta [Límites de velocidad](https://platform.claude.com/docs/es/managed-agents/reference#rate-limits) y [Directrices de marca](https://platform.claude.com/docs/es/managed-agents/reference#branding-guidelines) en la referencia.