Primeros pasos

Descripción general de Claude Managed Agents

Arnés de agente preconfigurado y configurable que se ejecuta en infraestructura administrada. Ideal para tareas de larga duración y trabajo asíncrono.

Anthropic offers two ways to build with Claude, each suited to different use cases:

	Messages API	Claude Managed Agents
What it is	Direct model prompting access	Pre-built, configurable agent harness that runs in managed infrastructure
Best for	Custom agent loops and fine-grained control	Long-running tasks and asynchronous work
Learn more	Messages API docs	Claude Managed Agents docs

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 tiempo de ejecución, obtienes un entorno completamente administrado donde Claude puede leer archivos, ejecutar comandos, navegar por la web y ejecutar código de forma segura. El arnés admite almacenamiento en caché de prompts integrado, compactación y otras optimizaciones de rendimiento para obtener resultados de agente eficientes y de alta calidad.

Inicio rápido

Crea tu primera sesión de agente

Referencia de API

Documentación completa de endpoints

Conceptos fundamentales

Claude Managed Agents se basa en cuatro conceptos:

Concept	Description
Agent	The model, system prompt, tools, MCP servers, and skills
Environment	A configured container template (packages, network access)
Session	A running agent instance within an environment, performing a specific task and generating outputs
Events	Messages exchanged between your application and the agent (user turns, tool results, status updates)

Cómo funciona

Crear un agente
Define el modelo, el prompt del sistema, las herramientas, los servidores MCP y las habilidades. Crea el agente una vez y referéncialo por ID en todas las sesiones.
Crear un entorno
Configura un contenedor en la nube con paquetes preinstalados (Python, Node.js, Go, etc.), reglas de acceso a la red y archivos montados.
Iniciar una sesión
Lanza una sesión que haga referencia a tu agente y a la configuración del entorno.
Enviar eventos y transmitir respuestas
Envía mensajes de usuario como eventos. Claude ejecuta herramientas de forma autónoma y transmite los resultados de vuelta mediante eventos enviados por el servidor (SSE). El historial de eventos se persiste en el servidor y puede recuperarse en su totalidad.
Dirigir o interrumpir
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 - Contenedores seguros con paquetes preinstalados y acceso a la red
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 conversaciones a través de múltiples interacciones

Herramientas compatibles

Claude Managed Agents le da a Claude acceso a un conjunto completo de herramientas integradas:

Bash - Ejecuta comandos de shell en el contenedor
Operaciones de archivos - Lee, escribe, edita, aplica glob y grep a archivos en el contenedor
Búsqueda y recuperación web - Busca en la web y recupera contenido de URLs
Servidores MCP - Conéctate a proveedores de herramientas externos

Consulta Herramientas para ver la lista completa y las opciones de configuración.

Acceso beta

Claude Managed Agents se encuentra actualmente 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:

Una clave de API de Claude
El encabezado beta anterior en todas las solicitudes
Acceso a Claude Managed Agents (habilitado de forma predeterminada para todas las cuentas de API)

Ciertas características (resultados, multiagente y memoria) están en vista previa de investigación. Solicita acceso para probarlas.

Límites de velocidad

Los endpoints de Managed Agents tienen límites de velocidad por organización:

Operación	Límite
Endpoints de creación (agentes, sesiones, entornos, etc.)	60 solicitudes por minuto
Endpoints de lectura (recuperar, listar, transmitir, etc.)	600 solicitudes por minuto

También se aplican los límites de gasto y límites de velocidad basados en niveles a nivel de organización.

Directrices de marca

Para los socios que integran Claude Managed Agents, el uso de la marca Claude es opcional. Al hacer referencia a Claude en tu producto:

Permitido:

"Claude Agent" (preferido para menús desplegables)
"Claude" (cuando está dentro de un menú ya etiquetado como "Agents")
"{NombreDetuAgente} Powered by Claude" (si tienes un nombre de agente existente)

No permitido:

"Claude Code" o "Claude Code Agent"
"Claude Cowork" o "Claude Cowork Agent"
Arte ASCII con la marca Claude Code o elementos visuales que imiten Claude Code

