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 si adattano a esigenze diverse. Utilizza la tabella per trovare quello che corrisponde a ciò che stai costruendo.
| Se stai... | Usa | Perché |
|---|---|---|
| Costruendo un agente senza implementare il tool loop da solo | Agent SDK | Una libreria che esegue il ciclo dell'agente nel tuo processo, in Python o TypeScript. |
| Facendo sviluppo interattivo o eseguendo attività una tantum da un terminale | Claude Code CLI | L'interfaccia del terminale, costruita per l'uso interattivo quotidiano. |
| Chiamando l'API direttamente e implementando il tool loop da solo | Client SDK | Accesso diretto all'API Anthropic piuttosto che a Claude Code. Implementi il tool loop da solo. |
| Eseguendo agenti a lunga durata o asincroni senza gestire la tua sandbox o infrastruttura di sessione | Managed Agents | API REST ospitata, un prodotto separato dall'Agent SDK. Anthropic esegue l'agente e la sandbox. |
L'SDK è disponibile come libreria solo per Python e TypeScript. Per guidare lo stesso ciclo dell'agente da un altro linguaggio, 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