Panoramica dell'Agent SDK

Installazione

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

pip install claude-agent-sdk

Opzioni SDK

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

• SDK TypeScript - Per applicazioni Node.js e web
• SDK Python - Per applicazioni Python e data science
• Streaming vs Single Mode - Comprendere le modalità di input e le best practice

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.

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:

• SDK TypeScript: Segnala i problemi su GitHub
• SDK Python: Segnala i problemi su GitHub

Changelog

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

• SDK TypeScript: Visualizza CHANGELOG.md
• SDK Python: Visualizza CHANGELOG.md

Risorse correlate

• Riferimento CLI - Documentazione CLI completa
• Integrazione GitHub Actions - Automatizza il tuo flusso di lavoro GitHub
• Documentazione MCP - Estendi Claude con strumenti personalizzati
• Flussi di lavoro comuni - Guide passo dopo passo
• Risoluzione dei problemi - Problemi comuni e soluzioni