Sandbox self-hosted

Per impostazione predefinita, Managed Agents esegue strumenti e codice all'interno di sandbox cloud gestite da Anthropic. Le sandbox self-hosted mantengono l'orchestrazione dal lato di Anthropic, ma spostano l'esecuzione degli strumenti in un'infrastruttura che controlli tu. I file, i processi e il traffico di rete dell'agente rimangono nel tuo ambiente.

Il self-hosting è adatto quando l'agente deve:

• Operare su dati che non possono uscire dal perimetro della tua rete
• Raggiungere servizi interni che non sono instradabili pubblicamente
• Essere eseguito sotto i controlli di conformità e audit della tua organizzazione

Come funziona

Un ambiente self_hosted funge da coda di lavoro. Esegui un environment worker (worker dell'ambiente), un processo sulla tua infrastruttura che serve quella coda:

1. Crei una sessione che ha come destinazione l'ambiente. Anthropic accoda la sessione come elemento di lavoro.
2. Il tuo worker acquisisce l'elemento di lavoro e scarica le skill dell'agente e i memory store della sessione.
3. Claude viene eseguito dal lato di Anthropic e richiede chiamate agli strumenti. Il tuo worker esegue ogni chiamata localmente e invia il risultato.

Gli input e gli output degli strumenti continuano a fluire verso il control plane di Anthropic, in modo che il modello possa vedere i risultati e determinare cosa fare dopo. Anthropic archivia le skill e i memory store. La tua sandbox ne conserva una copia per la sessione. Consulta Modello di sicurezza per il perimetro completo del flusso di dati.

Le sandbox self-hosted supportano tutti i modelli Claude disponibili in Managed Agents. Il modello è configurato sull'agente, non sull'ambiente.

La CLI ant e gli SDK Python, TypeScript e Go includono worker predefiniti. Anche provider di sandbox come Cloudflare, Daytona e Modal pubblicano le proprie guide per piattaforma.

Guida rapida

Questa guida rapida esegue un worker sempre attivo con la CLI ant, gli invia una sessione e conferma che le chiamate agli strumenti dell'agente sono state eseguite sul tuo host.

Prerequisiti

• Un agente: Se non ne hai uno, completa prima Inizia con Claude Managed Agents e annota l'ID dell'agente.
• Un host Linux: L'host deve avere /bin/bash esattamente in quel percorso. Il worker necessita solo di HTTPS in uscita.
• Una chiave API Claude: La usi dalla tua macchina per creare sessioni e leggere le statistiche della coda. Tienila lontana dall'host del worker, dove le chiamate agli strumenti dell'agente potrebbero leggerla.
• La CLI ant sulla tua macchina: I comandi per sessioni e statistiche di questa guida rapida vengono eseguiti lì, non sull'host del worker. Installala nello stesso modo in cui lo fa il passaggio di installazione per il worker.

Esegui la tua prima sessione

1. 1

   Crea un ambiente self-hosted

   Nella Console: Workspace > Environments > New > Self-hosted

   Oppure tramite l'API:

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   

   ant apply environment.yaml

   environment.yaml

   

   # yaml-language-server: $schema=https://platform.claude.com/schemas/ant/beta/environment.json
   name: self-hosted
   config:
     type: self_hosted

2. 2

   Genera una chiave dell'ambiente

   Nella Console, apri l'ambiente e fai clic su Generate environment key. La chiave dell'ambiente autentica il worker presso la sua coda. Puoi generarne una solo nella Console, anche per un ambiente creato tramite l'API.

   Esporta l'ID dell'ambiente e la chiave sull'host del worker:

   export ANTHROPIC_ENVIRONMENT_KEY="sk-ant-oat01-..."
   export ANTHROPIC_ENVIRONMENT_ID="env_..."

   
3. 3

   Installa la CLI ant

   Esegui questo sull'host del worker.

   curl (Linux/WSL)Homebrew (macOS)

   curl (Linux/WSL)

   Per gli ambienti Linux, scarica direttamente il binario della release.

   VERSION=1.40.0
   OS=$(uname -s | tr '[:upper:]' '[:lower:]')
   case $(uname -m) in
     x86_64) ARCH=amd64 ;;
     aarch64) ARCH=arm64 ;;
   esac
   curl -fsSL "https://github.com/anthropics/anthropic-cli/releases/download/v${VERSION}/ant_${VERSION}_${OS}_${ARCH}.tar.gz" \
     | sudo tar -xz -C /usr/local/bin ant

   

   Puoi trovare tutte le release nella pagina delle release su GitHub.

