---
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
  zdr:
    eligibility: not-eligible
    note: No es elegible para ZDR, excepto Managed Agents autoalojado. Las sesiones son recursos con estado; las transcripciones persisten hasta que las eliminas.
  supportedModels:
    - claude-fable-5-2
    - claude-mythos-5-2
    - claude-fable-5-1
    - claude-mythos-5-1
    - claude-fable-5
    - claude-mythos-5
    - claude-mythos-preview
    - claude-opus-5-5
    - claude-opus-5
    - claude-sonnet-5-5
    - claude-sonnet-5
    - claude-haiku-5-5
    - claude-haiku-4-5-20251001
    - claude-opus-4-8
    - claude-opus-4-7
    - claude-opus-4-6
    - claude-sonnet-4-6
    - claude-opus-4-5-20251101
    - claude-sonnet-4-5-20250929
  supportedPlatforms:
    Claude API: beta
    Claude Platform on AWS: beta
    Claude Models on Google Cloud (Anthropic managed): beta
---

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).

<Note>
  Claude Managed Agents también está disponible en Claude Models on Google Cloud (Anthropic managed) y Claude Platform on AWS, con algunas diferencias en la disponibilidad de funciones y el comportamiento de las sesiones. Consulta la guía de [Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/es/build-with-claude/claude-models-on-google-cloud/anthropic-managed#claude-managed-agents) o [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 on AWS.
</Note>

<CardGroup cols={3}>
  <Card title="Inicio rápido" icon="play" href="https://platform.claude.com/docs/es/managed-agents/quickstart">
    Crea tu primera sesión de agente
  </Card>

  <Card title="Inicia una sesión" icon="code-brackets" href="https://platform.claude.com/docs/es/managed-agents/sessions">
    Crea una sesión y envía tu primer evento
  </Card>

  <Card title="Referencia" icon="book" href="https://platform.claude.com/docs/es/managed-agents/reference">
    Tipos de eventos, límites de velocidad, flags de la CLI y otras tablas de consulta
  </Card>
</CardGroup>

## 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

<Steps>
  <Step title="Crea un agente">
    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.
  </Step>

  <Step title="Crea un entorno">
    [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.
  </Step>

  <Step title="Inicia una sesión">
    Lanza una sesión que haga referencia a la configuración de tu agente y entorno.
  </Step>

  <Step title="Envía eventos y recibe respuestas por streaming">
    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 servicio de Managed Agents conserva el historial de eventos y puedes recuperarlo completo.
  </Step>

  <Step title="Dirige o interrumpe">
    Envía eventos de usuario adicionales para guiar al agente mientras se ejecuta, o interrúmpelo para cambiar de dirección.
  </Step>
</Steps>

## 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
* **Servicio autoalojado:** Todo el servicio de Managed Agents en tu propia infraestructura, con [Claude Managed Agents autoalojado](https://platform.claude.com/docs/es/managed-agents/self-hosted)
* **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

<Note>
  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. Anthropic podría refinar los comportamientos entre versiones para mejorar los resultados.
</Note>

Para comenzar, necesitas:

1. Una [clave de API de Claude](https://platform.claude.com/settings/keys) de la Claude Console.
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 [los sueños](https://platform.claude.com/docs/es/managed-agents/dreams) se encuentran en una vista previa de investigación más limitada. Para habilitarlos, [solicita acceso a la vista previa de investigación](https://claude.com/form/claude-managed-agents).

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 [retención cero de datos](https://platform.claude.com/docs/es/manage-claude/api-and-data-retention#zero-data-retention-zdr-scope) ni para la cobertura del “Business Associate Agreement” (acuerdo de asociado comercial), o BAA, de HIPAA. La excepción para la retención cero de datos es Claude Managed Agents autoalojado, donde tú mismo almacenas esos datos, como se describe en [Cuánto tiempo se conservan los datos](https://platform.claude.com/docs/es/managed-agents/self-hosted-data-and-access#how-long-data-is-kept). 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.

## Disponibilidad

Estado de Managed Agents: en beta en todos los modelos.

### Compatibilidad con la API

| Estado | Plataformas en la nube | Modelos |
| ----- | ----- | ----- |
| Beta | Claude API, [Claude Platform on AWS](https://platform.claude.com/docs/es/build-with-claude/claude-platform-on-aws), [Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/es/build-with-claude/claude-models-on-google-cloud/anthropic-managed) | [Todos los modelos](https://platform.claude.com/docs/es/models/overview) |

### Encabezados beta requeridos

[Descripción general de los encabezados beta](https://platform.claude.com/docs/es/api/beta-headers)

Los encabezados beta te permiten acceder a funciones experimentales y nuevas capacidades de los modelos antes de que formen parte de la API estándar.

* `managed-agents-2026-04-01`

### Manejo de datos

[Descripción general del manejo de datos](https://platform.claude.com/docs/es/manage-claude/api-and-data-retention#feature-eligibility)

| Elemento | Retención de datos cero | HIPAA |
| ----- | ----- | ----- |
| Estado | No elegible | No elegible |
| Detalles | No es elegible para ZDR, excepto Managed Agents autoalojado. Las sesiones son recursos con estado; las transcripciones persisten hasta que las eliminas. [Más información](https://platform.claude.com/docs/es/managed-agents/self-hosted-data-and-access#how-long-data-is-kept) | No es elegible para HIPAA. Se aplica a todas las subfunciones de Managed Agents. |

Endpoints aplicables:

* `/v1/agents`
* `/v1/sessions`
* `/v1/environments`
