​
Opzioni SDK

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

​
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 esempi di tipi di agenti 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 oncall 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 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 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 sul file system:

  • Subagenti: 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 può utilizzare il tuo agente con permessi granulari:

  • allowedTools - Consenti esplicitamente strumenti specifici
  • disallowedTools - Blocca strumenti specifici
  • permissionMode - Imposta la strategia generale dei permessi

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

​
Risorse Correlate