Guida all'API Claude: prezzi, configurazione e la tua prima richiesta

Per effettuare la tua prima richiesta API Claude, crea una chiave della Console Claude, memorizzala in una variabile d'ambiente, chiama l'endpoint Messages e leggi il dato restituito utilizzo campi e calcolare il costo in token. Questa guida illustra la procedura da seguire utilizzando gli ID dei modelli e i prezzi attuali, verificati l'8 settembre 2026.

Una volta compreso il percorso dell’API, la domanda successiva è: in che misura il tuo lavoro quotidiano richiede effettivamente un’integrazione personalizzata? Per la ricerca, la scrittura, la programmazione e la produzione creativa, GlobalGPT offre un modo più economico per utilizzare Claude insieme a GPT-5.6 Sol, Gemini 3 Pro, Kimi K3 e altri modelli di punta. Un unico abbonamento riunisce i modelli e un’ampia gamma di strumenti di IA in un’unica dashboard, consentendo di passare dall’idea al risultato finale senza dover ricorrere a servizi separati. Quando è necessario integrare l’IA nel proprio ambiente di sviluppo, la CLI di GlobalGPT collega lo stesso spazio di lavoro al terminale e agli strumenti di produzione esistenti.

Prova Claude Opus 5

Che cos'è l'API Claude?

L'API Claude è l'interfaccia per sviluppatori di Anthropic che consente di inviare richieste strutturate ai modelli Claude da un'applicazione, uno script o un servizio backend. È possibile inviare messaggi a un endpoint HTTPS e ricevere una risposta strutturata contenente il contenuto generato oltre a metadati quali il modello, il motivo dell'interruzione e l'utilizzo del token.

Abbonamenti API Claude vs. Claude.ai

L'accesso all'API e gli abbonamenti a Claude.ai sono destinati a scopi diversi. Un piano Claude.ai consente di accedere al prodotto di chat di Anthropic. L’API è un accesso a consumo per sviluppatori tramite la Console Claude, con fatturazione separata in base all’utilizzo. Il Centro assistenza di Anthropic precisa che Claude Pro non include l’utilizzo dell’API della Console.

Se hai bisogno di una distinzione più ampia tra i piani per i consumatori, il codice Claude e la fatturazione a token, consulta la nostra guida completa Guida ai prezzi Claude. Per questo tutorial, il punto fondamentale è semplice: creare e ricaricare l'account API separatamente da qualsiasi abbonamento a Claude.ai.

Il percorso in cinque fasi per presentare una prima richiesta

1. Crea una chiave API nella console Claude.
2. Conservalo nel ANTHROPIC_API_KEY variabile d'ambiente.
3. Invia una richiesta a https://api.anthropic.com/v1/messages.
4. Leggi il contenuto restituito e utilizzo oggetto.
5. Moltiplicare ciascuna categoria di token per la tariffa applicabile per ogni milione di token.

Prezzi dell'API Claude e ID dei modelli attuali

Anthropic riporta i prezzi delle API in dollari statunitensi per milione di token, spesso abbreviati con MTok. Gli input e gli output vengono fatturati separatamente. La memorizzazione nella cache dei prompt prevede tariffe distinte per le scritture ogni cinque minuti, le scritture ogni ora e le letture dalla cache; pertanto, per ottenere una stima affidabile è necessario tenere separate queste categorie.

Modelli attuali e ID API esatti

Quale modello dovresti usare per questo tutorial?

La guida rapida ufficiale utilizzata claude-opus-5 al momento della verifica di questa guida, pertanto gli esempi relativi a cURL e Python riportati di seguito utilizzano lo stesso ID. Considerate Opus come punto di partenza per il tutorial, quindi scegliete il modello di produzione in base al carico di lavoro, ai requisiti di qualità, alla latenza e al budget. Gli ID dei modelli e lo stato del ciclo di vita possono subire variazioni, pertanto vi consigliamo di ricontrollare le pagine "Modelli" e "Deprecazioni" prima di distribuire codice destinato a una lunga durata.

Cosa ti serve prima della tua prima richiesta

Crea un account Console Claude e una chiave API

