Come ottenere una chiave API Claude (guida 2026)

Risposta rapida: tre passi per una chiave API Claude

Per ottenere una chiave API Claude da Anthropic: crea un account su console.anthropic.com, acquista crediti prepagati sotto Plans and billing (è richiesta una carta di credito o debito), poi apri Settings, vai su API Keys e clicca Create Key. La chiave inizia con sk-ant- ed è mostrata esattamente una volta, quindi copiala subito in un password manager o in una variabile d'ambiente. Due cose confondono le persone. Primo, un abbonamento chat Claude Pro o Max non include l'accesso API; la Console è un prodotto separato con fatturazione separata. Secondo, le richieste falliscono con un errore di credito finché non hai effettivamente acquistato crediti, anche se la creazione della chiave in sé funziona senza pagamento. Se la tua prima chiamata restituisce un errore sul saldo, è per questo motivo. Se non puoi aggiungere una carta, o vuoi una sola chiave che raggiunga Claude oltre ad altre famiglie di modelli, un gateway prepagato è l'alternativa pratica. Quella strada è coperta alla fine di questa guida, con i compromessi dichiarati chiaramente.

Passo 1: crea un account Anthropic Console

La Console su console.anthropic.com è la dashboard sviluppatori di Anthropic, ed è distinta dall'app di chat claude.ai. Iscriviti con un indirizzo email o un account Google. Anthropic chiede di verificare un numero di telefono durante l'onboarding, e l'accesso API è limitato ai paesi supportati, quindi controlla la lista di disponibilità di Anthropic se il flusso di iscrizione si blocca a questo passo. Durante la configurazione crei un'organizzazione. Chiavi, crediti, rate limit e log di utilizzo appartengono tutti all'organizzazione piuttosto che al tuo login personale. Questo conta più avanti se inviti dei collaboratori: tutti condividono lo stesso pool di crediti, e gli admin possono vedere l'utilizzo suddiviso per chiave. A questo stadio non costa ancora niente. Puoi sfogliare la lista dei modelli, leggere la API reference e aprire il Workbench, un playground da browser per testare i prompt contro i modelli Claude, prima di aggiungere qualsiasi dettaglio di fatturazione. Il Workbench è utile per verificare che un prompt si comporti come ti aspetti prima di scrivere una riga di codice di integrazione.

Passo 2: imposta la fatturazione prima della prima richiesta

L'API di Anthropic è prepagata. Sotto Plans and billing, aggiungi una carta e acquista un blocco iniziale di crediti; l'acquisto minimo è ridotto, storicamente cinque dollari. Ogni chiamata API detrae da questo saldo a tariffe per token, quindi non c'è nessuna fattura a sorpresa a fine mese. Quando il saldo arriva a zero, le richieste si fermano. Due impostazioni vale la pena configurare fin dal primo giorno. L'auto-reload ricarica automaticamente il saldo quando scende sotto una soglia che imposti tu. Attivalo per i carichi di lavoro in produzione, così un saldo esaurito non si trasforma mai in un'interruzione. Lascialo disattivato per gli esperimenti, così un loop fuori controllo non può spendere più di quanto hai deliberatamente caricato. I rate limit scalano con i tier di utilizzo. Le nuove organizzazioni partono dal tier più basso, e i limiti su richieste al minuto e token al minuto salgono man mano che cresce la tua spesa cumulativa. Se vedi risposte 429 durante un picco di traffico su un account giovane, di solito la causa è il sistema dei tier, non il tuo codice.

Passo 3: crea la chiave ed effettua la prima chiamata

Nella Console, apri Settings, poi API Keys, poi Create Key. Dai alla chiave un nome che identifichi l'app o l'ambiente a cui appartiene, perché prima o poi ne avrai diverse e le chiavi senza nome diventano impossibili da controllare. Il valore completo della chiave è mostrato solo al momento della creazione; dopo aver chiuso il dialogo, la Console mostra solo una versione troncata. Esporta la chiave come variabile d'ambiente e testala dal terminale prima di toccare il codice dell'applicazione. Due dettagli specifici di Anthropic sorprendono chi migra da altri provider: l'autenticazione usa un header x-api-key invece di Authorization: Bearer, e ogni richiesta deve includere un header anthropic-version. Un header di versione mancante fallisce con un messaggio d'errore chiaro, quindi leggi il corpo della risposta quando qualcosa si rompe.

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "Say hello in five words."}]
  }'

