Skip to main content
Un agente è un’applicazione che completa un’attività pianificando i propri passaggi e chiamando strumenti che leggono file, eseguono comandi o modificano codice. L’Agent SDK ti offre gli stessi strumenti, il ciclo dell’agente e la gestione del contesto che alimentano Claude Code, programmabili in Python e TypeScript.

​
Confronta l’Agent SDK con altri strumenti Claude

L’Agent SDK, la CLI, il Client SDK e gli Managed Agents differiscono per chi esegue l’agente, cosa è incluso di default e come lo raggiungi. Trova la riga che corrisponde a come desideri costruire ed eseguire il tuo. Per guidare lo stesso ciclo dell’agente da un linguaggio diverso da Python o TypeScript, esegui la CLI come sottoprocesso con il flag -p e --output-format json.

​
Capacità

Queste capacità di Claude Code sono disponibili nell’SDK:

​
Iniziare

Segui la Guida rapida per installare l’SDK, impostare la tua chiave API e costruire il tuo primo agente, uno che trova e corregge i bug nel codice esistente.
Se non precedentemente approvato, Anthropic non consente ai sviluppatori di terze parti di offrire l’accesso a claude.ai o limiti di velocità per i loro prodotti, inclusi gli agenti costruiti su Claude Agent SDK. Utilizza invece i metodi di autenticazione con chiave API descritti nella Guida rapida.

​
Changelog

Visualizza il changelog completo per gli aggiornamenti dell’SDK, le correzioni di bug e le nuove funzionalità:

​
Segnalazione di bug

Se riscontri bug o problemi con l’Agent SDK:

​
Linee guida di branding

Per i partner che integrano Claude Agent SDK, l’uso del branding Claude è facoltativo. Quando fai riferimento a Claude nel tuo prodotto: Consentito:
  • “Claude Agent”, preferito per i menu a discesa
  • “Claude”, quando già all’interno di un menu etichettato “Agents”
  • “{YourAgentName} Powered by Claude”, se hai un nome di agente esistente
Non consentito:
  • “Claude Code” o “Claude Code Agent”
  • Arte ASCII con branding Claude Code o elementi visivi che imitano Claude Code
Il tuo prodotto dovrebbe mantenere il suo proprio branding e non sembrare Claude Code o alcun prodotto Anthropic. Per domande sulla conformità del branding, contatta il team di vendita di Anthropic.

​
Licenza e termini

L’uso di Claude Agent SDK è disciplinato dai Termini di servizio commerciali di Anthropic, incluso quando lo utilizzi per alimentare prodotti e servizi che metti a disposizione dei tuoi clienti e utenti finali, tranne nella misura in cui un componente o una dipendenza specifica è coperta da una licenza diversa come indicato nel file LICENSE di quel componente.

​
Passaggi successivi

Queste risorse coprono dettagli tecnici più approfonditi e progetti di esempio per la creazione con l’Agent SDK.
  • Quickstart: costruisci il tuo primo agente che trova e corregge i bug
  • Guida alla migrazione: migra dai pacchetti Claude Code SDK all’Agent SDK
  • Agent loop: come Claude pianifica, chiama gli strumenti e decide quando un’attività è completata
  • Example agents: app demo per lo sviluppo locale
  • TypeScript SDK: riferimento API TypeScript completo ed esempi
  • Python SDK: riferimento API Python completo ed esempi
  • Agent harness design: come il team Claude Code utilizza i flussi di lavoro dinamici per orchestrare molti subagenti contemporaneamente