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 file, eseguono comandi, cercano sul web, modificano codice e altro ancora. 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 codice, quindi il tuo agente può iniziare a lavorare immediatamente senza che tu implementi l'esecuzione dello strumento. 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

Inizia

Installa l'SDK
Imposta la tua chiave API
Ottieni una chiave API dalla Console, quindi impostala come variabile di ambiente:
export ANTHROPIC_API_KEY=your-api-key
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 Azure: imposta la variabile di ambiente CLAUDE_CODE_USE_FOUNDRY=1 e configura le credenziali di Azure
Consulta le guide di configurazione per Bedrock, Vertex AI o Azure AI Foundry per i dettagli.
Se non precedentemente approvato, Anthropic non consente agli sviluppatori di terze parti di offrire 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 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"])
    ):
        if hasattr(message, "result"):
            print(message.result)

asyncio.run(main())

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

Capacità

Tutto ciò che rende Claude Code potente è 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`

Confronta l'Agent SDK con altri strumenti Claude

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

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 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 TypeScript completo ed esempi

Python SDK

Riferimento API Python completo ed esempi

Was this page helpful?

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

Inizia

Installa l'SDK
Imposta la tua chiave API
Ottieni una chiave API dalla Console, quindi impostala come variabile di ambiente:
export ANTHROPIC_API_KEY=your-api-key
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 Azure: imposta la variabile di ambiente CLAUDE_CODE_USE_FOUNDRY=1 e configura le credenziali di Azure
Consulta le guide di configurazione per Bedrock, Vertex AI o Azure AI Foundry per i dettagli.
Se non precedentemente approvato, Anthropic non consente agli sviluppatori di terze parti di offrire 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 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"])
    ):
        if hasattr(message, "result"):
            print(message.result)

asyncio.run(main())

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

Capacità

Tutto ciò che rende Claude Code potente è 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`

Confronta l'Agent SDK con altri strumenti Claude

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

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 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 TypeScript completo ed esempi

Python SDK

Riferimento API Python completo ed esempi

Was this page helpful?