Sicurezza della chiave: cinque abitudini che evitano una brutta settimana

Queste abitudini sono economiche da adottare il primo giorno e costose da recuperare dopo un incidente. Se committi una chiave per errore, trattala come trapelata anche in un repository privato: revocala, ruotala e ripulisci la cronologia dei commit. Scanner di segreti come gitleaks in un pre-commit hook individuano l'errore prima che esca dalla tua macchina.

• Solo variabili d'ambiente o un secrets manager. Una chiave incollata nel codice sorgente finirà prima o poi per essere committata, e gli scraper monitorano i repository pubblici proprio per il prefisso sk-ant-.
• Una chiave per app e per ambiente. Chiavi separate per development, staging e production rendono i log di utilizzo leggibili e ti permettono di revocare una superficie senza rompere le altre.
• Non spedire mai una chiave in codice browser o mobile. Qualsiasi cosa in JavaScript lato client è pubblica per definizione. Instrada le chiamate attraverso il tuo backend e tieni la chiave lato server.
• Revoca immediatamente in caso di sospetta fuga. Eliminare una chiave nella Console la disattiva istantaneamente; crea prima la chiave sostitutiva se l'app deve restare attiva durante la rotazione.
• Imposta notifiche di spesa. Una soglia di allerta sulla fatturazione trasforma una chiave trapelata o in loop da una fattura enorme in una piccola, e non costa nulla configurarla.

Quanto costa una chiamata a Claude, con le alternative più economiche a fianco

Claude è fatturato per token, con tariffe separate per input e output, e i token di output dominano il conto nella generazione long-form. Confronta entrambe le colonne, non solo il prezzo di input in evidenza. Per dare un'idea di scala, la tabella qui sotto elenca Claude accanto ad altri modelli disponibili tramite il catalogo del gateway descritto nella sezione successiva. DeepSeek è il favorito approssimativo della community per traffico economico ad alto volume, e Claude resta la scelta quando la qualità della prosa è la priorità.

Niente carta? Ottieni una chiave funzionante tramite un gateway

Se il requisito della carta, un blocco regionale o la creazione dell'account stessa sono l'ostacolo, APIsRouter è la strada del gateway documentata da questo sito. È un gateway compatibile OpenAI: il checkout su /topup non richiede registrazione, paghi prima, e la chiave arriva via email. La fatturazione è pay-as-you-go senza abbonamento. I modelli globali costano il 20% in meno del listino ufficiale, i modelli cinesi stanno sotto le loro tariffe ufficiali, e la tua prima ricarica aggiunge 100% al saldo. Punta qualsiasi SDK OpenAI su https://api.apisrouter.com/v1 e passa un ID modello dal catalogo: claude-sonnet-4-6 o claude-opus-4-7 per la famiglia Claude, deepseek-v4-flash o glm-5 quando vuoi token più economici dalla stessa chiave. La stessa chiave funziona anche in app per l'utente finale. Gli utenti di SillyTavern incollano il base URL che termina in /v1 e la lista dei modelli si popola automaticamente da /v1/models. JanitorAI ha bisogno dell'endpoint completo https://api.apisrouter.com/v1/chat/completions più un nome modello e la chiave. Il compromesso rispetto a una chiave Anthropic diretta è onesto e semplice: stai affidando il tuo traffico a un intermediario, e le funzionalità lato Anthropic arrivano secondo i tempi del gateway. Il vantaggio è un solo saldo e un solo endpoint per Claude, GPT, Gemini, DeepSeek e GLM invece di un account di fatturazione separato per provider.

from openai import OpenAI

client = OpenAI(
    api_key="sk-...",  # arrives by email after checkout
    base_url="https://api.apisrouter.com/v1",
)

response = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "Say hello in five words."}],
)
print(response.choices[0].message.content)

Domande frequenti