---
title: Claude Managed Agents autoalojado
url: https://platform.claude.com/docs/es/managed-agents/self-hosted
description: Aloja el servicio Claude Managed Agents y sus sandboxes en tu propia infraestructura. Descubre quién aloja cada parte, cuándo elegir esta opción y por dónde empezar.
---

<Note>
  Para solicitar acceso a Claude Managed Agents autoalojado, ponte en contacto con el equipo de tu cuenta de Anthropic.
</Note>

Claude Managed Agents autoalojado es Managed Agents en tu propia infraestructura, que puede ser una cuenta en la nube o un centro de datos on-premise. Tú alojas el servicio y los sandboxes. El modelo se ejecuta en Anthropic o en un proveedor que tú elijas.

Managed Agents tiene dos partes que puedes alojar:

* **Sandboxes:** Los contenedores, las VM u otros espacios de trabajo aislados donde las herramientas de un agente ejecutan comandos y trabajan con archivos. Consulta [Sandboxes autoalojados](https://platform.claude.com/docs/es/managed-agents/self-hosted-sandboxes).
* **El servicio:** La API, el bucle del agente y el almacenamiento de los agentes, las sesiones y el historial de las sesiones.

Los sandboxes autoalojados trasladan la primera parte a ti. Managed Agents autoalojado amplía eso: tú también alojas el servicio. El nombre de cada opción indica qué alojas:

| Opción                                                                                             | Sandboxes | Servicio  | Modelo                                  |
| -------------------------------------------------------------------------------------------------- | --------- | --------- | --------------------------------------- |
| Sandboxes en la nube (predeterminado)                                                              | Anthropic | Anthropic | Anthropic                               |
| [Sandboxes autoalojados](https://platform.claude.com/docs/es/managed-agents/self-hosted-sandboxes) | Tú        | Anthropic | Anthropic                               |
| Managed Agents autoalojado                                                                         | Tú        | Tú        | Anthropic, o un proveedor que tú elijas |

En estas páginas, el servicio alojado es el servicio tal como lo ejecuta Anthropic, y tu servidor es el servicio tal como lo ejecutas tú, con su propia base de datos. Ambos tienen la misma API, así que el SDK y la CLI `ant` funcionan con tu servidor, y el resto de la documentación de Managed Agents se aplica. [Diferencias con el servicio alojado](https://platform.claude.com/docs/es/managed-agents/self-hosted/differences) enumera las excepciones.

<Note title="¿Eres nuevo en Claude Managed Agents?">
  Claude Managed Agents ejecuta Claude como un agente autónomo: defines un agente, inicias una sesión e intercambias eventos con el agente mientras trabaja. [Conceptos principales](https://platform.claude.com/docs/es/managed-agents/overview#core-concepts) explica los agentes, los entornos, las sesiones y los eventos. No necesitas usar primero el servicio alojado.
</Note>

## Cuándo elegir Managed Agents autoalojado

Elige Managed Agents autoalojado cuando necesites una de las siguientes opciones:

* **Almacenamiento en tu infraestructura:** Debes almacenar tú mismo los agentes, las sesiones y el historial de las sesiones.
* **Tu elección de proveedor de inferencia:** Las llamadas al modelo deben ir a Amazon Bedrock, Claude Models on Google Cloud (Google managed), Microsoft Foundry o tu propio gateway de modelos. Consulta [Proveedor de inferencia](https://platform.claude.com/docs/es/managed-agents/self-hosted/inference-provider).

Si solo necesitas que las herramientas se ejecuten en tu infraestructura, usa sandboxes autoalojados, donde Anthropic ejecuta el servicio. Consulta [Elegir un entorno para el agente](https://platform.claude.com/docs/es/managed-agents/choosing-an-environment).

Con Managed Agents autoalojado, tú ejecutas y proteges un servidor, su base de datos y tus sandboxes, y tú mismo instalas cada versión. Algunas funciones solo existen en el servicio alojado, así que consulta [Diferencias con el servicio alojado](https://platform.claude.com/docs/es/managed-agents/self-hosted/differences) antes de decidir.

## Qué se ejecuta dónde

Uno o más servidores, su base de datos y tus sandboxes forman una implementación.

```mermaid
flowchart LR
  accTitle: Components of self-hosted Managed Agents
  accDescr: Your applications, the server, its database, and your workers run inside your network. Applications call the server. Workers poll the server for work. The server stores its data in the database. The server sends each model call to the inference provider you configure, which is the Claude API by default.
  subgraph network [Your network]
    apps[Your applications] -->|Managed Agents API| server[Server]
    workers[Your workers] -->|poll for work| server
    server --> db[(Database)]
  end
  server -->|model calls| inference[Inference provider]
```

* **Servidor (`cma-server`):** Sirve la API, ejecuta el bucle del agente y almacena los agentes, las sesiones y el historial de cada sesión. Llama a tu proveedor de inferencia cada vez que el agente necesita el modelo. El servidor nunca ejecuta las herramientas de shell ni de archivos de un agente.
* **Base de datos:** PostgreSQL 16 o posterior. Sin una base de datos, el servidor guarda sus datos en memoria, y un reinicio los borra.
* **Workers:** Programas que toman trabajo del servidor y ejecutan las herramientas de shell y de archivos del agente en tus sandboxes. Un worker es un comando `ant beta:worker` o un worker del SDK.
* **Tus aplicaciones:** Tu propio código y tus scripts, que acceden al servidor con el SDK o la CLI `ant`.
* **Consola de tu servidor:** Una página web en la dirección del servidor, donde las personas inician sesión a través de tu proveedor de identidad para crear agentes y ejecutar sesiones. Consulta [Usar la consola de tu servidor](https://platform.claude.com/docs/es/managed-agents/self-hosted/console).
* **CLI de administración (`cma-server-admin`):** Crea los entornos y sus claves de entorno. Se ejecuta en Linux (x86-64 y Arm) y en macOS con Apple silicon.

## Tus responsabilidades de seguridad

<Warning>
  La herramienta `bash` del agente es un shell real con los permisos y el acceso a la red del proceso del worker. El worker no aísla ese shell. El aislamiento proviene de aquello en lo que se ejecuta el worker. El stack de Docker Compose y el chart de Helm `cma-sandboxes` inician el worker de cada sesión en un contenedor o pod propio. Si inicias un worker tú mismo, ejecútalo en un contenedor o una VM desechable que no contenga nada que necesites proteger.
</Warning>

El [Modelo de seguridad](https://platform.claude.com/docs/es/managed-agents/self-hosted-sandboxes-security) de los sandboxes autoalojados se aplica aquí, con dos diferencias. Lo que esa página asigna a Anthropic es tu responsabilidad, incluido proteger el servidor, alojar los almacenes de memoria y detectar usos inusuales. Esa página también sugiere un espacio de trabajo y un entorno separados para cada límite de confianza. Aquí, cada nivel de confianza necesita su propia implementación, como explica [Multiinquilinato](https://platform.claude.com/docs/es/managed-agents/self-hosted-data-and-access#multitenancy).

## Las tres credenciales

| Credencial                    | Quién la tiene                                            | Qué autentica                                                                                                                                                                                                                                                   |
| ----------------------------- | --------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Clave de API del servidor** | Tus aplicaciones, la CLI `ant` y la CLI de administración | Las solicitudes a tu servidor. La configuración genera esta clave. Cumple el papel que cumple una clave de API de Claude con el servicio alojado.                                                                                                               |
| **Credencial de inferencia**  | El servidor                                               | Las llamadas al modelo que hace el servidor a tu proveedor de inferencia. Por ejemplo, puede ser una clave de API de Claude, la credencial de tu proveedor de nube o el token que acepta tu gateway de modelos. Las aplicaciones y los workers no la necesitan. |
| **Clave de entorno**          | Tus workers que consultan periódicamente al servidor      | La cola de trabajo de un entorno y las sesiones de ese entorno.                                                                                                                                                                                                 |

## Qué sale de tu red

Para cada llamada al modelo, el servidor envía la conversación hasta ese momento, incluidas las entradas y los resultados de las herramientas, a tu proveedor de inferencia. De forma predeterminada, es la API de Claude. Una llamada a la API de Claude también lleva los ID de su sesión y del agente y el entorno de esa sesión. [Datos y acceso en Claude Managed Agents autoalojado](https://platform.claude.com/docs/es/managed-agents/self-hosted-data-and-access) enumera cada conexión que realiza el servidor. También indica adónde van los registros y quién puede acceder al servidor.

## Por dónde empezar

Para solicitar acceso a la descarga, ponte en contacto con el equipo de tu cuenta de Anthropic. Luego sigue [Comenzar con Claude Managed Agents autoalojado](https://platform.claude.com/docs/es/managed-agents/self-hosted/quickstart) para iniciar un servidor y ejecutar una primera sesión.

El archivo de cada versión incluye una guía del operador para esa versión, `operator-guide.md`. Pídele a Claude que lea ese archivo, para que Claude pueda ayudarte a configurar y ejecutar tu servidor y a escribir código que se conecte a él.
