SpyBara
Go Premium

agent-sdk/overview.md 2026-10-22 22:58 UTC to 2026-10-23 22:59 UTC

This page contains 18 additions and 18 deletions.

2026
Thu 15 23:58 Tue 20 23:00 Thu 22 22:58 Fri 23 22:59

Panoramica dell'Agent SDK

Costruisci agenti AI di produzione con Claude Code come libreria

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 i 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.

Desideri Usa Cosa ottieni
Incorporare l'agente di Claude Code nella tua applicazione Python o TypeScript, in un processo che gestisci Agent SDK Una libreria che esegue il binario di Claude Code, con le capacità di Claude Code, come strumenti integrati, permessi, sessioni e hooks.
Fare sviluppo interattivo o eseguire attività una tantum da un terminale Claude Code CLI L'interfaccia del terminale, costruita per l'uso interattivo quotidiano.
Chiamare l'API Claude direttamente dal tuo codice Client SDK Accesso diretto all'API Claude da uno qualsiasi dei linguaggi del client SDK. Scrivi il tool loop da solo, oppure lascia che il tool runner beta del client SDK lo gestisca.
Avere Anthropic ospitare l'agente, configurato tramite l'API Claude Managed Agents Un harness agente ospitato che esegue il ciclo dell'agente, con sessioni in una sandbox cloud gestita da Anthropic o una sandbox auto-ospitata sulla tua infrastruttura. Usalo dall'SDK per il tuo linguaggio, dalla CLI ant, o dall'API REST.

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:

Capacità Cosa fa Scopri di più
Built-in tools Leggi, scrivi, modifica file, esegui comandi e cerca sul web Tools reference
Hooks Esegui codice personalizzato in punti chiave del ciclo di vita dell'agente Hooks
Subagents Genera agenti specializzati per sottoattività mirate Subagents
MCP Connetti strumenti e fonti di dati esterne tramite il Model Context Protocol MCP
Permissions Controlla quali strumenti vengono eseguiti automaticamente, quali richiedono approvazione Permissions
Sessions Mantieni il contesto tra gli scambi, riprendi o dividi in seguito Sessions
Skills, commands, and memory Carica automaticamente da .claude/ del tuo progetto e da ~/.claude/, come Claude Code Skills, Commands, Memory, Caricamento della configurazione
Plugins Pacchetto skills, agenti, hooks e server MCP, e caricali per percorso locale Plugins

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.

[!NOTE]

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