Ottieni la tua chiave API di Claude

Le "API keys" (chiavi API) per la Claude API (chiamate anche chiavi API Anthropic) si trovano nella Claude Console. Per visualizzare le tue chiavi esistenti o crearne una nuova, vai a Settings → API keys.

Scegli un tipo di chiave

Quando crei una chiave, ne scegli il tipo, che determina cosa può fare la chiave, dove funziona e quando smette di funzionare. Una chiave personale agisce come te e smette di funzionare se lasci un'organizzazione. Una chiave di service account rappresenta un service account che può essere utilizzato da carichi di lavoro come pipeline CI, servizi di produzione o agenti. Usa una chiave personale per il tuo sviluppo e una chiave di service account per tutto ciò che è condiviso.

Puoi anche creare una chiave di workspace, una chiave legacy senza proprietario: appartiene al workspace in cui la crei e continua a funzionare dopo che il suo creatore se ne va. È preferibile usare una chiave personale o di service account, poiché queste smettono di funzionare automaticamente quando l'account associato viene rimosso dall'organizzazione.

Crea una chiave API

1. 1

   Accedi alla Claude Console

   Vai a platform.claude.com e accedi, oppure crea un account se non ne hai ancora uno.

2. 2

   Apri la pagina delle chiavi API

   Vai a Settings → API keys.

3. 3

   Crea una chiave

   Fai clic su Create key, assegna un nome alla chiave, scegli una scadenza e imposta Linked account su te stesso o su un service account. Puoi anche scegliere un workspace a cui limitare l'ambito della chiave.

4. 4

   Copia e conserva la chiave

   La Console mostra la chiave completa, che inizia con sk-ant-, una sola volta, al momento della creazione. Copiala e conservala in un luogo sicuro, come un gestore di segreti. Se perdi una chiave, non puoi visualizzarla di nuovo nella Console. Crea invece una nuova chiave.

Se il pulsante Create key nella pagina delle chiavi API è disabilitato, il tuo ruolo potrebbe non consentirti di creare chiavi lì. Chiedi a un amministratore dell'organizzazione di modificare il tuo ruolo o di creare una chiave di service account per il tuo carico di lavoro.

Usa la tua chiave API

Imposta la chiave come variabile d'ambiente:

export ANTHROPIC_API_KEY="sk-ant-api03-..."

Gli SDK client leggono ANTHROPIC_API_KEY automaticamente. Le richieste HTTP dirette inviano la chiave nell'header x-api-key. Se la tua chiave API funziona su più workspace, devi anche inviare l'header anthropic-workspace-id in ogni richiesta alla Claude API, come mostrato in Seleziona un workspace. Per l'Admin API, consulta Chiavi API e Admin API.

Per effettuare la tua prima richiesta, segui il Quickstart e consulta Autenticazione per il quadro completo, incluse le credenziali a breve durata con Workload Identity Federation.

Chiavi API e Admin API

L'Admin API include endpoint per gestire le chiavi API della tua organizzazione in modo programmatico, come Retrieve API Key e List API Keys. Questi endpoint sono destinati agli amministratori dell'organizzazione che automatizzano la gestione delle chiavi. Accettano una chiave Admin API, un token OAuth con lo scope org:admin, oppure una chiave personale o di service account che non sia limitata a un workspace specifico; le chiavi di workspace non funzionano lì. Non restituiscono mai il valore segreto di una chiave, ma solo un suggerimento parzialmente oscurato.