​
Perché utilizzare il Claude Code SDK?

Costruito sopra l’harness dell’agente che alimenta Claude Code, il Claude Code SDK fornisce tutti i blocchi di costruzione necessari per costruire agenti pronti per la produzione:

  • Integrazione Claude ottimizzata: Cache automatica dei prompt e ottimizzazioni delle prestazioni
  • Ecosistema di strumenti ricco: Operazioni sui file, esecuzione di codice, ricerca web ed estensibilità MCP
  • Permessi avanzati: Controllo granulare sulle capacità dell’agente
  • Essenziali per la produzione: Gestione degli errori integrata, gestione delle sessioni e monitoraggio

​
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 selezionano 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

​
Opzioni SDK

Il Claude Code SDK è disponibile in più forme per adattarsi a diversi casi d’uso:

​
Concetti Fondamentali

​
Autenticazione

Per l’autenticazione di base, recupera una chiave API Anthropic dalla Console Anthropic 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 Amazon Bedrock e Google Vertex AI.

​
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.

​
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 di permessi generale

​
Model Context Protocol (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.

​
Casi d’Uso Comuni

​
Test Automatizzati e CI/CD

Crea agenti che eseguono test, analizzano risultati e risolvono problemi automaticamente nella tua pipeline CI/CD.

​
Revisione del Codice e Audit di Sicurezza

Costruisci agenti che rivedono le pull request per vulnerabilità di sicurezza, qualità del codice e conformità.

​
Risposta agli Incidenti

Distribuisci agenti SRE che diagnosticano problemi di produzione, analizzano log e suggeriscono correzioni.

​
Generazione di Documentazione

Crea agenti che generano e mantengono documentazione basata sul tuo codebase.

​
Analisi dei Dati

Costruisci agenti che analizzano dati, generano report e creano visualizzazioni.

​
Migliori Pratiche

  • Usa il formato di output JSON per l’analisi programmatica delle risposte
  • Gestisci gli errori con grazia - controlla i codici di uscita e implementa la logica di retry
  • Usa la gestione delle sessioni per mantenere il contesto nelle conversazioni multi-turno
  • Implementa timeout per operazioni di lunga durata
  • Rispetta i limiti di velocità quando fai più richieste
  • Testa accuratamente prima di distribuire in produzione

​
Risorse Correlate