Come ottenere una chiave API Claude

Puoi ottenere una chiave API Claude dalla Claude Console di Anthropic per accedere direttamente alle API, oppure creare un account AI Prime Tech per accedere tramite questo gateway indipendente. Scegli prima il fornitore: la chiave, la fatturazione e l'URL di base devono corrispondere. I passaggi seguenti descrivono entrambe le opzioni e mostrano come verificare una chiave del gateway prima di inviare una prima richiesta.

Scegli dove ottenere la tua chiave API Claude

Una chiave API identifica l'account o il progetto a cui vengono addebitate le richieste. Le credenziali di accesso alla chat di Claude e una chiave API hanno scopi diversi. Se desideri l'interfaccia di chat o le funzionalità dell'abbonamento, confronta accesso API e abbonamenti di Claude prima di acquistare l'utilizzo delle API.

AI Prime Tech è gestito in modo indipendente e non è affiliato ad Anthropic né approvato da Anthropic. Usa l'opzione che soddisfa le tue esigenze di integrazione, fatturazione e assistenza; gli account e le chiavi sono separati.

Ottieni una chiave dalla Claude Console ufficiale

1. Accedi alla Claude Console e seleziona lo spazio di lavoro che utilizzerai.
2. Esamina la fatturazione API e i limiti di utilizzo dell'account. Completa tutte le configurazioni richieste dalla Console per il tuo account.
3. Apri Chiavi API, crea una chiave per la tua applicazione e conservala in modo sicuro quando viene visualizzata.
4. Segui la guida rapida ufficiale di Anthropic per le richieste dirette. Mantieni l'endpoint ufficiale per questa opzione; l'esempio del gateway riportato di seguito usa una chiave AI Prime Tech.

Crea una chiave AI Prime Tech

1. Registrati su AI Prime Tech e completa la verifica mostrata durante la registrazione.
2. Scegli crediti API prepagati per la fatturazione a consumo oppure esamina i piani a tempo di Claude. Controlla l'offerta attuale, i modelli idonei e i limiti prima di pagare. Se vuoi prima valutare il servizio, la guida alla prova mostra le eventuali offerte di benvenuto attuali e le relative condizioni.
3. Apri Chiavi API nella dashboard e crea una chiave per questa applicazione. Controlla il gruppo selezionato e le eventuali restrizioni della chiave affinché corrispondano all'accesso a Claude che hai acquistato.
4. Copia la chiave in una variabile d'ambiente locale o in un gestore di segreti. Usa una chiave separata per ogni applicazione, così da poter identificare l'utilizzo e sostituire una chiave senza modificare tutte le integrazioni.

La creazione della chiave e il pagamento non dimostrano che un'integrazione funzioni. Controlla prima il catalogo dei modelli con quella chiave, quindi invia una piccola richiesta al modello che intendi usare.

Verifica la chiave e gli ID dei modelli disponibili

Su macOS, Linux o WSL, imposta la chiave del gateway nel terminale corrente. Sostituisci localmente il segnaposto con la tua chiave; non inserirla in script condivisi o screenshot.

export ANTHROPIC_API_KEY="YOUR_GATEWAY_KEY"

Su Windows PowerShell, usa questa sintassi per la variabile d'ambiente:

$env:ANTHROPIC_API_KEY = "YOUR_GATEWAY_KEY"

Richiedi l'elenco dei modelli. Si tratta di una richiesta al catalogo; non genera una risposta da un modello. Il comando seguente è per una shell compatibile con Bash:

curl --fail-with-body --silent --show-error \
  https://aiprimetech.io/v1/models \
  -H "Authorization: Bearer $ANTHROPIC_API_KEY"

Per PowerShell:

$headers = @{ Authorization = "Bearer $env:ANTHROPIC_API_KEY" }
(Invoke-RestMethod "https://aiprimetech.io/v1/models" -Headers $headers).data | Select-Object id

Una risposta riuscita elenca gli ID dei modelli disponibili per la chiave. Scegli un modello Claude e copia il suo id esattamente in CLAUDE_MODEL. L'accesso ai modelli può dipendere dal gruppo e dalle autorizzazioni della chiave; una risposta del catalogo, da sola, non garantisce che un modello a monte completi una richiesta.

export CLAUDE_MODEL="PASTE_A_CLAUDE_MODEL_ID_FROM_THE_RESPONSE"
# PowerShell alternative:
# $env:CLAUDE_MODEL = "PASTE_A_CLAUDE_MODEL_ID_FROM_THE_RESPONSE"

Prima di collegare un agente, verifica che la chiave usi il gruppo corrispondente all'accesso scelto. La checklist di configurazione dell'agente collega questa verifica alla guida dello strumento appropriato.

Invia la tua prima richiesta Python

Installa l'SDK Python di Anthropic nell'ambiente del tuo progetto, salva l'esempio come test_claude.pyed eseguilo dal terminale in cui hai impostato la chiave e il modello. Questa richiesta usa il modello selezionato ed è soggetta alla fatturazione o al piano del tuo account.

python -m pip install anthropic

import os
import anthropic

# Set CLAUDE_MODEL to an exact Claude model ID returned for your key.
client = anthropic.Anthropic(
    api_key=os.environ["ANTHROPIC_API_KEY"],
    base_url="https://aiprimetech.io",
)
message = client.messages.create(
    model=os.environ["CLAUDE_MODEL"],
    max_tokens=64,
    messages=[{"role": "user", "content": "Reply with hello."}],
)
for block in message.content:
    if block.type == "text":
        print(block.text)

python test_claude.py

Per questo SDK, l'URL di base del gateway è https://aiprimetech.io senza /v1; l'SDK costruisce il percorso della Messages API. I client che usano il formato compatibile con OpenAI generalmente usano https://aiprimetech.io/v1. Consulta la guida all'SDK Python di Anthropic o guida all'API compatibile con OpenAI nel formato richiesto dalla tua applicazione.

Dopo aver ricevuto la risposta, controlla i dettagli delle richieste e dell'utilizzo nella dashboard. Per la CLI, prosegui con la configurazione della chiave API di Claude Code; per un IDE, segui la guida a Cursor.

Se la tua chiave API di Claude non funziona

Dove trovare e gestire la tua chiave

Apri Chiavi API nella dashboard del provider che ha emesso la chiave. Usa i controlli disponibili per copiarla, mostrarla e revocarla. Se non riesci a recuperare un segreto utilizzabile, crea una chiave sostitutiva e revoca quella precedente dopo aver aggiornato la tua applicazione.

Non inserire le chiavi nel controllo di versione, nelle segnalazioni pubbliche o nel JavaScript eseguito nel browser. Se una chiave viene esposta, sostituiscila e controllane l'utilizzo. Un cookie di sessione del browser non sostituisce una chiave API.

Una chiave API di Claude è gratuita?

Creare una chiave e pagare per l'utilizzo dei modelli sono passaggi distinti. Le condizioni attuali dell'account Anthropic sono riportate nella sua Console. Su AI Prime Tech, la guida alla prova mostra le eventuali offerte di benvenuto disponibili; i pagina di ricarica e pagina pubblica dei piani mostrano le opzioni a pagamento continuative.

Verifica i requisiti di idoneità e l'offerta mostrata durante la registrazione. Un credito temporaneo o una prova non garantiscono un utilizzo gratuito a tempo indeterminato.

Domande frequenti

AI Prime Tech è un gateway API indipendente. Non è affiliato ad Anthropic, non è approvato da Anthropic e non è un suo rivenditore. Claude e i nomi dei modelli correlati sono marchi dei rispettivi proprietari.