Apri la console Claude, crea o seleziona l'organizzazione appropriata e crea una chiave API. Anthropic avverte che una nuova chiave viene visualizzata solo una volta, quindi, quando compare, conservala in un gestore di segreti approvato o in un altro luogo sicuro. Non inserire la chiave in uno screenshot, in un documento condiviso, in un repository pubblico o in codice JavaScript lato browser.

Salva la chiave in una variabile d'ambiente

Negli esempi si presume che la variabile ANTHROPIC_API_KEY. Inserisci il valore reale solo nel tuo terminale privato o nel tuo sistema di gestione dei segreti. Il comando riportato di seguito legge il valore senza visualizzarlo sullo schermo, quindi lo esporta per la sessione corrente della shell:

read -s ANTHROPIC_API_KEY
export ANTHROPIC_API_KEY

Le variabili d'ambiente riducono il rischio di esposizione accidentale, ma non costituiscono una strategia completa per la gestione dei segreti. Le applicazioni di produzione dovrebbero attenersi alle procedure di archiviazione dei segreti e di controllo degli accessi previste dalla piattaforma di hosting.

Controlla l'addebito e scegli un limite di prova sicuro

La fatturazione dell'API è separata dagli abbonamenti a Claude.ai. Anthropic afferma che la maggior parte delle organizzazioni prepaga i crediti di utilizzo, mentre le organizzazioni con fatturazione mensile costituiscono un'eccezione. Verifica che il tuo account Console sia in grado di effettuare richieste API, quindi effettua una prima richiesta di piccole dimensioni con max_tokens: 128. Quel campo limita l'output generato; non riserva né garantisce 128 token di output fatturati.

Invia la tua prima richiesta API Claude con cURL

cURL è utile per visualizzare direttamente il contenuto della richiesta. L'esempio riportato di seguito utilizza l'endpoint Messages, il tipo di contenuto JSON, l'intestazione della chiave API, l'intestazione della versione Anthropic, l'ID verificato del modello Quickstart e un messaggio utente.

Prima di eseguire uno dei due esempi, aggiungi la tua chiave API e verifica che la fatturazione API sia abilitata per l'organizzazione. Il codice segue il formato di richiesta documentato da Anthropic e ha superato i controlli di sintassi locali, ma qui non è inclusa alcuna risposta da un account attivo.

curl https://api.anthropic.com/v1/messages \
  --header "content-type: application/json" \
  --header "x-api-key: $ANTHROPIC_API_KEY" \
  --header "anthropic-version: 2023-06-01" \
  --data '{
    "model": "claude-opus-5",
    "max_tokens": 128,
    "messages": [{
 "role": "user",
 "content": "Rispondi con una frase che spieghi cos'è un'API."
    }]
  }'

Funzioni delle singole intestazioni e dei campi JSON

Se il comando restituisce un errore, controlla lo stato HTTP e il tipo di errore prima di modificare la richiesta. Gli errori di autenticazione e di fatturazione richiedono una correzione dell'account, mentre un JSON non valido o un ID modello non corretto richiedono una modifica della richiesta.

Invia la stessa richiesta con l'SDK Python

Installa l'SDK ufficiale Anthropic

python -m pip install anthropic

Utilizza un ambiente virtuale quando questo rientra nel tuo normale flusso di lavoro in Python. L'SDK legge ANTHROPIC_API_KEY dall'ambiente quando anthropic.Anthropic() viene creato senza una chiave esplicita.

Esegui la richiesta equivalente in Python

import anthropic

client = anthropic.Anthropic()

message = client.messages.create(
    model="claude-opus-5",
    max_tokens=128,
    messages=[
 {
 "role": "user",
 "content": "Rispondi con una frase spiegando cos'è un'API.",
 }
    ],
)

for block in message.content:
    if block.type == "text":
 print(block.text)

print(message.usage)

Leggi il testo restituito in tutta sicurezza

Una risposta di tipo "Message" può contenere più di un blocco di contenuto, pertanto nell'esempio viene verificato il tipo di ciascun blocco prima di visualizzare il testo. Nelle applicazioni reali è inoltre opportuno conservare l'ID della richiesta a fini di assistenza e registrazione, senza renderlo pubblico, registrare il modello restituito e il motivo dell'interruzione, nonché gestire in modo esplicito gli errori dell'API.

