Claude Console: come gestire le chiavi API di Anthropic
Questa guida illustra il processo completo per creare un account Anthropic, impostare i metodi di pagamento, gestire i limiti di spesa e creare le chiavi API per l'integrazione con AIsuru.
1. Registrazione di un account Anthropic
Per iniziare a usare la console Claude è necessario creare un account sviluppatore:
Accedi alla pagina di registrazione: visita la Console di Claude e seleziona l'opzione per registrarti. Puoi utilizzare un account Google (Continue with Google) oppure un indirizzo email (Continue with email).
Verifica l'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 l'account. Clicca sul link "Sign in to Claude Console" per procedere (non è richiesta la creazione di una password).
Completa l'onboarding: dopo aver cliccato il link, verrai reindirizzato a una pagina di onboarding della console di 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. Clicca Continue per avanzare.
Crea un'organizzazione: successivamente, specifica un nome per la tua organizzazione. Può essere il nome della tua azienda oppure un nome descrittivo (anche il tuo nome, se stai testando la piattaforma). Conferma cliccando su Create Account.
Al termine della registrazione, verrai accolto dalla Console di Claude. Prima di iniziare a utilizzare l'API è importante configurare la sezione di fatturazione della console.
2. Claude API Console: inserire i dati di fatturazione
Per assicurare una corretta fatturazione dovrai inserire i dati della tua azienda, inclusa la Partita IVA:
Apri i dettagli dell'organizzazione: nella console, clicca su "Settings" (Impostazioni) nella colonna laterale. Si aprirà la sezione delle impostazioni. Dal menu laterale sinistro, seleziona "Organization" (Organizzazione).
Compila le informazioni aziendali: nella pagina dell'organizzazione, inserisci tutti i dati richiesti della tua azienda. In particolare:
Nome dell'organizzazione: dovrebbe essere già presente quello inserito in fase di registrazione, ma assicurati che corrisponda al nome legale della tua azienda.
Indirizzo aziendale completo: inserisci l'indirizzo di fatturazione dell'azienda (via, città, CAP, paese).
Partita IVA: se la tua azienda ha sede in un paese in cui è prevista l'imposta (es. in UE), comparirà un campo opzionale per il Tax or VAT ID. Inserisci qui la Partita IVA aziendale (comprensiva del prefisso nazionale, es. IT12345678901).
Salva le modifiche: dopo aver riempito i campi, verifica che siano corretti e clicca sul pulsante per salvare i dettagli dell'organizzazione.
3. Aggiungere un metodo di pagamento per le API di Anthropic Claude
Una volta impostati i dati aziendali, dovrai aggiungere un metodo di pagamento per poter effettuare acquisti di crediti:
Vai alla sezione Billing: dalle impostazioni, seleziona la voce Plans & Billing (Piani e fatturazione) nel menu per gestire pagamenti, crediti e fatture.
Avvia la procedura di aggiunta carta: nella pagina di Billing, individua l'opzione per aggiungere un metodo di pagamento. Se è la prima configurazione, potresti vedere un pulsante Complete Setup oppure Add Payment Method / Add funds. Cliccalo per iniziare.
Inserisci i dati della carta: si aprirà un modulo Stripe dove dovrai inserire i dettagli della tua carta:
Numero della carta di credito o di debito;
Data di scadenza;
Codice CVV/CVC.
Attualmente, non esiste un’opzione per rimuovere una carta salvata direttamente dalla console (è possibile solo sostituirla aggiungendone un’altra).
Anthropic invia la ricevuta di ogni acquisto all’email di fatturazione registrata e rende disponibili le invoice nella sezione Billing > Invoice History.
Nota: Attualmente sono accettate solo carte di credito/debito. Assicurati che la carta sia abilitata per pagamenti internazionali in USD (la valuta usata da Anthropic) e autorizzata per acquisti online. L’utente deve avere permessi Admin o Billing per configurare il pagamento (la guida assume che l’account creatore sia Admin, il che è vero di default).
4. Claude Console: primo acquisto di crediti
Anthropic utilizza un sistema di crediti prepagati per l'utilizzo dell'API. Ciò significa che prima di poter utilizzare l'API in modo esteso, devi acquistare crediti da caricare sul tuo account:
Accedi alla pagina di Billing: vai di nuovo nella sezione Plans & Billing della console Anthropic. Nella parte dedicata al Credit balance vedrai il saldo attuale di crediti della tua organizzazione.
Aggiungere crediti: clicca sul pulsante "Add funds" (Aggiungi fondi) o "Purchase Credits". Ti verrà richiesto di inserire l'importo in dollari (USD) dei crediti che desideri acquistare. L'importo minimo di ricarica iniziale è pari a 5 USD.
Inserisci i dettagli aggiuntivi se richiesti: se è la prima volta che aggiungi fondi, potrebbe comparire una finestra di completamento configurazione. Anthropic potrebbe chiederti ulteriori informazioni prima di consentire l'acquisto di crediti, ad esempio:
Confermare il tipo di utilizzo previsto dell'API;
I paesi in cui prevedi di utilizzare Claude;
Se il tuo uso dell'API coinvolgerà determinati settori regolamentati.
Conferma il pagamento dei crediti: verrà quindi richiesta conferma del metodo di pagamento per addebitare l'importo dei crediti. Se è tutto corretto, procedi pure.
Verifica il saldo crediti: una volta completata la transazione, la console aggiornerà immediatamente il tuo saldo nella sezione "Credit balance" su Plans & Billing.
Autoricarica
Nella pagina di Billing è disponibile un'impostazione per l'autoricarica (auto-reload) dei crediti. Puoi attivarla se desideri che i crediti si ricarichino automaticamente quando il saldo scende sotto una soglia che decidi tu.
Per configurare l'auto-reload, clicca su Edit settings nella sezione Billing e definisci:
Soglia minima di saldo (minimum balance) sotto cui scatta la ricarica automatica.
Importo di ricarica che verrà acquistato quando si raggiunge quella soglia.
Puoi anche disabilitare l'auto-reload in qualsiasi momento se preferisci gestire manualmente le ricariche per un miglior controllo di spesa. I crediti acquistati hanno solitamente una validità di un anno.
5. Come controllare e limitare spesa ed utilizzo delle API di Claude
Per un uso aziendale responsabile, è importante tenere sotto controllo sia la spesa che l'utilizzo dell'API.
Monitoraggio dell'utilizzo e dei costi
La console di Claude fornisce report dettagliati sull'uso dell'API:
Navigando in Settings > Usage puoi vedere il consumo di token con la possibilità di filtrare per Workspace, modello AI, chiave API o intervallo temporale;
Nella pagina Settings > Cost trovi un report dei costi con gli stessi filtri.
Limitare il budget con i crediti
Il modello prepagato di Anthropic fa sì che tu non possa spendere più di quanto hai caricato in crediti. Se desideri avere un limite di spesa rigido, puoi lasciare disabilitata la ricarica automatica: in questo modo la spesa massima sarà limitata all'importo di crediti che hai acquistato.
Ad ogni modo, a livello di account, è possibile limitare la spesa mensile per le API di Claude: basta andare nella sezione Limits della console e impostare il limite mensile. Se ne hai già impostato uno, basterà premere sul tasto "Change Limit":
Nel popup che si apre, inserisci il valore del limite mensile in dollari americani;
Clicca su "Update Limit" per aggiornare il limite o su "Remove Limit" per rimuoverlo completamente.
6. Creazione di una chiave API
Per utilizzare i servizi Anthropic con AIsuru, è necessario creare una chiave API:
Dalla console Anthropic, vai su Settings > API Keys dal menu laterale;
Crea una nuova chiave: nella pagina delle chiavi API, clicca il pulsante Create Key;
Assegna Workspace e nome alla chiave: ti verrà chiesto di selezionare:
Workspace: se non hai creato workspace aggiuntivi, lascia selezionato Default;
Nome della chiave: inserisci un nome descrittivo per la chiave API (es. "AIsuru - [nome Agente]" o "AIsuru - Produzione");
Conferma la creazione e copia la chiave: clicca su Create. La console genererà la chiave API. Questa sarà mostrata solo una volta al momento della creazione: copiala immediatamente e salvala in un luogo sicuro.
7. Claude workspaces: cosa sono e come si creano
La console di Anthropic Claude supporta la suddivisione in workspace (spazi di lavoro) per organizzare meglio i progetti e i team all'interno di un'organizzazione:
Al momento della creazione dell'account viene generato un workspace "Default" associato all'organizzazione. Se la tua azienda ha un solo progetto o se stai solo testando l'API, potresti usare semplicemente il workspace predefinito.
Creare un nuovo workspace Anthropic
Solo gli admin dell'organizzazione possono creare nuovi workspace:
Vai in Settings e clicca su "Workspaces" nel menu laterale;
Nella pagina degli workspace, clicca sul pulsante "Add Workspace" in alto a destra;
Inserisci un nome per il nuovo workspace, ad esempio "Progetto Alpha" o "Team DataScience"; puoi anche selezionare un colore distintivo;
Clicca su Create. Il nuovo workspace apparirà nell'elenco.
Gestire i workspace Claude
Puoi modificare il nome o il colore di un workspace esistente cliccando sull'icona con i tre puntini "…" accanto al workspace.
Quando crei una chiave API, devi associarla a un workspace. Le chiavi API sono visibili e gestibili solo dagli utenti con ruolo Developer (o Admin) che hanno accesso a quel workspace.
Grazie ai workspace, nella sezione Usage/Cost puoi filtrare l'uso e la spesa per singolo workspace.
I Workspaces ti permettono di strutturare l'utilizzo della console Anthropic in modo flessibile: puoi separarli per progetti, team o ambienti, garantendo ordine e controllo.
Gestire i membri nella Claude Console
Per collaborare con il tuo team all'interno della console Claude accedi alla sezione Members (clicca su Settings > Members): da qui sei in grado di vedere tutti i membri invitati all'interno del team.
Se vuoi invitare nuovi membri
Clicca sul tasto "Invite";
Inserisci l'indirizzo email del membro del team; puoi inserire un indirizzo email per riga per invitare
Assegna un ruolo:
User: accesso base all'organizzazione.
Developer: può gestire chiavi API e integrazioni.
Billing: accesso alle informazioni di fatturazione.
Admin: pieno controllo sull'organizzazione e i membri (developer + billing).
Clicca su “Send Invites” per inviare l'invito. o gli inviti.
Quando si invita un membro, dopo avergli assegnato un ruolo organizzativo è possibile doverlo aggiungere ai singoli workspace (ad eccezione del default, a cui tutti i membri hanno accesso): developer e user devono essere assegnati come membri di specifici workspace per poter operare su di essi - admin e billing hanno invece accesso a tutti gli spazi di lavoro.
9. Rate limits e tier Anthropic Claude API
Ogni organizzazione API della Claude Console ha dei limiti di utilizzo tecnici predefiniti al fine di garantire un uso equo delle risorse:
Limiti per tier: ogni tier ha specifici limiti di richieste e token per minuto. Puoi visualizzare i limiti attuali del tuo tier nella sezione Settings > Limits della Claude console.
Upgrade del tier: puoi visualizzare i dettagli dei requisiti per ciascun tier nella documentazione di Anthropic. Qualora si necessiti di limiti ulteriormente più alti oltre il massimo ottenibile automaticamente – ad esempio per casi d’uso aziendali molto grandi – allora è necessario inoltrare una richiesta di aumento tramite la pagina Limits. Il team Anthropic valuterà la richiesta e potrà eventualmente approvare un tier più elevato.
Prossimi passi
Dopo aver completato la configurazione della tua console Anthropic:
Copia la chiave API creata;
Accedi alla tua dashboard AIsuru;
Utilizza la chiave API per creare un nuovo modello in piattaforma.
Last updated