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 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.
| 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, Configuration loading |
| 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.
Changelog
Visualizza il changelog completo per gli aggiornamenti dell'SDK, le correzioni di bug e le nuove funzionalità:
- TypeScript SDK: visualizza CHANGELOG.md
- Python SDK: visualizza CHANGELOG.md
Segnalazione di bug
Se riscontri bug o problemi con l'Agent SDK:
- TypeScript SDK: segnala i problemi su GitHub
- Python SDK: segnala i problemi su GitHub
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