Agent SDK

Panoramica dell'Agent SDK

Costruisci agenti AI di produzione con Claude Code come libreria

L'SDK di Claude Code è stato rinominato in Claude Agent SDK. Se stai migrando dal vecchio SDK, consulta la Guida alla migrazione.

Costruisci agenti AI che leggono autonomamente i file, eseguono comandi, cercano sul web, modificano il codice e molto altro. 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.

import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions

async def main():
    async for message in query(
        prompt="Find and fix the bug in auth.py",
        options=ClaudeAgentOptions(allowed_tools=["Read", "Edit", "Bash"])
    ):
        print(message)  # Claude reads the file, finds the bug, edits it

asyncio.run(main())

L'Agent SDK include strumenti integrati per leggere file, eseguire comandi e modificare il codice, quindi il tuo agente può iniziare a lavorare immediatamente senza che tu implementi l'esecuzione degli strumenti. Tuffati nella guida rapida o esplora agenti reali costruiti con l'SDK:

Guida rapida

Costruisci un agente di correzione dei bug in pochi minuti

Agenti di esempio

Assistente email, agente di ricerca e altro ancora

Capacità

Tutto ciò che rende potente Claude Code è disponibile nell'SDK:

Funzionalità di Claude Code

L'SDK supporta anche la configurazione basata su filesystem di Claude Code. Per utilizzare queste funzionalità, imposta setting_sources=["project"] (Python) o settingSources: ['project'] (TypeScript) nelle tue opzioni.

Funzionalità	Descrizione	Posizione
Skills	Capacità specializzate definite in Markdown	`.claude/skills/SKILL.md`
Slash commands	Comandi personalizzati per attività comuni	`.claude/commands/*.md`
Memory	Contesto del progetto e istruzioni	`CLAUDE.md` o `.claude/CLAUDE.md`
Plugins	Estendi con comandi personalizzati, agenti e server MCP	Programmatico tramite opzione `plugins`

Inizia

Installa Claude Code
L'SDK utilizza Claude Code come runtime:
Consulta Configurazione di Claude Code per Windows e altre opzioni.
Installa l'SDK
Imposta la tua chiave API
export ANTHROPIC_API_KEY=your-api-key
Ottieni la tua chiave dalla Console.
L'SDK supporta anche l'autenticazione tramite provider API di terze parti:
- Amazon Bedrock: Imposta la variabile di ambiente CLAUDE_CODE_USE_BEDROCK=1 e configura le credenziali AWS
- Google Vertex AI: Imposta la variabile di ambiente CLAUDE_CODE_USE_VERTEX=1 e configura le credenziali di Google Cloud
- Microsoft Foundry: Imposta la variabile di ambiente CLAUDE_CODE_USE_FOUNDRY=1 e configura le credenziali di Azure
Se non precedentemente approvato, non consentiamo agli sviluppatori di terze parti di offrire il login di 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 in questo documento.

Esegui il tuo primo agente

Questo esempio crea un agente che elenca i file nella tua directory corrente utilizzando strumenti integrati.

import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions

async def main():
    async for message in query(
        prompt="What files are in this directory?",
        options=ClaudeAgentOptions(allowed_tools=["Bash", "Glob"])
    ):
        print(message)

asyncio.run(main())

Pronto a costruire? Segui la Guida rapida per creare un agente che trova e corregge i bug in pochi minuti.

Confronta l'Agent SDK con altri strumenti Claude

La piattaforma Claude offre più modi per costruire con Claude. Ecco come si inserisce l'Agent SDK:

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 marchio Claude Code o elementi visivi che imitano Claude Code

Il tuo prodotto dovrebbe mantenere il proprio branding e non sembrare Claude Code o alcun prodotto Anthropic. Per domande sulla conformità del branding, contatta il nostro team di vendita.

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

Guida rapida

Costruisci un agente che trova e corregge i bug in pochi minuti

Agenti di esempio

Assistente email, agente di ricerca e altro ancora

TypeScript SDK

Riferimento API completo di TypeScript ed esempi

Python SDK

Riferimento API completo di Python ed esempi

Agent SDK

Panoramica dell'Agent SDK

Costruisci agenti AI di produzione con Claude Code come libreria

L'SDK di Claude Code è stato rinominato in Claude Agent SDK. Se stai migrando dal vecchio SDK, consulta la Guida alla migrazione.

import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions

async def main():
    async for message in query(
        prompt="Find and fix the bug in auth.py",
        options=ClaudeAgentOptions(allowed_tools=["Read", "Edit", "Bash"])
    ):
        print(message)  # Claude reads the file, finds the bug, edits it

asyncio.run(main())

Guida rapida

Costruisci un agente di correzione dei bug in pochi minuti

Agenti di esempio

Assistente email, agente di ricerca e altro ancora

Capacità

Tutto ciò che rende potente Claude Code è disponibile nell'SDK:

Funzionalità di Claude Code

Funzionalità	Descrizione	Posizione
Skills	Capacità specializzate definite in Markdown	`.claude/skills/SKILL.md`
Slash commands	Comandi personalizzati per attività comuni	`.claude/commands/*.md`
Memory	Contesto del progetto e istruzioni	`CLAUDE.md` o `.claude/CLAUDE.md`
Plugins	Estendi con comandi personalizzati, agenti e server MCP	Programmatico tramite opzione `plugins`

Inizia

Installa Claude Code
L'SDK utilizza Claude Code come runtime:
Consulta Configurazione di Claude Code per Windows e altre opzioni.
Installa l'SDK
Imposta la tua chiave API
export ANTHROPIC_API_KEY=your-api-key
Ottieni la tua chiave dalla Console.
L'SDK supporta anche l'autenticazione tramite provider API di terze parti:
- Amazon Bedrock: Imposta la variabile di ambiente CLAUDE_CODE_USE_BEDROCK=1 e configura le credenziali AWS
- Google Vertex AI: Imposta la variabile di ambiente CLAUDE_CODE_USE_VERTEX=1 e configura le credenziali di Google Cloud
- Microsoft Foundry: Imposta la variabile di ambiente CLAUDE_CODE_USE_FOUNDRY=1 e configura le credenziali di Azure
Se non precedentemente approvato, non consentiamo agli sviluppatori di terze parti di offrire il login di 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 in questo documento.

Esegui il tuo primo agente

Questo esempio crea un agente che elenca i file nella tua directory corrente utilizzando strumenti integrati.

import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions

async def main():
    async for message in query(
        prompt="What files are in this directory?",
        options=ClaudeAgentOptions(allowed_tools=["Bash", "Glob"])
    ):
        print(message)

asyncio.run(main())

Pronto a costruire? Segui la Guida rapida per creare un agente che trova e corregge i bug in pochi minuti.

Confronta l'Agent SDK con altri strumenti Claude

La piattaforma Claude offre più modi per costruire con Claude. Ecco come si inserisce l'Agent SDK:

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 marchio Claude Code o elementi visivi che imitano Claude Code

Il tuo prodotto dovrebbe mantenere il proprio branding e non sembrare Claude Code o alcun prodotto Anthropic. Per domande sulla conformità del branding, contatta il nostro team di vendita.

Licenza e termini

Passaggi successivi

Guida rapida

Costruisci un agente che trova e corregge i bug in pochi minuti

Agenti di esempio

Assistente email, agente di ricerca e altro ancora

TypeScript SDK

Riferimento API completo di TypeScript ed esempi

Python SDK

Riferimento API completo di Python ed esempi