---
title: Ottieni la tua chiave API di Claude
url: https://platform.claude.com/docs/it/get-api-key
description: Trova, crea e gestisci le tue chiavi API per la Claude API nella Claude Console.
---

Le chiavi API per la Claude API (chiamate anche chiavi API di Anthropic) si trovano nella Claude Console. Per visualizzare le tue chiavi esistenti o crearne una nuova, vai alla pagina [API keys](https://platform.claude.com/settings/keys) (`platform.claude.com/settings/keys`) nella Console.

## 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](https://platform.claude.com/docs/it/manage-claude/workload-identity-federation#service-accounts) 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

<Steps>
  <Step title="Accedi alla Claude Console">
    Vai alla Claude Console su [platform.claude.com](https://platform.claude.com/) e accedi, oppure crea un account se non ne hai ancora uno.
  </Step>

  <Step title="Apri la pagina delle chiavi API">
    Nella Claude Console, vai alla pagina [API keys](https://platform.claude.com/settings/keys) (`platform.claude.com/settings/keys`).
  </Step>

  <Step title="Crea una chiave">
    Fai clic su **Create key**, assegna un nome alla chiave, scegli una [scadenza](https://platform.claude.com/docs/it/manage-claude/authentication#key-expiration) e imposta **Linked account** su te stesso o su un service account. Puoi anche scegliere un [workspace](https://platform.claude.com/settings/workspaces) nella Console a cui limitare l'ambito della chiave.
  </Step>

  <Step title="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.
  </Step>
</Steps>

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:

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

L'[SDK client](https://platform.claude.com/docs/it/cli-sdks-libraries/overview) legge `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](https://platform.claude.com/docs/it/manage-claude/authentication#select-a-workspace). Per l'Admin API, consulta [Chiavi API e Admin API](https://platform.claude.com/docs/it/get-api-key#api-keys-and-the-admin-api).

Per effettuare la tua prima richiesta, segui il [Quickstart](https://platform.claude.com/docs/it/get-started) e consulta [Autenticazione](https://platform.claude.com/docs/it/manage-claude/authentication) per il quadro completo, incluse le credenziali a breve durata con Workload Identity Federation.

## Chiavi API e Admin API

L'[Admin API](https://platform.claude.com/docs/it/api/organization) include endpoint per gestire le chiavi API della tua organizzazione in modo programmatico, come [Retrieve API Key](https://platform.claude.com/docs/it/api/organization/api_keys/retrieve) e [List API Keys](https://platform.claude.com/docs/it/api/organization/api_keys/list). Questi endpoint sono destinati agli amministratori dell'organizzazione che automatizzano la gestione delle chiavi. Accettano una [chiave Admin API](https://platform.claude.com/docs/it/manage-claude/admin-api-keys), un token OAuth con lo scope `org:admin`, oppure una chiave personale o di service account non 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.

<Note>
  L'Admin API non può recuperare una chiave persa né fornirti una chiave con cui chiamare la Claude API. Per ottenere una chiave API utilizzabile, creane una nella pagina [API keys](https://platform.claude.com/settings/keys) (`platform.claude.com/settings/keys`) nella Claude Console.
</Note>