4. 4

   Avvia il worker

   Crea la directory di lavoro, quindi avvia il worker. --workdir ha come valore predefinito la directory corrente, quindi passa /workspace per corrispondere al valore predefinito del sistema.

   sudo mkdir -p /workspace && sudo chown "$USER" /workspace
   ant beta:worker poll --workdir /workspace

   

   Il worker legge le due variabili che hai esportato ed esegue il polling finché non lo arresti.

5. 5

   Verifica che il worker sia connesso

   Sulla tua macchina, imposta ANTHROPIC_API_KEY sulla tua chiave API Claude (non sulla chiave dell'ambiente) e ANTHROPIC_ENVIRONMENT_ID sull'ID dell'ambiente. Conferma che workers_polling sia almeno 1:

   ant beta:environments:work stats --environment-id "$ANTHROPIC_ENVIRONMENT_ID"

   

   Se workers_polling rimane a 0, consulta Risoluzione dei problemi.

6. 6

   Avvia una sessione

   Imposta AGENT_ID sull'ID del tuo agente. Crea una sessione che ha come destinazione l'ambiente, quindi inviale un'attività:

   SESSION_ID=$(ant beta:sessions create \
     --agent "$AGENT_ID" \
     --environment-id "$ANTHROPIC_ENVIRONMENT_ID" \
     --transform id --raw-output)
   
   ant beta:sessions:events send --session-id "$SESSION_ID" <<'YAML'
   events:
     - type: user.message
       content:
         - type: text
           text: Write the output of "uname -a" to hello.txt in your working directory.
   YAML

   

   La sessione attende nella coda dell'ambiente finché un worker non l'acquisisce. Se nessun worker è connesso, la sessione rimane in coda anziché fallire.

7. 7

   Conferma che gli strumenti siano stati eseguiti sul tuo host

   Sull'host del worker, leggi il file scritto dall'agente:

   cat /workspace/hello.txt

   

   Il file descrive il kernel del tuo host, quindi le chiamate agli strumenti dell'agente sono state eseguite lì. Per seguire il lavoro dell'agente mentre avviene, consulta Stream di eventi della sessione.

Differenze rispetto agli ambienti cloud

Per l'idoneità a Zero Data Retention e HIPAA BAA, consulta API e conservazione dei dati.

Risorse della sessione

Le sandbox self-hosted supportano solo risorse memory_store. Una sessione su un ambiente self-hosted che include una risorsa file o github_repository viene rifiutata con un errore 400:

Environment env_... is a self-hosted environment. `resources` are not supported with self-hosted environments.

I deployment che hanno come destinazione un ambiente self-hosted seguono la stessa regola. Per fornire a una sessione i propri file di input, consulta Prepara i file per una sessione.

Sandbox self-hosted e tunnel MCP

Il self-hosting controlla dove viene eseguito il codice dell'agente. I tunnel MCP controllano come Anthropic raggiunge i server MCP nella tua rete. I due sono indipendenti:

• Una sessione nelle sandbox cloud di Anthropic può raggiungere server MCP privati tramite un tunnel.
• Una sessione self-hosted può usare server MCP tramite tunnel o pubblici.

Usali entrambi quando vuoi che l'esecuzione e l'accesso agli strumenti rimangano all'interno del tuo perimetro. Per evitare il tunnel, incapsula il server MCP come strumenti personalizzati serviti dal tuo worker.

Guide per piattaforma

Queste pagine descrivono come creare un worker su qualsiasi piattaforma di sandboxing. Sono disponibili anche guide specifiche per piattaforma:

• AWS Lambda MicroVMs
• Blaxel
• Cloudflare
• Daytona
• E2B
• Fly.io
• GKE Agent Sandbox
• Modal
• Namespace
• Superserve
• Vercel

Prossimi passi