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

​
Installazione

npm install @anthropic-ai/claude-agent-sdk

​
Opzioni SDK

L’Agent SDK di Claude è disponibile in più forme per adattarsi a diversi casi d’uso:

​
Perché usare l’Agent SDK di Claude?

Costruito sulla base dell’agent harness che alimenta Claude Code, l’Agent SDK di Claude fornisce tutti i blocchi di costruzione di cui hai bisogno per creare agenti pronti per la produzione. Sfruttando il lavoro che abbiamo svolto su Claude Code, incluso:
  • Gestione del contesto: Compattazione automatica e gestione del contesto per garantire che il tuo agente non esaurisca il contesto.
  • Ricco ecosistema di strumenti: Operazioni su file, esecuzione di codice, ricerca web ed estensibilità MCP
  • Autorizzazioni avanzate: Controllo granulare sulle capacità dell’agente
  • Elementi essenziali per la produzione: Gestione degli errori integrata, gestione delle sessioni e monitoraggio
  • Integrazione Claude ottimizzata: Caching automatico dei prompt e ottimizzazioni delle prestazioni

​
Cosa puoi costruire con l’SDK?

Ecco alcuni esempi di tipi di agenti che puoi creare: Agenti di codifica:
  • Agenti SRE che diagnosticano e risolvono i problemi di produzione
  • Bot di revisione della sicurezza che controllano il codice per le vulnerabilità
  • Assistenti di ingegneria oncall che esaminano gli incidenti
  • Agenti di revisione del codice che applicano lo stile e le best practice
Agenti aziendali:
  • Assistenti legali che esaminano i contratti e la conformità
  • Consulenti finanziari che analizzano i rapporti e le previsioni
  • Agenti di supporto clienti che risolvono i problemi tecnici
  • Assistenti per la creazione di contenuti per i team di marketing

​
Concetti fondamentali

​
Autenticazione

Per l’autenticazione di base, recupera una chiave API Claude dalla Console Claude e imposta la variabile di ambiente ANTHROPIC_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
Per istruzioni di configurazione dettagliate per i provider di terze parti, consulta la documentazione di Amazon Bedrock e Google Vertex AI.
Se non precedentemente approvati, non consentiamo agli sviluppatori di terze parti di applicare i limiti di velocità di Claude.ai 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.

​
Supporto completo delle funzionalità di Claude Code

L’SDK fornisce accesso a tutte le funzionalità predefinite disponibili in Claude Code, sfruttando la stessa configurazione basata sul file system:
  • Subagenti: Avvia agenti specializzati archiviati come file Markdown in ./.claude/agents/
  • Competenze dell’agente: Estendi Claude con capacità specializzate archiviate come file SKILL.md in ./.claude/skills/
  • Hook: Esegui comandi personalizzati configurati in ./.claude/settings.json che rispondono agli eventi degli strumenti
  • Comandi Slash: Usa comandi personalizzati definiti come file Markdown in ./.claude/commands/
  • Plugin: Carica plugin personalizzati a livello di programmazione utilizzando l’opzione plugins per estendere Claude Code con comandi personalizzati, agenti, competenze, hook e server MCP. Consulta Plugin per i dettagli.
  • Memoria (CLAUDE.md): Mantieni il contesto del progetto attraverso file CLAUDE.md o .claude/CLAUDE.md nella directory del tuo progetto, o ~/.claude/CLAUDE.md per istruzioni a livello di utente. Per caricare questi file, devi impostare esplicitamente settingSources: ['project'] (TypeScript) o setting_sources=["project"] (Python) nelle tue opzioni. Consulta Modifying system prompts per i dettagli.
Queste funzionalità funzionano in modo identico alle loro controparti di Claude Code leggendo dalle stesse posizioni del file system.

​
Prompt di sistema

I prompt di sistema definiscono il ruolo, l’expertise e il comportamento del tuo agente. È qui che specifichi che tipo di agente stai costruendo.

​
Autorizzazioni degli strumenti

Controlla quali strumenti il tuo agente può utilizzare con autorizzazioni granulari:
  • allowedTools - Consenti esplicitamente strumenti specifici
  • disallowedTools - Blocca strumenti specifici
  • permissionMode - Imposta la strategia di autorizzazione generale

​
Model Context Protocol (MCP)

Estendi i tuoi agenti con strumenti e integrazioni personalizzati attraverso i server MCP. Questo ti consente di connetterti a database, API e altri servizi esterni.

​
Segnalazione di bug

Se riscontri bug o problemi con l’Agent SDK:

​
Changelog

Visualizza il changelog completo per gli aggiornamenti dell’SDK, le correzioni di bug e le nuove funzionalità:

​
Risorse correlate