Corso
Claude Code 101
3 ore
28.3K
Usare la Claude API di Anthropic ti permette di andare oltre la semplice chat con un chatbot. Ti dà la possibilità di integrare tutte le capacità di Claude AI nelle tue applicazioni.
Anthropic ha sconvolto il mondo dell’AI con il rilascio di Fable 5, un modello così potente che ha spinto il governo statunitense a limitarne temporaneamente l’accesso poco dopo il lancio. Anche se il modello è stato poi ripristinato per gli utenti di tutto il mondo, è cambiato il modo in cui vi si accede.
Anthropic ora limita Fable 5 esclusivamente all’accesso via API con crediti a consumo (con la scadenza effettiva dopo una breve estensione di cinque giorni).
Questo significa che dobbiamo ripensare a come interagiamo con l’AI. Modelli ad alte prestazioni e strumenti di coding automatizzato richiedono molte più risorse computazionali di quante ne possano offrire i piani consumer a tariffa fissa.
In questo tutorial ti preparerò a questa nuova realtà mostrando come usare la Claude API.
Ti insegnerò esattamente come configurare Claude Code con l’Anthropic Developer API. Passando oggi al modello pay-as-you-go, ti assicurerai un accesso ininterrotto a modelli all’avanguardia come Fable 5, eliminerai i limiti di velocità invisibili e imparerai a eseguire sessioni di coding complesse direttamente dal terminale.
Se cerchi un riferimento rapido, ti consiglio di dare un’occhiata al cheat sheet della Claude API in Python.
Perché ti serve la Claude API invece di un abbonamento Claude Pro
Per molti, il piano mensile da 20 $ di Claude Pro era il modo ideale per accedere a un’AI di alto livello. Offriva un prezzo fisso e un accesso costante.
Tuttavia, l’ascesa degli strumenti di coding automatizzati ha cambiato completamente i conti. I workflow agentici richiedono molte più risorse di quelle che un abbonamento standard può fornire, rendendo la Claude API l’unica opzione praticabile per gli sviluppatori seri.
Di seguito trovi tre motivi principali per abbandonare l’abbonamento e usare Claude Code direttamente tramite API.
Esaurimento dei token con strumenti agentici
I piani standard faticano con strumenti come Claude Code per via del loro modo di operare.
A differenza di una semplice chat web, uno strumento di sviluppo automatizzato deve scansionare costantemente l’intero progetto per capire su cosa sta lavorando.
Ogni volta che gli diamo un compito, passa attraverso vari passaggi: leggere file, controllare strutture ed eseguire test. Questo richiede l’invio di una quantità enorme di dati avanti e indietro per mantenere l’AI aggiornata sullo stato corrente del nostro codice.
Questo processo consuma token molto rapidamente. Con un abbonamento Pro, questi workflow complessi possono esaurire il nostro limite di utilizzo di più ore in pochi minuti, bloccando all’improvviso il lavoro.
Proteggere la tua capacità di utilizzo giornaliera
Gli account Claude Pro usano un unico pool di risorse condivise. Se usiamo il nostro account principale per il coding da terminale, quelle attività automatizzate pesanti ridurranno la capacità che abbiamo per il browser o l’app mobile.
Non vorremmo rimanere bloccati fuori da una semplice conversazione perché un’attività di coding in background ha raggiunto il tetto. Instradare i tuoi strumenti di sviluppo tramite la Claude API mantiene il tuo lavoro di coding professionale completamente separato dall’uso quotidiano dell’AI.
Accesso esclusivo a modelli ad alta intensità
Man mano che Anthropic rilascia modelli pensati specificamente per l’ingegneria pesante e il lavoro autonomo, come Claude Fable 5, si sta allontanando dai piani a tariffa fissa.
Poiché Fable 5 richiede una potenza di calcolo enorme, Anthropic ha confermato che questo modello in particolare richiederà alla fine una fatturazione a consumo per gestire gli alti costi operativi.
Questa limitazione è un’anteprima del futuro. Restare a un abbonamento consumer significa che alla fine perderai l’accesso ai motori di ragionamento più potenti di Anthropic, rendendo un account Claude API un requisito imprescindibile per restare all’avanguardia.
Claude API vs abbonamento Claude
La differenza tra un abbonamento consumer e la developer API si riduce a un compromesso tra costi prevedibili e accesso ininterrotto.
Un abbonamento a Claude ci dà una tariffa mensile fissa.
Possiamo usarlo intensamente per un po’, e alla fine raggiungeremo un limite d’uso dinamico basato sul carico del server. Quando Claude Code colpisce questo muro invisibile a metà progetto, smette completamente di funzionare.
Siamo costretti ad aspettare diverse ore perché il limite si resetti prima che l’agente possa finire di scrivere il nostro codice.
La Claude API rimuove queste rotelle. Non ci sono limiti orari ai messaggi, né larghezza di banda condivisa, né tempi di attesa. Se vogliamo che Fable 5 effettui il refactor di un’enorme codebase per otto ore di fila, l’API eseguirà felicemente ogni singolo comando senza interruzioni.
Tuttavia, questa libertà introduce un pericolo significativo: lo sforamento del budget. Usare un abbonamento può essere frustrante quando si raggiunge il limite, ma almeno sappiamo esattamente quanto sarà la bolletta a fine mese.
Questo è particolarmente rischioso con modelli costosi come Fable 5.
Gestione dei costi della Claude API e controllo del budget
Ci sono due modi per controllare il nostro budget quando usiamo l’API.
Il primo è assicurarci che l’auto-ricarica sia disattivata. L’auto-ricarica consentirà a Claude di acquistare automaticamente crediti quando si esauriscono.
Poiché l’uso dei token con Claude Code è altamente imprevedibile, sconsiglio vivamente di abilitarla.
Il secondo è selezionare con attenzione quale modello usare.
Fable 5 è estremamente capace nel risolvere compiti complessi e implementare applicazioni articolate. Tuttavia, spesso è eccessivo per attività più semplici.
Personalmente preferisco usare i modelli più economici e passare a quelli più costosi solo quando i modelli economici non riescono a risolvere un compito dopo vari tentativi. Il modello che uso di più è in realtà Haiku 4.5.
Per selezionare il modello, usa il comando /model.
Configurazione passo passo della Claude API (con Fable 5)
Se cerchi un tutorial dedicato alla Claude Fable 5 API, ti consiglio di consultare la nostra guida separata.
Per iniziare, accedi a la piattaforma web di Claude e configura la fatturazione. Poi apri un terminale e installa Claude Code con il comando:
npm install -g @anthropic-ai/claude-codeUna volta installato, possiamo eseguirlo digitando claude nel terminale. Al primo avvio ci chiederà di configurarlo. Assicurati di selezionare “API usage billing” durante la configurazione:
Alla fine, Claude aprirà il browser e chiederà il permesso di collegare il nostro account e creare una chiave API per noi. Clicca su “Authorize” e l’account verrà collegato automaticamente.
Completata la configurazione, siamo pronti a iniziare a costruire con Claude Code:
Nel mio caso, Claude Code sta già girando con Fable 5. Se non fosse così, possiamo selezionare il modello usando il comando /model e scegliere Fable 5 dal menu.
Passare Claude Code da abbonamento ad API
Per chi usa già Claude Code con un abbonamento e vuole passare alla fatturazione via API, il processo è semplice.
- Esegui il logout con il comando
/logout. - Avvia di nuovo Claude Code con il comando
claudee seleziona il metodo di login “Anthropic Console account · API usage billing”.
Se dovessimo rimanere senza crediti mentre Claude Code sta implementando una funzionalità, si fermerà e ti farà sapere che è necessario aggiungere crediti.
Dopo aver aggiunto i crediti, se Claude è ancora in esecuzione, chiedigli semplicemente di proseguire con un prompt e riprenderà da dove si era fermato. Se non è in esecuzione, usa il comando claude --continue.
Creare un progetto reale con la Claude API
L’obiettivo di questo tutorial è imparare a configurare Claude Code con l’API piuttosto che fornire una guida dettagliata su come usare Claude Code.
Se vuoi saperne di più, ti consiglio di iscriverti al nostro corso Claude Code 101.
Panoramica del progetto
L’obiettivo di questo progetto è costruire un’app Python che permetta agli utenti di trovare facilmente le foto sul proprio computer.
Oggi si scattano tante foto, che spesso finiscono disordinate e sparse in più posizioni. Personalmente, da fotografo, è spesso un mal di testa rintracciare una foto mesi dopo averla scattata.
L’idea dell’app è permettere agli utenti di trovare le loro foto descrivendo cosa c’è nello scatto oppure fornendo uno screenshot o un’immagine di riferimento.
Questa seconda modalità è particolarmente utile per me, dato che spesso pubblico i miei lavori sui social: mi consentirebbe di fare semplicemente uno screenshot del post e trovare il file originale in alta qualità.
Potremmo lasciare che Claude Code definisca l’architettura del progetto e si occupi di tutta l’implementazione. Probabilmente funzionerebbe senza problemi.
Ma per fini didattici ho voluto definire personalmente l’architettura del progetto e lasciare a Claude Code il focus sull’implementazione.
Architettura del progetto con CLAUDE.md
Per creare questa app, ho creato un file CLAUDE.md che descrive l’architettura del progetto.
Un file CLAUDE.md è un file di configurazione Markdown specifico del progetto che Claude Code legge all’inizio di ogni sessione per stabilire una memoria persistente della tua architettura, degli standard di coding e delle preferenze di workflow.
L’app ha due componenti principali:
- Un processo di ingestion delle foto che permette all’utente di selezionare una cartella con immagini, convertirle in vettori e archiviarle in un database vettoriale.
- Un input multimodale che consente all’utente di cercare nel database.
Per codificare le immagini in vettori usiamo il modello CLIP. Per il database usiamo ChromaDB, che gira in locale gratuitamente.
L’intuizione di fondo è che il modello CLIP è addestrato per convertire testo e immagini in vettori (una rappresentazione numerica dei dati) in modo tale che immagini visivamente simili o con concetti simili vengano posizionate vicine su questa mappa, mentre le immagini non correlate vengano allontanate.
Quando vogliamo trovare un’immagine, convertiamo anche la query in un vettore di ricerca e usiamo ChromaDB per trovare i vettori più vicini al vettore di query.
Se vuoi saperne di più sui database vettoriali, consulta questo tutorial su ChromaDB: una guida passo passo.
Il prompt
Con l’architettura del progetto specificata nel file CLAUDE.md, ho avviato un terminale in quella cartella e ho dato a Claude Code in esecuzione con il modello Fable 5 il seguente prompt:
Build a desktop graphical app for my photography search engine with Python.
First, plan the application architecture exactly as outlined in the CLAUDE.md file, ensuring the GUI can handle both folder ingestion and searching.
Create a virtual environment, install the necessary dependencies (including customtkinter and raw image processing libraries), and save them to requirements.txt.
Write the application logic, paying special attention to background threading for the ingestion process. Il risultato
Ho inviato il prompt e lasciato che Claude Code facesse la sua magia. Dopo circa sette minuti, aveva finito.
Ho eseguito l’app, ed ecco come si presentava:
Ho caricato alcune immagini scattate quest’anno e poi sono andato su Instagram per fare uno screenshot di un mio post da usare come immagine di riferimento.
Ho volutamente incluso tutta l’UI per rendere più difficile all’app trovare l’immagine sorgente. Ecco cosa ho ottenuto:
Devo dire che funziona piuttosto bene e l’interfaccia è esattamente come l’avevo immaginata. L’ho testata anche con la ricerca testuale provando a trovare foto di Taipei 101, l’edificio più alto di Taiwan.
Ecco i risultati:
Uso dei token della Claude API e costi reali
In totale, creare questo progetto è costato 3,65 $ in token API. Possiamo ottenere un dettaglio dei costi di una sessione con il comando /cost:
Curiosamente, vediamo che ha usato anche claude-haiku-4.5 per parte del lavoro.
Questo mostra che Fable 5 è piuttosto costoso.
Una sessione di sette minuti su un progetto vuoto ci è già costata 3,65 $.
Immagino quindi quanto potrebbe costare usare Fable 5 su un progetto esistente con centinaia di file di codice.
Naturalmente, nel mondo reale, quando si costruisce un’applicazione vera che genera anche ricavi, questi costi vanno valutati in modo diverso, perché diventano un investimento.
Funzionalità avanzate della Claude API da conoscere
Passare all’API apre strumenti che Claude.ai non offre: cache dei prompt, elaborazione in batch e integrazione con tool.
Se usi Claude Code, instradi volumi elevati di chiamate API o costruisci sistemi agentici che interagiscono con servizi esterni, queste sono le funzionalità che incidono di più su costi e latenza.
1. Cache dei prompt (riduzione dei costi)
La cache dei prompt conserva sul server le porzioni statiche della tua finestra di contesto tra le chiamate API, così smetti di pagare per rielaborare gli stessi contenuti a ogni richiesta.
Se lavori con Claude Code, è probabile che tu invii lo stesso contesto ampio a ogni chiamata (un file CLAUDE.md, un riassunto della codebase o un lungo system prompt). Secondo la documentazione di Anthropic sulla cache, i prefissi in cache riducono i costi di input fino al 90% e abbreviano il time-to-first-token perché il prefisso salta la re-ingestione.
La prima richiesta paga il prezzo pieno dell’input. Ogni chiamata successiva che colpisce lo stesso prefisso di cache viene fatturata a tariffa ridotta.
2. La Batch API (elaborazione asincrona)
La Batch API gestisce carichi di lavoro che non necessitano di risposte in tempo reale.
Elaborare 10.000 ticket di supporto clienti, generare documentazione per un’intera codebase o eseguire eval su un ampio set di test: tutti casi adatti al batch. Anthropic prezza le richieste batch al 50% dei costi standard dei token di input e output, e l’intero job viene inviato in un’unica chiamata API invece di richiedere la gestione di una coda.
La limitazione è che i job batch impiegano fino a 24 ore per completarsi e i risultati arrivano insieme, non in streaming. Va benissimo per pipeline offline, ma è inadeguato per tutto ciò che è rivolto agli utenti.
3. Uso degli strumenti e Model Context Protocol (MCP)
L’uso degli strumenti (a volte chiamato function calling) consente a Claude di invocare funzioni esterne durante la generazione e integrare i risultati nella sua risposta.
Definisci gli strumenti disponibili in formato JSON Schema; Claude decide quando chiamarli, quali argomenti passare e come usare l’output. Claude può quindi interrogare un database, chiamare una REST API o eseguire uno script Python senza che tu debba specificare nel prompt il punto esatto di invocazione.
Il Model Context Protocol (MCP) estende questo con un’interfaccia server standardizzata: invece di definire strumenti per progetto, Claude si connette a un server MCP locale che espone accesso ai file, esecuzione di codice o letture da database.
La Computer Use API funziona diversamente. Claude interpreta uno screenshot ed emette eventi di tastiera e mouse, navigando nelle interfacce senza accesso API programmabile all’applicazione sottostante.
Conclusione
Passare alla Claude API è un passo necessario per eseguire strumenti di sviluppo automatizzati, ma richiede un cambiamento nel modo in cui gestiamo i progetti.
Fable 5 è indiscutibilmente un modello di coding eccezionale, capace di generare applicazioni complesse e pienamente funzionanti a partire da un singolo prompt.
La sua capacità di ragionamento può trasformare una visione architetturale in una realtà funzionale in pochi minuti, il che è davvero impressionante.
Tuttavia, usare la Claude API per questo livello di potenza ha un prezzo. Poiché modelli come Fable 5 sono così costosi da operare, è fondamentale essere strategici nella selezione del modello.
Ti consiglio di affidarti a modelli più economici ed efficienti per le attività di routine e riservare Fable 5 quando incontri veri ostacoli o sfide architetturali complesse che richiedono un ragionamento più profondo.
Come abbiamo visto con il nostro progetto, anche per un’app relativamente semplice a file singolo, i costi dei token API possono aumentare rapidamente. Proteggi il tuo portafoglio tenendo d’occhio l’utilizzo e, soprattutto, disabilitando l’auto-ricarica per evitare che una sessione di coding automatizzata sfugga al controllo del tuo budget.
Se vuoi saperne di più sull’ecosistema Claude, ti suggerisco di consultare il nostro corso Claude 101.
