Skip to content
SVENNISAIWe speak Claude.
Blog · Claude API key

Claude API key: come creare la chiave in azienda e usare i crediti API mensili di Max e Team

La chiave API è il modo in cui i vostri programmi parlano con Claude. Ecco come crearla nella Console in modo che resti dell'azienda, come limitare la spesa e come collegare i crediti mensili dei piani Max e Team.

9 min di lettura
Articolo · 9 min di lettura
Una chiave inserita in un contatore a gettoni con accanto una pila di monete: accesso sì, ma con un tetto di spesa.

Claude API key: cos'è e quando serve alla vostra azienda

Una Claude API key, in italiano chiave API di Claude, è la stringa segreta con cui un programma chiama Claude attraverso la Claude API. Serve quando volete che sia il vostro software a lavorare con Claude: un agente che risponde ai ticket, uno script che riassume i documenti, un'integrazione con il gestionale. Le persone che usano Claude dall'app non hanno bisogno di una chiave: a loro basta un posto in Claude Team o in un altro piano.

La documentazione di Anthropic indica due prerequisiti per la prima chiamata: un account nella Claude Console e una chiave API. La Console, all'indirizzo platform.claude.com, è il posto dove stanno le chiavi, la fatturazione e le impostazioni dell'organizzazione.

Il punto che conta per un'azienda non è creare la chiave, che richiede un minuto. È crearla nel posto giusto, con il proprietario giusto e con un tetto di spesa, perché da quella chiave dipendono il contratto, i costi e la protezione dei dati.

Primo passo: un'organizzazione nella Console intestata all'azienda

Create l'account della Console con un indirizzo aziendale che non dipenda da una sola persona, per esempio una casella condivisa dell'IT o dell'amministrazione. Se l'account nasce sull'email personale del titolare o di un consulente, le chiavi dell'azienda dipenderanno da quella persona.

Decidete poi chi amministra. Solo gli amministratori dell'organizzazione possono creare i workspace e assegnare le persone, quindi nominatene due, così uno copre l'altro. Chi si occupa della fatturazione può avere il ruolo di billing, che gli dà accesso ai costi di tutti i workspace senza poter toccare le chiavi.

Per le aziende nello Spazio economico europeo il contratto della Claude API è con Anthropic Ireland, Limited, e le Condizioni commerciali sono regolate dal diritto irlandese. Le stesse condizioni stabiliscono che Anthropic non può addestrare i modelli sui contenuti dei clienti inviati tramite i servizi. Il trattamento dei dati personali è regolato dal Data Processing Addendum di Anthropic, richiamato dalle stesse condizioni (sezione C). Queste tutele valgono per il cliente titolare dell'account: un motivo in più perché l'account sia dell'azienda.

I workspace: separare progetti, ambienti e costi

Ogni organizzazione ha un Default Workspace, che non si può rinominare, archiviare o eliminare. Accanto potete creare altri workspace, fino a 1.000 per organizzazione, e a ciascuno assegnare persone, account di servizio, chiavi e limiti propri.

Un'impostazione semplice per una PMI con due progetti:

WorkspaceA cosa serveLimite di spesa
SviluppoProve e sperimentazioneBasso, per contenere gli errori
Produzione assistenzaL'agente che smista i ticketAdeguato al volume reale
Produzione preventiviL'integrazione con il CRMAdeguato al volume reale

Per creare un workspace un amministratore apre la pagina Workspaces della Console, clicca Create workspace, sceglie un nome e un colore e conferma. I ruoli disponibili dentro un workspace sono Workspace User (solo playground), Workspace Limited Developer e Workspace Developer (creano e gestiscono chiavi e usano la API) e Workspace Admin (controllo completo). Gli amministratori dell'organizzazione ricevono automaticamente il ruolo di Workspace Admin ovunque.

Se qualcuno della vostra organizzazione accede a Claude Code con il proprio account della Console, Anthropic crea in automatico un workspace Claude Code, separato dagli altri. È anche l'unico workspace che permette limiti di spesa mensili per singolo utente.

Creare la chiave API nella Console, passo per passo

La procedura che Anthropic descrive nella documentazione in italiano è questa:

  1. Accedete alla Claude Console su platform.claude.com.
  2. Aprite la pagina API keys, all'indirizzo platform.claude.com/settings/keys.
  3. Cliccate Create key, date un nome alla chiave, scegliete una scadenza e impostate Linked account su voi stessi o su un account di servizio. Potete anche limitare la chiave a un workspace.
  4. Copiate subito la chiave, che inizia con sk-ant-, e conservatela in un gestore di segreti. La Console la mostra per intero una sola volta: se la perdete, non potete rivederla e dovete crearne una nuova.

