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

​
Installazione

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

​
Opzioni SDK

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

​
Perché utilizzare l’SDK Agent di Claude?

Costruito sopra l’harness dell’agente che alimenta Claude Code, l’SDK Agent di Claude fornisce tutti i blocchi di costruzione necessari per costruire agenti pronti per la produzione. Sfruttando il lavoro che abbiamo fatto su Claude Code incluso:
  • Gestione del Contesto: Compattazione automatica e gestione del contesto per garantire che il tuo agente non rimanga senza contesto.
  • Ecosistema di strumenti ricco: Operazioni sui file, esecuzione di codice, ricerca web ed estensibilità MCP
  • Permessi avanzati: Controllo granulare sulle capacità dell’agente
  • Elementi essenziali per la produzione: Gestione degli errori integrata, gestione delle sessioni e monitoraggio
  • Integrazione Claude ottimizzata: Cache automatica dei prompt e ottimizzazioni delle prestazioni

​
Cosa puoi costruire con l’SDK?

Ecco alcuni tipi di agenti di esempio che puoi creare: Agenti di codifica:
  • Agenti SRE che diagnosticano e risolvono problemi di produzione
  • Bot di revisione della sicurezza che controllano il codice per vulnerabilità
  • Assistenti di ingegneria di guardia che gestiscono gli incidenti
  • Agenti di revisione del codice che applicano stile e migliori pratiche
Agenti aziendali:
  • Assistenti legali che rivedono contratti e conformità
  • Consulenti finanziari che analizzano report e previsioni
  • Agenti di supporto clienti che risolvono problemi tecnici
  • Assistenti per la creazione di contenuti per team di marketing

​
Concetti Fondamentali

​
Autenticazione

Per l’autenticazione di base, recupera una chiave API di Claude dalla Console di Claude e imposta la variabile d’ambiente ANTHROPIC_API_KEY. L’SDK supporta anche l’autenticazione tramite fornitori di API di terze parti:
  • Amazon Bedrock: Imposta la variabile d’ambiente CLAUDE_CODE_USE_BEDROCK=1 e configura le credenziali AWS
  • Google Vertex AI: Imposta la variabile d’ambiente CLAUDE_CODE_USE_VERTEX=1 e configura le credenziali Google Cloud
Per istruzioni di configurazione dettagliate per fornitori di terze parti, consulta la documentazione di Amazon Bedrock e Google Vertex AI.

​
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 su file system:
  • Sottoagenti: Lancia agenti specializzati memorizzati come file Markdown in ./.claude/agents/
  • 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/
  • Memoria (CLAUDE.md): Mantieni il contesto del progetto attraverso file CLAUDE.md che forniscono istruzioni e contesto persistenti
Queste funzionalità funzionano identicamente 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 è dove specifichi che tipo di agente stai costruendo.

​
Permessi degli Strumenti

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

​
Protocollo di Contesto del Modello (MCP)

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

​
Segnalazione di Bug

Se incontri bug o problemi con l’SDK Agent:

​
Risorse Correlate