Mantieni il controllo del blocco di contenuto anche quando ti aspetti una risposta breve. In questo modo è più facile estendere l'esempio quando una risposta contiene più blocchi, e la stampa message.usage ti fornisce i dati necessari per il calcolo dei costi riportato di seguito.

Come interpretare i dati di consumo e calcolare i costi

Trova il testo della risposta, il modello, il motivo di interruzione e l'ID della richiesta

Il contratto di risposta dell'API Messages include contenuti generati, il modello che ha gestito la richiesta e il motivo dell'interruzione. La risposta HTTP contiene inoltre un identificatore della richiesta che può aiutare il supporto Anthropic a tracciare un problema. Registrare con attenzione gli identificatori; non pubblicarli insieme ai contenuti o alle credenziali dei clienti.

Visualizza l'utilizzo dei token di input, output e cache

Il utilizzo L'oggetto riporta le categorie di token necessarie per l'analisi dei costi. Come minimo, individuare i token di input e di output. Quando si utilizza la memorizzazione nella cache dei prompt, tenere separati gli scritti in cache ogni cinque minuti, quelli ogni ora e le letture dalla cache, poiché hanno tariffe diverse. L’endpoint di conteggio dei token di Anthropic può stimare i token di input prima di una richiesta, ma la stima può differire leggermente dall’utilizzo finale in input e ha i propri limiti di frequenza.

Convertire l'utilizzo dei token in un costo stimato

Calcolare ciascuna categoria separatamente, quindi sommare i risultati. In un esempio di pianificazione che utilizza Claude Opus 5 alle tariffe globali standard, 1.000 token di input non memorizzati nella cache costano 1.000 × $5 / 1.000.000 = $0,005, mentre 300 token di output costano 300 × $25 / 1.000.000 = $0,0075. Il totale stimato è $0.0125. Sostituire questi conteggi di token a titolo esemplificativo con il utilizzo valori ricavati dalla tua risposta.

Calcolatore dei prezzi API Claude

Utilizza il calcolatore per modificare il modello, il numero di richieste, le categorie di token, la modalità di fatturazione e l'area geografica di inferenza. L'elaborazione in batch applica alle utilizzazioni idonee tariffe standard pari a 50%. L'inferenza limitata agli Stati Uniti applica un fattore di 1,1x a tutte le categorie di token per i modelli idonei Claude 4.6+; il modello Claude Haiku 4.5 non è idoneo, pertanto tale combinazione restituisce uno stato non supportato.

Il preventivo è uno strumento di pianificazione, non una fattura. Non include tasse, conversione valutaria, condizioni negoziate, Fast Mode, costi relativi agli strumenti server e condizioni specifiche dell'account. I prezzi e i requisiti di idoneità possono subire variazioni; pertanto, si raccomanda di ricontrollare la pagina ufficiale dei prezzi prima di prendere qualsiasi decisione relativa all'acquisto o all'architettura.

Il calcolatore qui sopra mostra l'andamento dei costi delle chiamate API Claude programmabili e a consumo. Per le attività quotidiane che coinvolgono diversi modelli e funzionalità di intelligenza artificiale, GlobalGPT offre un valore aggiunto di altro tipo: un unico abbonamento riunisce diversi modelli e strumenti di uso comune in un’unica dashboard, rendendo più facile prevedere i costi ed evitando al contempo che attività quali ricerca, scrittura, programmazione e lavoro creativo richiedano abbonamenti separati e si svolgano su interfacce disparate. La sua CLI estende la stessa piattaforma allo sviluppo basato su terminale e agli strumenti di produzione che già utilizzi. La nostra guida a lavorare con più modelli di IA in un unico posto mostra come si incastrano tra loro i vari elementi della piattaforma nel suo complesso.

Errori comuni dell'API Claude e relative soluzioni

Inizia dall'status HTTP e dal tipo di errore Anthropic, quindi esamina la richiesta senza rivelare la chiave. Il significato ufficiale restringe il campo di ricerca; la causa probabile dipende comunque dal tuo account, dal modello selezionato, dalla struttura della richiesta e dal traffico.