Tu producto debe mantener su propia marca y no debe parecer ser Claude Code, Claude Cowork ni ningún otro producto de Anthropic. Para preguntas sobre el cumplimiento de la marca, contacta al equipo de ventas de Anthropic.

Was this page helpful?

Primeros pasos

Descripción general de Claude Managed Agents

Arnés de agente preconfigurado y configurable que se ejecuta en infraestructura administrada. Ideal para tareas de larga duración y trabajo asíncrono.

Anthropic offers two ways to build with Claude, each suited to different use cases:

	Messages API	Claude Managed Agents
What it is	Direct model prompting access	Pre-built, configurable agent harness that runs in managed infrastructure
Best for	Custom agent loops and fine-grained control	Long-running tasks and asynchronous work
Learn more	Messages API docs	Claude Managed Agents docs

Inicio rápido

Crea tu primera sesión de agente

Referencia de API

Documentación completa de endpoints

Conceptos fundamentales

Claude Managed Agents se basa en cuatro conceptos:

Concept	Description
Agent	The model, system prompt, tools, MCP servers, and skills
Environment	A configured container template (packages, network access)
Session	A running agent instance within an environment, performing a specific task and generating outputs
Events	Messages exchanged between your application and the agent (user turns, tool results, status updates)

Cómo funciona

Crear un agente
Define el modelo, el prompt del sistema, las herramientas, los servidores MCP y las habilidades. Crea el agente una vez y referéncialo por ID en todas las sesiones.
Crear un entorno
Configura un contenedor en la nube con paquetes preinstalados (Python, Node.js, Go, etc.), reglas de acceso a la red y archivos montados.
Iniciar una sesión
Lanza una sesión que haga referencia a tu agente y a la configuración del entorno.
Enviar eventos y transmitir respuestas
Envía mensajes de usuario como eventos. Claude ejecuta herramientas de forma autónoma y transmite los resultados de vuelta mediante eventos enviados por el servidor (SSE). El historial de eventos se persiste en el servidor y puede recuperarse en su totalidad.
Dirigir o interrumpir
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 - Contenedores seguros con paquetes preinstalados y acceso a la red
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 conversaciones a través de múltiples interacciones

Herramientas compatibles

Claude Managed Agents le da a Claude acceso a un conjunto completo de herramientas integradas:

Bash - Ejecuta comandos de shell en el contenedor
Operaciones de archivos - Lee, escribe, edita, aplica glob y grep a archivos en el contenedor
Búsqueda y recuperación web - Busca en la web y recupera contenido de URLs
Servidores MCP - Conéctate a proveedores de herramientas externos

Consulta Herramientas para ver la lista completa y las opciones de configuración.

Acceso beta

Para comenzar, necesitas:

Una clave de API de Claude
El encabezado beta anterior en todas las solicitudes
Acceso a Claude Managed Agents (habilitado de forma predeterminada para todas las cuentas de API)

Ciertas características (resultados, multiagente y memoria) están en vista previa de investigación. Solicita acceso para probarlas.

Límites de velocidad

Los endpoints de Managed Agents tienen límites de velocidad por organización:

Operación	Límite
Endpoints de creación (agentes, sesiones, entornos, etc.)	60 solicitudes por minuto
Endpoints de lectura (recuperar, listar, transmitir, etc.)	600 solicitudes por minuto

También se aplican los límites de gasto y límites de velocidad basados en niveles a nivel de organización.

Directrices de marca

Para los socios que integran Claude Managed Agents, el uso de la marca Claude es opcional. Al hacer referencia a Claude en tu producto:

Permitido:

"Claude Agent" (preferido para menús desplegables)
"Claude" (cuando está dentro de un menú ya etiquetado como "Agents")
"{NombreDetuAgente} Powered by Claude" (si tienes un nombre de agente existente)

No permitido:

"Claude Code" o "Claude Code Agent"
"Claude Cowork" o "Claude Cowork Agent"
Arte ASCII con la marca Claude Code o elementos visuales que imiten Claude Code

Was this page helpful?