---
title: Claude Managed Agents self-hosted
url: https://platform.claude.com/docs/it/managed-agents/self-hosted
description: Ospita il servizio Claude Managed Agents e le sue sandbox sulla tua infrastruttura. Scopri chi ospita ciascuna parte, quando scegliere questa opzione e da dove iniziare.
---

<Note>
  Per richiedere l’accesso a Claude Managed Agents self-hosted, contatta il tuo team di riferimento Anthropic.
</Note>

Claude Managed Agents self-hosted è Managed Agents sulla tua infrastruttura, che può essere un account cloud o un data center on-premise. Sei tu a ospitare il servizio e le sandbox. Il modello viene eseguito presso Anthropic o presso un provider che scegli tu.

Managed Agents ha due parti che puoi ospitare:

* **Sandbox:** I container, le VM o altri workspace isolati in cui gli strumenti di un agente eseguono comandi e lavorano sui file. Consulta [Sandbox self-hosted](https://platform.claude.com/docs/it/managed-agents/self-hosted-sandboxes).
* **Il servizio:** L’API, il ciclo dell’agente e l’archiviazione per agenti, sessioni e cronologia delle sessioni.

Le sandbox self-hosted trasferiscono a te la prima parte. Managed Agents self-hosted estende questa configurazione: ospiti anche il servizio. Il nome di ciascuna opzione indica cosa ospiti:

| Opzione                                                                                         | Sandbox   | Servizio  | Modello                                |
| ----------------------------------------------------------------------------------------------- | --------- | --------- | -------------------------------------- |
| Sandbox cloud (predefinite)                                                                     | Anthropic | Anthropic | Anthropic                              |
| [Sandbox self-hosted](https://platform.claude.com/docs/it/managed-agents/self-hosted-sandboxes) | Tu        | Anthropic | Anthropic                              |
| Managed Agents self-hosted                                                                      | Tu        | Tu        | Anthropic, o un provider che scegli tu |

In queste pagine, il servizio ospitato è il servizio così come lo esegue Anthropic, e il tuo server è il servizio così come lo esegui tu, con il proprio database. Entrambi hanno la stessa API, quindi l’SDK e la CLI `ant` funzionano con il tuo server, e il resto della documentazione di Managed Agents si applica. [Differenze rispetto al servizio ospitato](https://platform.claude.com/docs/it/managed-agents/self-hosted/differences) elenca le eccezioni.

<Note title="Non conosci ancora Claude Managed Agents?">
  Claude Managed Agents esegue Claude come agente autonomo: definisci un agente, avvii una sessione e scambi eventi con l’agente mentre lavora. [Concetti fondamentali](https://platform.claude.com/docs/it/managed-agents/overview#core-concepts) spiega agenti, ambienti, sessioni ed eventi. Non è necessario usare prima il servizio ospitato.
</Note>

## Quando scegliere Managed Agents self-hosted

Scegli Managed Agents self-hosted quando hai bisogno di una delle seguenti cose:

* **Archiviazione sulla tua infrastruttura:** Devi archiviare tu stesso agenti, sessioni e cronologia delle sessioni.
* **La tua scelta del provider di inferenza:** Le chiamate al modello devono essere inviate ad Amazon Bedrock, Claude Models on Google Cloud (Google managed), Microsoft Foundry o al tuo gateway di modelli. Consulta [Provider di inferenza](https://platform.claude.com/docs/it/managed-agents/self-hosted/inference-provider).

Se hai bisogno solo che gli strumenti vengano eseguiti sulla tua infrastruttura, usa le sandbox self-hosted, in cui è Anthropic a eseguire il servizio. Consulta [Scegliere un ambiente per l’agente](https://platform.claude.com/docs/it/managed-agents/choosing-an-environment).

Con Managed Agents self-hosted, esegui e proteggi un server, il suo database e le tue sandbox, e installi ogni versione tu stesso. Alcune funzionalità esistono solo nel servizio ospitato, quindi controlla [Differenze rispetto al servizio ospitato](https://platform.claude.com/docs/it/managed-agents/self-hosted/differences) prima di decidere.

## Cosa viene eseguito e dove

Uno o più server, il loro database e le tue sandbox costituiscono un deployment.

```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]
```

* **Server (`cma-server`):** Fornisce l’API, esegue il ciclo dell’agente e archivia agenti, sessioni e la cronologia di ogni sessione. Chiama il tuo provider di inferenza ogni volta che l’agente ha bisogno del modello. Il server non esegue mai gli strumenti di shell o di file di un agente.
* **Database:** PostgreSQL 16 o successivo. Senza un database, il server mantiene i propri dati in memoria, e un riavvio li cancella.
* **Worker:** Programmi che ricevono lavoro dal server ed eseguono gli strumenti di shell e di file dell’agente nelle tue sandbox. Un worker è un comando `ant beta:worker` o un worker dell’SDK.
* **Le tue applicazioni:** Il tuo codice e i tuoi script, che raggiungono il server con l’SDK o la CLI `ant`.
* **Console sul tuo server:** Una pagina web all’indirizzo del server, dove gli utenti accedono tramite il tuo provider di identità per creare agenti ed eseguire sessioni. Consulta [Usare la console sul tuo server](https://platform.claude.com/docs/it/managed-agents/self-hosted/console).
* **CLI di amministrazione (`cma-server-admin`):** Crea gli ambienti e le relative “environment key” (chiavi di ambiente). Viene eseguita su Linux (x86-64 e Arm) e su macOS con Apple silicon.

## Le tue responsabilità di sicurezza

<Warning>
  Lo strumento `bash` dell’agente è una vera shell con i permessi e l’accesso di rete del processo worker. Il worker non isola quella shell. L’isolamento dipende dall’ambiente in cui viene eseguito il worker. Lo stack Docker Compose e il chart Helm `cma-sandboxes` avviano il worker di ogni sessione in un proprio container o pod. Se avvii tu stesso un worker, eseguilo in un container o in una VM usa e getta che non contenga nulla che tu debba proteggere.
</Warning>

Il [Modello di sicurezza](https://platform.claude.com/docs/it/managed-agents/self-hosted-sandboxes-security) delle sandbox self-hosted si applica qui, con due differenze. Ciò che quella pagina attribuisce ad Anthropic è tua responsabilità, incluso proteggere il server, ospitare i memory store e rilevare un utilizzo insolito. Quella pagina suggerisce inoltre un workspace e un ambiente separati per ogni confine di fiducia. Qui, ogni livello di fiducia richiede un proprio deployment, come spiega [Multitenancy](https://platform.claude.com/docs/it/managed-agents/self-hosted-data-and-access#multitenancy).

## Le tre credenziali

| Credenziale                  | Chi la detiene                                                | Cosa autentica                                                                                                                                                                                                                                                 |
| ---------------------------- | ------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Chiave API del server**    | Le tue applicazioni, la CLI `ant` e la CLI di amministrazione | Le richieste al tuo server. La configurazione genera questa chiave. Svolge il ruolo che una chiave API di Claude svolge con il servizio ospitato.                                                                                                              |
| **Credenziale di inferenza** | Il server                                                     | Le chiamate al modello del server verso il tuo provider di inferenza. Ad esempio, può essere una chiave API di Claude, la credenziale del tuo provider cloud o il token accettato dal tuo gateway di modelli. Le applicazioni e i worker non ne hanno bisogno. |
| **Chiave di ambiente**       | I tuoi worker che interrogano il server                       | La coda di lavoro di un ambiente e le sessioni di quell’ambiente.                                                                                                                                                                                              |

## Cosa esce dalla tua rete

Per ogni chiamata al modello, il server invia al tuo provider di inferenza la conversazione fino a quel momento, inclusi gli input e i risultati degli strumenti. Per impostazione predefinita, si tratta dell’API di Claude. Una chiamata all’API di Claude include anche gli ID della relativa sessione e dell’agente e dell’ambiente di quella sessione. [Dati e accesso in Claude Managed Agents self-hosted](https://platform.claude.com/docs/it/managed-agents/self-hosted-data-and-access) elenca ogni connessione effettuata dal server. Indica anche dove vanno i log e chi può raggiungere il server.

## Da dove iniziare

Per richiedere l’accesso al download, contatta il tuo team di riferimento Anthropic. Poi segui [Iniziare con Claude Managed Agents self-hosted](https://platform.claude.com/docs/it/managed-agents/self-hosted/quickstart) per avviare un server ed eseguire una prima sessione.

L’archivio di ogni release include una guida per l’operatore relativa a quella versione, `operator-guide.md`. Fai leggere quel file a Claude, in modo che Claude possa aiutarti a configurare ed eseguire il tuo server e a scrivere codice che vi si connette.