Un ordine di debug sicuro

1. Registra lo stato, il tipo di errore, il timestamp e l'ID della richiesta senza registrare la chiave API.
2. Verifica l'endpoint, le intestazioni, la sintassi JSON, l'ID del modello e il limite di dimensione della richiesta.
3. Verificare la fatturazione dell'organizzazione, le autorizzazioni, le intestazioni di limitazione della frequenza e il ciclo di vita attuale del modello.
4. Riprovare solo per gli errori che possono ragionevolmente essere temporanei, utilizzando un backoff esponenziale limitato e un jitter.
5. Se l'errore persiste, riduci la richiesta al caso riproducibile più semplice prima di contattare l'assistenza.

Gli SDK ufficiali di Anthropic effettuano di default due tentativi di riconnessione in caso di errori di connessione, risposte 429 e risposte 5xx. La logica di riprova a livello di applicazione richiede comunque l’impostazione di limiti e il rispetto dell’idempotenza, specialmente quando una richiesta può attivare strumenti o altre azioni esterne.

Come contenere i costi dell'API Claude

Impostare limiti di output prudenti

Inizia dal più piccolo max_tokens valore che può comunque fornire una risposta utile. Misurate l'utilizzo effettivo dell'output prima di aumentarlo. Prompt più brevi possono essere d'aiuto, ma eliminare le istruzioni che impediscono i tentativi ripetuti, gli errori o l'output inutilizzabile può comportare un costo complessivo maggiore.

Utilizza la memorizzazione nella cache dei prompt e l'elaborazione in batch solo quando sono appropriate

• Utilizzare la memorizzazione nella cache dei prompt quando si ripete un prefisso di prompt significativo e la durata della cache è in linea con il flusso di lavoro.
• Utilizza Batch per le attività che possono essere completate in modo asincrono; l'utilizzo di Batch idoneo viene fatturato a 50% secondo le tariffe standard.
• Mantenere separate le operazioni di scrittura e lettura nella cache nei report, in modo che il risparmio sia visibile anziché presunto.
• Utilizzare l’inferenza limitata agli Stati Uniti solo quando il requisito di residenza giustifica il suo fattore di prezzo dei token pari a 1,1x e il modello selezionato è idoneo.

Monitoraggio dell'utilizzo, dei limiti di velocità e dei limiti di spesa

Tieni traccia del numero di richieste, dell’ID del modello, dell’utilizzo in entrata e in uscita, delle categorie di cache, dei tentativi di ripetizione e degli errori. Imposta gli avvisi o i controlli di spesa disponibili per la tua organizzazione, ma non dare per scontato che il livello o il limite di un altro account si applichi al tuo. La nostra guida approfondita su Piani Claude, costi API e limiti copre i percorsi di fatturazione più ampi.

Prossimi passi dopo la prima richiesta

Scegli il percorso giusto per il tuo prossimo progetto

Per l'implementazione, consulta la guida ufficiale all'API Messages di Anthropic, le linee guida sullo streaming, la documentazione sull'uso degli strumenti, le pagine dedicate al ciclo di vita dei modelli e il tuo piano di registrazione e valutazione. Definisci con attenzione una strategia per i modelli, gestisci gli errori prima di aumentare il traffico e calcola i costi in base all'utilizzo effettivo piuttosto che alla sola lunghezza dei prompt.

Se la programmazione è la tua attività principale, la nostra guida a utilizzare Claude AI per la codifica illustra alcuni metodi pratici per passare da un’attività di programmazione interattiva a un flusso di lavoro ripetibile per gli sviluppatori.

Quando uno spazio di lavoro multimodello è lo strumento più adatto

L'accesso diretto tramite API è la soluzione ideale quando è necessaria un'integrazione a livello di codice, la fatturazione per gli sviluppatori, i metadati delle richieste o i controlli ufficiali della piattaforma. Se il tuo obiettivo è la scrittura interattiva, la ricerca, la pianificazione o il confronto dei risultati tra diversi fornitori senza dover sviluppare un'applicazione, un'area di lavoro multimodello potrebbe rivelarsi più pratica.