Se il pulsante Create key è disattivato, il vostro ruolo non vi permette di creare chiavi in quel punto. Chiedete a un amministratore di cambiare il ruolo o di creare una chiave di account di servizio per il vostro progetto.

Chiave personale o di account di servizio

La scelta del tipo è la decisione più importante. Una chiave personale agisce per vostro conto e smette di funzionare se lasciate l'organizzazione. Una chiave di account di servizio rappresenta un account tecnico, pensato per i carichi di lavoro condivisi come un servizio in produzione o un agente. La documentazione lo riassume così: chiave personale per il vostro sviluppo, chiave di account di servizio per tutto ciò che è condiviso. Esistono ancora le chiavi di workspace, senza proprietario, che Anthropic definisce legacy e sconsiglia rispetto agli altri due tipi.

Limiti di spesa: il tetto mensile dell'organizzazione e dei workspace

La Claude API ha due tipi di limiti. I limiti di velocità stabiliscono quante richieste e quanti token al minuto potete usare. I limiti di spesa fissano il costo massimo mensile. Per un'azienda il secondo è quello che protegge il bilancio.

Ogni livello di utilizzo ha un tetto mensile, che Anthropic pubblica nella documentazione sui limiti: 500 dollari per il livello Start, 1.000 per Build, 200.000 per Scale. Raggiunto il tetto del livello, l'uso della API si ferma fino all'inizio del mese successivo, salvo una richiesta di aumento.

Sotto quel tetto potete fissare un limite vostro. Nella pagina Spend limits della Console (platform.claude.com/settings/spend-limits), accanto a Monthly spend limit, cliccate Adjust limit (o Set limit se non ne avete ancora uno) e inserite il valore. Quando la spesa lo raggiunge, le richieste ricevono un errore che dice che avete raggiunto i limiti che avete impostato, finché non lo alzate o il mese finisce.

Lo stesso vale per i singoli workspace: nella stessa pagina Spend limits, sotto Workspace limits, scegliete il workspace dal menu e fissate il tetto mensile e gli avvisi via email. Due eccezioni da ricordare: sul Default Workspace un limite di spesa può non conteggiare né fermare una parte dell'uso, per esempio il playground della Console o Claude Code, e i limiti dell'organizzazione valgono sempre, anche se la somma dei workspace è più alta. È un buon motivo per non usare il Default Workspace per la produzione.

I crediti API mensili inclusi nei piani Max e Team dal 7 ottobre 2026

Dal 7 ottobre 2026 i piani Max e Team, e oggi anche il piano Ultra, includono crediti API mensili per far girare le vostre app e i vostri agenti sulla Claude Platform. Lo annunciano le note di rilascio del Centro assistenza di Claude, che indicano anche che i crediti vengono distribuiti nell'arco di alcuni giorni.

Per riceverli bisogna collegare un'organizzazione della Claude Console al piano:

  • Piani Max e Ultra: da Settings, poi Billing.
  • Piano Team: da Organization settings, poi Billing.

Secondo il Centro assistenza di Claude i crediti valgono 100 dollari al mese su Max, 200 su Ultra e, su Team, 20 dollari per ogni posto Standard e 100 per ogni posto Premium, riuniti in un unico saldo mensile con un massimo di 500 dollari. I crediti non usati scadono alla fine di ogni ciclo di fatturazione. Si può collegare una sola organizzazione della Console, e per cambiarla bisogna rivolgersi all'assistenza.

Per un'azienda su Claude Team la regola pratica è una: collegate l'organizzazione della Console intestata all'azienda, quella con gli amministratori e i workspace descritti sopra, e non un account personale. I crediti pagano l'utilizzo; non cambiano chi è titolare delle chiavi né le regole su come custodirle.

Trattateli come una voce di budget. Quando a fine mese guardate l'utilizzo per workspace, annotate quanto hanno coperto i crediti del piano e quanto i crediti acquistati. Quel dato vi dice quando un progetto sta crescendo oltre ciò che il piano include.

Custodire la chiave: variabili d'ambiente, mai codice o chat

La chiave va conservata in una variabile d'ambiente o in un gestore di segreti sul server che chiama Claude. Gli SDK di Anthropic leggono automaticamente la variabile ANTHROPIC_API_KEY, quindi il codice non deve mai contenere la chiave scritta per esteso.

Il vostro sviluppatore, nel terminale del server, imposta la variabile così:

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

Su un server di produzione la variabile va impostata nelle impostazioni dei segreti della piattaforma, non digitata nel terminale, perché la cronologia dei comandi potrebbe conservarne una copia.

