> For the complete documentation index, see [llms.txt](https://docs.aisuru.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aisuru.com/ai-generativa/ia-generativa-sezione-avanzata/provider-e-modelli-come-ottenere-le-chiavi-api-dai-provider/claude-console-come-gestire-le-chiavi-api-di-anthropic.md).

# Claude Console: gestione delle chiavi API di Anthropic

Questa guida ti accompagna nell'intero processo di creazione di un account Anthropic, configurazione dei metodi di pagamento, gestione dei limiti di spesa e creazione delle chiavi API per l'integrazione con [AIsuru](https://www.aisuru.com/).

## 1. Creazione di un account Anthropic

Per iniziare a usare la console Claude, devi creare un account sviluppatore:

1. **Vai alla pagina di registrazione**: visita la [Claude Console](https://console.anthropic.com/) e seleziona l'opzione di registrazione. Puoi usare un account Google (Continue with Google) oppure un indirizzo email (Continue with email);
2. **Verifica la tua email**: se ti registri con l'email, Anthropic utilizza un sistema di "magic link". Inserisci il tuo indirizzo email e controlla la posta in arrivo: riceverai un messaggio con un link per confermare il tuo account. Fai clic sul link "Sign in to Claude Console" per procedere (non è richiesta alcuna password);
3. **Completa l'onboarding**: dopo aver fatto clic sul link, verrai reindirizzato alla pagina di onboarding della console Claude (Anthropic). Ti verrà chiesto di inserire il tuo nome completo e di confermare di avere almeno 18 anni, accettando i termini e le condizioni. Fai clic su Continue per proseguire;
4. **Crea un'organizzazione**: quindi, specifica un nome per la tua organizzazione. Può essere il nome della tua azienda oppure un nome descrittivo (anche il tuo nome, se stai solo testando la piattaforma). Conferma facendo clic su Create Account.

Una volta completata la registrazione, accederai alla Claude Console. Prima di utilizzare l'API, è importante configurare la sezione di fatturazione.

## 2. Console API di Claude: inserimento dei dati di fatturazione

Per garantire una corretta fatturazione, dovrai inserire i dati di fatturazione della tua azienda, incluso il numero di partita IVA:

1. Apri le impostazioni della tua organizzazione: nella console, fai clic su "Settings" nella barra laterale. Dal menu a sinistra, seleziona "[Organization](https://console.anthropic.com/settings/organization)";
2. Compila le informazioni aziendali: nella pagina dell'organizzazione, inserisci tutti i dati richiesti per la tua azienda. In particolare:
   1. Nome dell'organizzazione: dovrebbe essere già compilato al momento della registrazione, ma assicurati che corrisponda al nome legale della tua azienda;
   2. Indirizzo aziendale completo: inserisci l'indirizzo di fatturazione della tua azienda (via, città, codice postale, paese);
   3. Partita IVA: se la tua azienda ha sede in un paese in cui si applica l'IVA (ad esempio nell'UE), verrà visualizzato un campo facoltativo Tax or VAT ID. Inserisci qui la partita IVA della tua azienda (incluso il prefisso del paese, ad esempio IT12345678901);
3. Salva le modifiche: dopo aver compilato i campi, verifica che siano corretti e fai clic sul pulsante per salvare i dati della tua organizzazione.

## 3. Aggiungere un metodo di pagamento per le API di Anthropic Claude

Dopo aver configurato i dati della tua azienda, dovrai aggiungere un metodo di pagamento per acquistare crediti:

1. Vai alla sezione Billing: dalle impostazioni, seleziona [Plans & Billing](https://console.anthropic.com/settings/billing) dal menu per gestire pagamenti, crediti e fatture.
2. Inizia ad aggiungere una carta: nella pagina Billing, trova l'opzione per aggiungere un metodo di pagamento. Se è la prima configurazione, potresti visualizzare un pulsante Complete Setup oppure Add Payment Method / Add funds. Fai clic su di esso per iniziare;
3. Inserisci i dati della carta: si aprirà un modulo Stripe in cui dovrai inserire:
   1. Numero della carta di credito o di debito;
   2. Data di scadenza;
   3. Codice CVV/CVC.

Attualmente non è disponibile un'opzione per rimuovere direttamente dalla console una carta salvata (puoi sostituirla solo aggiungendone una nuova).

Anthropic invia una ricevuta per ogni acquisto all'email di fatturazione registrata e rende disponibili le fatture nella sezione Billing > Invoice History.

Nota: attualmente sono accettate solo carte di credito/debito. Assicurati che la tua carta sia abilitata ai pagamenti internazionali in USD (la valuta utilizzata da Anthropic) e autorizzata agli acquisti online. L'utente deve disporre delle autorizzazioni Admin o Billing per configurare il pagamento (questa guida presuppone che il creatore dell'account sia Admin, impostazione predefinita).

## 4. Claude Console: effettua il tuo primo acquisto di crediti

Anthropic utilizza un sistema di crediti prepagati per l'utilizzo dell'API. Ciò significa che devi acquistare crediti prima di poter utilizzare l'API in modo esteso:

1. Vai alla pagina Billing: accedi a [Plans & Billing](https://console.anthropic.com/settings/billing) nella console Anthropic. Nella sezione Credit balance vedrai il saldo attuale dei crediti della tua organizzazione.
2. Aggiungi crediti: fai clic su "Add funds" o "Purchase Credits". Ti verrà chiesto di inserire l'importo in USD che desideri acquistare. La ricarica iniziale minima è di $5 USD;
3. Inserisci ulteriori dettagli, se necessario: se è la prima volta che aggiungi fondi, potrebbe apparire una finestra per completare la configurazione. Anthropic potrebbe chiederti ulteriori informazioni prima di consentirti di acquistare crediti, ad esempio:
   1. Conferma il tipo di utilizzo previsto dell'API;
   2. I paesi in cui prevedi di utilizzare Claude;
   3. Se il tuo utilizzo dell'API riguarderà determinati settori regolamentati.
4. Conferma il pagamento dei crediti: ti verrà chiesto di confermare il metodo di pagamento per l'addebito. Se tutto sembra corretto, procedi e conferma;
5. Verifica il saldo dei crediti: una volta completata la transazione, la console aggiornerà immediatamente il tuo saldo nella sezione "Credit balance" in [Plans & Billing](https://console.anthropic.com/settings/billing).

### Autoricarica

Nella pagina Billing è disponibile un'impostazione di autoricarica dei crediti. Puoi attivarla se vuoi che i crediti vengano ricaricati automaticamente quando il saldo scende al di sotto di una soglia da te definita.

Per configurare l'autoricarica, fai clic su Edit settings nella sezione Billing e definisci:

* Soglia minima del saldo al di sotto della quale si attiva l'autoricarica;
* Importo della ricarica che verrà acquistato al raggiungimento di quella soglia.

Puoi anche disabilitare l'autoricarica in qualsiasi momento se preferisci gestire manualmente le ricariche per un migliore controllo della spesa. I crediti acquistati sono generalmente validi per un anno.

## 5. Come monitorare e limitare la spesa e l'utilizzo delle API di Claude

Per un utilizzo aziendale responsabile, è importante tenere traccia sia della spesa sia dell'utilizzo delle API.

### **Monitoraggio dell'utilizzo e dei costi**

La console di Claude fornisce report dettagliati sull'utilizzo delle API:

* Vai a Settings > [Utilizzo](https://console.anthropic.com/settings/usage) per visualizzare il consumo di token, filtrabile per Workspace, modello IA, chiave API o intervallo di tempo;
* In Settings > [Costo](https://console.anthropic.com/settings/cost) troverai un report dei costi con gli stessi filtri.

### **Limitare il budget con i crediti**

Il modello prepagato di Anthropic significa che non puoi spendere più di quanto hai caricato in crediti. Se desideri un limite di spesa rigido, puoi lasciare disabilitata l'autoricarica: in questo modo, la spesa massima è limitata ai crediti che hai acquistato.

Detto questo, puoi anche impostare un limite di spesa mensile a livello di account: vai alla sezione [Limiti](https://console.anthropic.com/settings/limits) della console e imposta il limite mensile. Se ne hai già impostato uno, fai semplicemente clic su "Change Limit":

1. Nel popup che si apre, inserisci il valore del limite mensile in dollari statunitensi;
2. Fai clic su "Update Limit" per salvare il nuovo limite oppure su "Remove Limit" per rimuoverlo completamente.

## 6. Creazione di una chiave API

Per utilizzare i servizi Anthropic con AIsuru, devi creare una chiave API:

1. Dalla console Anthropic, vai a Settings > API Keys nel menu laterale;
2. Crea una nuova chiave: nella pagina [API keys](https://console.anthropic.com/settings/keys), fai clic sul pulsante Create Key;
3. Assegna un workspace e un nome alla chiave:
   1. Workspace: se non hai creato workspace aggiuntivi, lascia selezionato Default;
   2. Nome della chiave: inserisci un nome descrittivo per la chiave API (ad es. "AIsuru - \[nome Agente]" oppure "AIsuru - Produzione");
4. Conferma e copia la chiave: fai clic su Create. La console genererà la chiave API. Verrà mostrata una sola volta, al momento della creazione: copiala immediatamente e conservala in un luogo sicuro.

## 7. Workspace Claude: cosa sono e come crearli

La console Anthropic Claude supporta i workspace per aiutarti a organizzare progetti e team all'interno della tua organizzazione.

Quando crei il tuo account, viene creato un workspace "Default" associato all'organizzazione. Se la tua azienda ha un solo progetto o stai solo testando l'API, il workspace predefinito potrebbe essere tutto ciò di cui hai bisogno.

### Creare un nuovo workspace Anthropic

Solo gli amministratori dell'organizzazione possono creare nuovi workspace:

1. Vai a Settings e fai clic su "[Workspaces](https://console.anthropic.com/settings/workspaces)" nel menu laterale.
2. Nella pagina dei workspace, fai clic su "Add Workspace" in alto a destra;
3. Inserisci un nome per il nuovo workspace, ad esempio "Project Alpha" o "DataScience Team"; puoi anche selezionare un colore distintivo;
4. Fai clic su Create. Il nuovo workspace apparirà nell'elenco.

### Gestire i workspace Claude

* Puoi rinominare o cambiare il colore di un workspace esistente facendo clic sull'icona "…" accanto a esso;
* Quando crei una chiave API, devi associarla a un workspace. Le chiavi API sono visibili e gestibili solo dagli utenti con un Ruolo Developer (o Admin) che hanno accesso a quel workspace;
* Grazie ai workspace, puoi filtrare i consumi e i costi per singolo workspace nella sezione Usage/Cost.

I workspace ti consentono di organizzare in modo flessibile l'utilizzo della console Anthropic: puoi separarli per progetto, team o ambiente, mantenendo tutto organizzato e sotto controllo.

## Gestire i membri nella Claude Console

Per collaborare con il tuo team nella console Claude, vai alla sezione [Membri](https://console.anthropic.com/settings/members) (Settings > Members): da qui puoi vedere tutti i membri invitati al team.

Per invitare nuovi membri:

1. Fai clic sul pulsante "Invite";
2. Inserisci l'indirizzo email del membro del team; puoi inserire un indirizzo per riga per invitare più persone contemporaneamente;
3. Assegna un Ruolo:
   1. Utente: accesso di base all'organizzazione;
   2. Sviluppatore: può gestire chiavi API e integrazioni;
   3. Fatturazione: accesso alle informazioni di fatturazione;
   4. Amministratore: controllo completo sull'organizzazione e sui membri (sviluppatore + fatturazione).
4. Fai clic su "Send Invites" per inviare gli inviti.

Quando inviti un membro, dopo aver assegnato un ruolo organizzativo, potresti anche doverlo aggiungere a singoli workspace (ad eccezione di quello predefinito, a cui tutti i membri possono accedere): gli sviluppatori e gli utenti devono essere assegnati come membri di workspace specifici per lavorarvi, mentre gli amministratori e i ruoli di fatturazione hanno accesso a tutti i workspace.

## 9. Limiti di frequenza e livelli per l'API Anthropic Claude

Ogni organizzazione API nella Claude Console dispone di limiti tecnici di utilizzo predefiniti per garantire un uso equo delle risorse:

* Limiti di livello: ogni livello ha limiti specifici di richieste al minuto e token al minuto. Puoi visualizzare i limiti del tuo livello attuale in Settings > [Limits](https://console.anthropic.com/settings/limits) della console Claude;
* Upgrade di livello: puoi visualizzare i requisiti per ciascun livello nella [documentazione di Anthropic](https://docs.anthropic.com/en/api/rate-limits#requirements-to-advance-tier). Se hai bisogno di limiti superiori a quelli ottenibili automaticamente, ad esempio per casi d'uso aziendali molto grandi, dovrai inviare una richiesta di aumento tramite la pagina Limits. Il team Anthropic esaminerà la richiesta e potrebbe approvare un livello superiore.

### Passaggi successivi

Dopo aver completato la configurazione della console Anthropic:

1. Copia la chiave API che hai creato;
2. Accedi alla dashboard di [AIsuru](https://www.aisuru.com/);
3. Usa la chiave API per [creare un nuovo modello sulla piattaforma](/ai-generativa/ia-generativa-sezione-avanzata/crea-e-gestisci-le-configurazioni-dei-modelli.md).