Domande frequenti

L'API Claude è gratuita?

Non viene garantita alcuna quota gratuita universale per l'API. L'utilizzo dell'API Claude viene fatturato separatamente tramite la Console Claude e, secondo Anthropic, la maggior parte delle organizzazioni finanzia tale utilizzo con crediti prepagati, mentre le organizzazioni con fatturazione mensile costituiscono un'eccezione. Verificate le informazioni aggiornate disponibili nella Console e i prezzi ufficiali relativi alla vostra organizzazione prima di inviare richieste.

Come posso ottenere una chiave API Claude?

Creare una chiave nella console Claude per l'organizzazione corrispondente. Anthropic avverte che la nuova chiave viene visualizzata una sola volta, pertanto è necessario conservarla in modo sicuro quando appare. Caricarla tramite una variabile d'ambiente lato server o un gestore di segreti e non esporla mai nel codice del browser, negli screenshot o in un repository pubblico.

Quale ID del modello Claude devo utilizzare?

Questo tutorial utilizza claude-opus-5 poiché quello era il modello indicato nella guida ufficiale “Quickstart” di Anthropic al momento della verifica, effettuata l’8 settembre 2026. Scegliete il modello più adatto al vostro carico di lavoro e al vostro budget, e ricontrollate le pagine “Modelli” e “Modelli obsoleti” di Anthropic, poiché gli ID dei modelli, gli alias e lo stato del ciclo di vita possono subire variazioni.

Quale endpoint utilizza l'API Claude?

La prima richiesta descritta in questa guida utilizza l'endpoint Messages all'indirizzo https://api.anthropic.com/v1/messages. Invia un oggetto JSON con le intestazioni content-type, x-api-key e anthropic-version. Anthropic offre anche altre funzionalità API, quindi consulta la pagina di riferimento relativa all'operazione che stai implementando.

Claude Pro include crediti API?

Il Centro assistenza di Anthropic precisa che Claude Pro non include l'utilizzo tramite la Console Claude. L'abbonamento a Claude.ai e la fatturazione API sono prodotti distinti. Configura la fatturazione API nella Console per le richieste degli sviluppatori e utilizza il nostro Guida ai prezzi Claude per un confronto più ampio tra i piani.

Quanto costa una richiesta API Claude?

Il costo dipende dal modello selezionato, dai token in ingresso, dai token in uscita, dalle scritture in cache, dalle letture in cache, dalla modalità batch e dall'area geografica idonea per l'inferenza. Per calcolare il costo di ciascuna categoria, moltiplicare il numero di richieste per il numero di token per la tariffa effettiva per milione di token, dividere il risultato per un milione, quindi sommare le singole categorie. Utilizzare il calcolatore qui sopra per ottenere una stima.

Perché ricevo un errore 401?

Il codice 401 indica un errore di autenticazione. Verifica che la chiave API esista, sia attiva, appartenga all'organizzazione desiderata e raggiunga il server nel x-api-key Intestazione. Non stampare né condividere la chiave durante il debug. I ripetuti tentativi non consentiranno di correggere una credenziale mancante o non valida.

Perché mi compare l'errore 429?

Il codice 429 indica che la richiesta ha superato un limite di frequenza. I limiti possono variare a seconda dell'organizzazione e del livello di utilizzo, pertanto è opportuno esaminare le intestazioni relative ai limiti di frequenza restituite, nonché la Console o la documentazione aggiornata. Ridurre il numero di richieste simultanee, rispettare i tempi di riprova e utilizzare un backoff esponenziale limitato con jitter, anziché ripetere immediatamente la stessa sequenza di richieste.

Nota sulla provenienza e sulla freschezza: Gli ID dei modelli, i prezzi, il comportamento dell'API e le politiche di assistenza sono stati verificati sulla base della documentazione ufficiale di Anthropic in data 8 settembre 2026. Si consiglia di consultare le pagine aggiornate relative ai modelli e ai prezzi prima dell'utilizzo in produzione, quindi di eseguire gli esempi utilizzando la propria chiave della console Claude, le impostazioni di fatturazione e l'accesso all'account.