Tre abitudini evitano quasi tutti i problemi:

  • mai la chiave in un'email, in un ticket, in una chat o in un foglio di calcolo;
  • un registro con il nome di ogni chiave, il suo proprietario, gli strumenti in cui è inserita e la scadenza;
  • una chiave diversa per ogni progetto o integrazione, così una fuga di dati riguarda un solo sistema.

Scadenza, rotazione e revoca delle chiavi

Quando create una chiave scegliete una scadenza: usatela sempre. Una chiave dimenticata smette così di funzionare invece di restare attiva per anni. Ruotare una chiave significa sostituirla volontariamente prima che scada, senza fermare il servizio:

  1. create la nuova chiave, con lo stesso nome più la data;
  2. inseritela nel gestore di segreti e in ogni strumento indicato nel registro;
  3. verificate che le chiamate a Claude funzionino con la nuova chiave;
  4. eliminate la vecchia chiave nella Console;
  5. aggiornate il registro.

Revocate subito una chiave quando chi la conosceva lascia l'azienda, quando compare in un file, in un'email o in una chat, o quando un fornitore che la custodiva chiude il contratto. Con le chiavi personali una parte del lavoro si fa da sola: quando una persona viene rimossa dall'organizzazione, le sue chiavi personali vengono archiviate e non tornano attive nemmeno se la persona viene invitata di nuovo.

Perché non comprare una chiave API, e cosa cambia con un fornitore

Online si trovano offerte di chiavi API o di crediti a prezzo scontato. Non compratele: le Condizioni commerciali di Anthropic vietano di rivendere i servizi senza la sua approvazione espressa (sezione D.4) e rendono il cliente responsabile di tutta l'attività svolta con il suo account (sezione D.5).

Diverso è il caso di un fornitore che vi offre un'applicazione o un agente costruito sul proprio account Anthropic: le Condizioni lo consentono (sezione A.1), ma in quel caso i vostri dati passano dal fornitore. Il cliente di Anthropic è lui, non voi: l'impegno a non addestrare i modelli e l'accordo sul trattamento dei dati stanno nel suo contratto, e voi non potete farli valere direttamente. Vi serve quindi un contratto con quel fornitore che lo nomini responsabile del trattamento ai sensi dell'art. 28 del GDPR e indichi Anthropic tra i sub-responsabili. Regolate anche cosa succede se il fornitore sostituisce o revoca la chiave.

La regola è semplice: le chiavi della vostra azienda nascono nella pagina API keys della vostra organizzazione nella Claude Console; se un fornitore usa le proprie, il rapporto va regolato per iscritto.

Claude API key in azienda: la checklist finale

ControlloCosa fare
TitolareOrganizzazione della Console aperta con una casella aziendale condivisa
AmministratoriDue persone nominate, con il ruolo di admin
WorkspaceUno per progetto o ambiente; nessuna produzione sul Default Workspace
Tipo di chiaveAccount di servizio per ciò che è condiviso, personale solo per lo sviluppo
ScadenzaImpostata su ogni chiave, con rotazione prima della data
CustodiaVariabile d'ambiente o gestore di segreti, mai nel codice
SpesaLimite dell'organizzazione e limiti per workspace con avvisi
Crediti del pianoOrganizzazione aziendale collegata da Billing del piano Max o Team
OrigineSolo chiavi create nella vostra Console; se un fornitore usa le proprie, contratto ex art. 28 GDPR

Con questi nove punti in ordine, la chiave smette di essere un dettaglio tecnico lasciato allo sviluppatore e diventa una risorsa dell'azienda, con un proprietario, un budget e una data di scadenza.

Fonti

  1. Claude Platform Docs: Ottieni la tua chiave API di Claude
  2. Claude Platform Docs: Inizia con Claude
  3. Claude Platform Docs: Workspaces
  4. Claude Platform Docs: Rate limits e spend limits
  5. Claude Help Center: note di rilascio
  6. Anthropic: Commercial Terms of Service
  7. Claude Help Center: crediti API mensili per i piani Max, Ultra e Team
Gratuita, 30 minuti

Scegliete un orario. Portate il processo a cui avete pensato leggendo.

Uscite con un sì o un no sull'affidarlo a Claude e con il passo giusto, secondo i prezzi pubblicati. Parlate con chi costruisce gli agenti, non con un commerciale.

Preferite telefonare? +39 02 9475 1997 · Non è ancora il momento di parlarne? Fate prima l'analisi gratuita della vostra azienda.

30 minuti · videochiamata · gratuita
  1. 1Orario
  2. 2I vostri dati
  3. 3Prenotato