--- type: Blog Post title: "Claude Code Agent SDK: La Guida Completa per Creare Agenti IA (2026)" description: "Guida completa al Claude Code Agent SDK: crea agenti IA autonomi con tool personalizzati, gestione conversazioni e deployment in produzione nel 2026." resource: "https://www.contextstudios.ai/it/blog/claude-code-agent-sdk-la-guida-completa-per-creare-agenti-ia-2026" tags: [Claude Code, Agent SDK, Agenti IA, Python, Tutorial, Anthropic, MCP, Sviluppo IA, Automazione] language: it timestamp: "2026-05-31T12:51:54.136Z" --- # Claude Code Agent SDK: La Guida Completa per Creare Agenti IA (2026) Claude Code Agent SDK: La Guida Completa per Creare Agenti IA (2026) Vuoi creare il tuo primo agente IA ma non sai da dove iniziare? Il Claude Code Agent SDK di Anthropic lo rende possibile – anche senza conoscenze approfondite di programmazione. In questa guida completa, ti mostreremo passo dopo passo come creare agenti IA autonomi in grado di gestire autonomamente compiti complessi. --- Cosa Imparerai in Questa Guida - Cosa sono gli agenti IA e come differiscono dai chatbot - Come funziona il Claude Code Agent SDK - Esempi di codice pratici per il tuo primo agente - Strumenti, sotto-agenti e integrazione MCP - Best practice per agenti pronti per la produzione --- Cos'è un Agente IA? (E Perché è Diverso da ChatGPT?) Prima di immergerci nel codice, chiariamo un concetto fondamentale: Cosa distingue un agente IA da un chatbot ordinario? Chatbot vs Agente | Caratteristica | Chatbot (es. ChatGPT) | Agente IA | |----------------|----------------------|-----------| | Interazione | Domanda → Risposta | Obiettivo → Esecuzione autonoma | | Esecuzione | Singola richiesta | Ciclo fino al raggiungimento dell'obiettivo | | Strumenti | Limitati | Infinitamente estensibili | | Autonomia | Nessuna | Decisioni indipendenti | Un chatbot risponde alle tue domande. Un agente IA lavora autonomamente verso un obiettivo, utilizzando vari strumenti e prendendo le proprie decisioni lungo il percorso. Il Pattern Agent Loop Ogni agente IA segue un pattern fondamentale – il cosiddetto Agent Loop: Esempio pratico: Chiedi a un agente di pianificare un viaggio. L'agente: 1. Raccoglie contesto: Chiede data, budget, preferenze 2. Esegue azioni: Cerca voli, hotel, attività 3. Verifica: Tutto rientra nel budget? Gli orari sono compatibili? 4. Ripete: Finché un piano di viaggio completo è pronto --- Cos'è il Claude Code Agent SDK? Il Claude Code Agent SDK è lo stesso framework che Anthropic utilizza internamente per Claude Code – il loro potente assistente di codifica. Fornisce tutto ciò di cui hai bisogno per creare agenti IA pronti per la produzione. Funzionalità Principali dell'SDK | Funzionalità | Descrizione | |--------------|-------------| | Compressione Automatica del Contesto | Gestisce intelligentemente finestre di contesto ampie | | Ecosistema di Strumenti | Operazioni su file, esecuzione codice, ricerca web | | Controlli Permessi | Controllo granulare sulle azioni dell'agente | | Estensibilità MCP | Integrazione servizi esterni via Model Context Protocol | | Sotto-agenti | Delega a sotto-agenti specializzati | | Sistema Hooks | Workflow basati su eventi | Perché Scegliere il Claude Code Agent SDK? 1. Testato in produzione: Lo stesso sistema che alimenta Claude Code 2. Boilerplate minimo: Meno codice, più funzionalità 3. Strumenti integrati: Operazioni su file, Bash, Web pronti all'uso 4. Nativo MCP: Integrazione fluida con Model Context Protocol --- Avvio Rapido: Installazione e Configurazione Prerequisiti - Python 3.10 o superiore - Chiave API Anthropic (da console.anthropic.com) Passo 1: Installare l'SDK Passo 2: Configurare la Chiave API Passo 3: Testare la Prima Connessione --- Esempio Pratico 1: Agente Q&A Semplice Iniziamo con l'agente più semplice – uno che risponde alle domande: Cosa fa questo codice: 1. Crea un client con un prompt di sistema 2. Avvia un ciclo interattivo 3. Invia l'input dell'utente a Claude 4. Restituisce la risposta in streaming --- Esempio Pratico 2: Agente con Memoria Un agente con memoria di conversazione può ricordare i messaggi precedenti: Testa la memoria: --- Esempio Pratico 3: Agente con Strumenti È qui che diventa interessante! Gli agenti con strumenti possono eseguire azioni reali: Strumenti Integrati Disponibili | Strumento | Funzione | Esempio | |-----------|----------|---------| | Read | Leggere file | Read("config.json") | | Write | Scrivere file | Write("output.txt", content) | | Edit | Modificare file | Edit(file, old, new) | | Glob | Cercare file | Glob("/.py") | | Grep | Cercare testo | Grep("TODO", "src/") | | Bash | Eseguire comandi | Bash("npm install") | | WebFetch | Recuperare contenuti web | WebFetch(url, prompt) | --- Esempio Pratico 4: Agente Pianificatore di Viaggi Autonomo Costruiamo ora un agente completamente autonomo: --- Funzionalità Avanzate: Integrazione MCP Il Model Context Protocol (MCP) permette l'integrazione di servizi esterni: Includere Server MCP Creare il Proprio Server MCP --- Sotto-agenti: Agenti Specializzati Per compiti complessi, puoi usare sotto-agenti – agenti specializzati che gestiscono sotto-compiti: Quando Usare i Sotto-agenti? | Situazione | Raccomandazione | |------------|-----------------| | Compiti semplici e lineari | ❌ Nessun sotto-agente necessario | | Compiti paralleli e indipendenti | ✅ Usa sotto-agenti | | Richiesta competenza specializzata | ✅ Usa sotto-agenti | | Workflow lunghi e complessi | ✅ Usa sotto-agenti | --- Hooks: Workflow Basati su Eventi Gli Hooks permettono azioni automatizzate su eventi specifici: Tipi di Hook | Hook | Quando Attivato | Caso d'Uso | |------|-----------------|------------| | PreToolUse | Prima dell'esecuzione strumento | Validazione, logging | | PostToolUse | Dopo l'esecuzione strumento | Post-elaborazione, alert | | Notification | Su eventi importanti | Notifiche | | Stop | A fine sessione | Pulizia, reporting | --- Best Practice per Agenti Pronti per la Produzione 1. Prompt di Sistema Chiari 2. Impostare i Permessi in Modo Granulare 3. Implementare la Gestione degli Errori 4. Gestione del Contesto --- Costi e Selezione del Modello Modelli Disponibili | Modello | Alias | Punti di Forza | Costo | |---------|-------|----------------|-------| | Claude Opus 4.5 | opus | Massima qualità, compiti complessi | $$$ | | Claude Sonnet 4 | sonnet | Miglior rapporto qualità/costo | $$ | | Claude Haiku | haiku | Veloce, economico | $ | Raccomandazione Modello per Caso d'Uso | Caso d'Uso | Modello Raccomandato | |------------|----------------------| | Q&A semplice | Haiku | | Agenti generali | Sonnet | | Generazione codice | Sonnet | | Analisi complesse | Opus | | Agenti di ricerca | Opus | --- Riepilogo: Il Tuo Percorso verso il Primo Agente Checklist per Iniziare - [ ] Python 3.10+ installato - [ ] Chiave API Anthropic creata - [ ] claude-agent-sdk installato - [ ] Agente Q&A semplice testato - [ ] Agente con memoria provato - [ ] Strumenti aggiunti - [ ] Agente autonome costruito Prossimi Passi 1. Sperimenta: Inizia con l'agente Q&A semplice 2. Estendi: Aggiungi strumenti secondo necessità 3. Specializza: Crea agenti specifici per dominio 4. Scala: Usa sotto-agenti per workflow complessi 5. Proteggi: Implementa hook per ambienti di produzione --- Domande Frequenti (FAQ) Qual è la differenza tra Claude Code e il Claude Agent SDK? Claude Code è l'assistente di codifica completo di Anthropic – un prodotto finito che puoi usare nel tuo terminale. Il Claude Agent SDK è il framework sottostante che ti permette di costruire i tuoi agenti per qualsiasi caso d'uso. L'SDK ti dà i blocchi di costruzione che alimentano anche Claude Code. Ho bisogno di conoscenze di programmazione per l'SDK? Conoscenze base di Python sono utili ma non strettamente necessarie. Puoi seguire gli esempi semplici di questa guida anche senza esperienza approfondita di programmazione. Tuttavia, per agenti pronti per la produzione, raccomandiamo solide basi di Python. Quanto costa usare il Claude Agent SDK? Usare l'SDK stesso è gratuito. Paghi solo per le chiamate API a Claude. Sonnet costa circa 3$ per milione di token in ingresso e 15$ per milione di token in uscita (gennaio 2026). Per sviluppo e test, raccomandiamo di iniziare con contesti piccoli. Posso usare l'SDK con altri modelli IA? Il Claude Agent SDK è specificamente ottimizzato per i modelli Claude. Per altri modelli come GPT-4 o Gemini, esistono SDK alternativi come OpenAI Agents SDK o Google ADK. Tuttavia, i concetti (Agent Loop, Strumenti, Memoria) sono trasferibili. Come proteggo il mio agente per l'uso in produzione? Tre passi importanti: 1. Imposta permission_mode su "manual" o "acceptEdits" invece di "acceptAll" 2. Definisci esplicitamente allowed_tools con solo gli strumenti necessari 3. Implementa hook per controlli di sicurezza e logging Per applicazioni critiche, aggiungi approvazioni umane nel ciclo. --- Risorse Aggiuntive - Documentazione Ufficiale: docs.claude.com/en/api/agent-sdk - Blog Ingegneria Anthropic: anthropic.com/engineering - Specifica MCP: modelcontextprotocol.io - Claude Code: anthropic.com/claude-code --- > Questa guida è stata creata per sviluppatori e appassionati di IA che muovono i primi passi con gli agenti IA. Il Claude Code Agent SDK è in continua evoluzione – visita la documentazione ufficiale per gli ultimi aggiornamenti.