Panoramica di Claude Managed Agents

Anthropic offre due modi per sviluppare con Claude, ciascuno adatto a casi d'uso diversi:

Claude Managed Agents fornisce l'harness e l'infrastruttura per eseguire Claude come agente autonomo. Invece di costruire il tuo ciclo dell'agente, l'esecuzione degli strumenti e il runtime, ottieni un ambiente completamente gestito in cui Claude può leggere file, eseguire comandi, navigare sul web ed eseguire codice in modo sicuro. L'harness supporta nativamente il "prompt caching" (cache dei prompt), la "compaction" (compattazione) e altre ottimizzazioni delle prestazioni per output dell'agente efficienti e di alta qualità. Per costruire invece il tuo ciclo dell'agente con accesso diretto al modello, consulta Utilizzo della Messages API.



Concetti fondamentali

Claude Managed Agents si basa su quattro concetti:



Come funziona



Quando usare Claude Managed Agents

Claude Managed Agents è ideale per carichi di lavoro che richiedono:

• Esecuzione di lunga durata: attività che durano minuti o ore con più chiamate agli strumenti
• Infrastruttura cloud: sandbox sicure con pacchetti preinstallati e accesso alla rete
• Esecuzione self-hosted: sandbox su infrastruttura sotto il tuo controllo per requisiti di conformità o di residenza dei dati
• Infrastruttura minima: nessuna necessità di costruire il tuo ciclo dell'agente, la tua sandbox o il tuo livello di esecuzione degli strumenti
• Sessioni con stato: filesystem persistenti e cronologia delle conversazioni tra più interazioni
• Esecuzione pianificata: esecuzioni ricorrenti dell'agente secondo una pianificazione cron tramite deployment pianificati



Strumenti supportati

Claude Managed Agents fornisce a Claude l'accesso a un insieme di strumenti integrati:

• Bash: esegui comandi shell nella sandbox
• Operazioni sui file: leggi, scrivi, modifica, esegui glob e grep sui file nella sandbox
• Ricerca web e fetch: cerca sul web e recupera contenuti da URL
• Server MCP: connettiti a fornitori di strumenti esterni

Consulta Strumenti per l'elenco completo e le opzioni di configurazione.



Accesso beta

Per iniziare, hai bisogno di:

1. Una chiave API di Claude
2. L'header beta managed-agents-2026-04-01 su tutte le richieste
3. L'accesso a Claude Managed Agents (abilitato per impostazione predefinita per tutti gli account API)

All'interno della beta, i tunnel MCP e il dreaming sono in una research preview più limitata. Richiedi l'accesso per abilitarli.

Claude Managed Agents è con stato per progettazione: le sessioni sono di lunga durata, riprendono senza problemi dopo le pause e memorizzano lato server la cronologia delle conversazioni, lo stato della sandbox e gli output. Per questo motivo, Managed Agents non è attualmente idoneo alla Zero Data Retention né alla copertura del Business Associate Agreement (BAA) HIPAA. Mantieni il controllo su questi dati: puoi eliminare le sessioni e, separatamente, eliminare qualsiasi file che hai caricato, in qualsiasi momento tramite l'API. Per l'idoneità di tutte le funzionalità, consulta API e conservazione dei dati.

Consulta Limiti di velocità e Linee guida per il branding nel riferimento.