---
title: Creare una chiave API Admin
url: https://platform.claude.com/docs/it/manage-claude/admin-api-keys
description: Crea una chiave API Admin per la tua organizzazione Claude Console o Claude Enterprise.
---
Una chiave API Admin autentica ogni API nella sezione **Amministrazione** di questa guida: l’[Admin API](https://platform.claude.com/docs/it/manage-claude/admin-api), le [Analytics API](https://platform.claude.com/docs/it/manage-claude/analytics-api), la [Compliance API](https://platform.claude.com/docs/it/manage-claude/compliance-api), l’[API Plugins](https://platform.claude.com/docs/it/manage-claude/plugins-api), la [Claude Tag API](https://platform.claude.com/docs/it/manage-claude/claude-tag-api), l’[API Spend Limits](https://platform.claude.com/docs/it/manage-claude/spend-limits-api), l’[API Usage and Cost Analytics](https://platform.claude.com/docs/it/manage-claude/usage-cost-analytics-api), l’[API Usage and Cost](https://platform.claude.com/docs/it/manage-claude/usage-cost-api) e l’[API Rate Limits](https://platform.claude.com/docs/it/manage-claude/rate-limits-api). Non hai bisogno di una chiave separata per ogni API. L’unica eccezione sono gli endpoint dell’Admin API per account di servizio, emittenti di federazione e regole di federazione, che accettano solo un token bearer OAuth con lo scope `org:admin`. Consulta [Ottenere un token bearer OAuth](https://platform.claude.com/docs/it/manage-claude/admin-api#oauth-bearer-token).
Dove creare la chiave dipende da quale prodotto Claude utilizza la tua organizzazione.
## Di quale chiave hai bisogno?
| La tua organizzazione | Crea la chiave in | Prefisso della chiave | Chi può crearla | Funziona con |
| ----------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Claude Console** (Claude Platform, `platform.claude.com`) | Pagina [Chiavi di amministrazione](https://platform.claude.com/settings/admin-keys) (`platform.claude.com/settings/admin-keys`) nella Claude Console | `sk-ant-admin01-...` | Membri dell’organizzazione con il ruolo **Amministratore** | [Admin API](https://platform.claude.com/docs/it/manage-claude/admin-api), [API Usage and Cost Analytics](https://platform.claude.com/docs/it/manage-claude/usage-cost-analytics-api), [API Usage and Cost](https://platform.claude.com/docs/it/manage-claude/usage-cost-api), [API Rate Limits](https://platform.claude.com/docs/it/manage-claude/rate-limits-api), [API Claude Code Analytics](https://platform.claude.com/docs/it/manage-claude/claude-code-analytics-api) e l’[Activity Feed](https://platform.claude.com/docs/it/manage-claude/compliance-activity-feed) della Compliance API |
| **Claude Enterprise** (`claude.ai`) | [claude.ai > Impostazioni organizzazione > API](https://claude.ai/admin-settings/api-access) | `sk-ant-api01-...` | Il **Proprietario principale** dell’organizzazione padre (tutte le organizzazioni collegate). Un **organization owner** (proprietario dell’organizzazione) può crearne una con soli scope della Compliance API, limitata alla propria organizzazione | [Gestione degli utenti](https://platform.claude.com/docs/it/manage-claude/user-management) (gli endpoint dell’Admin API per membri, inviti e gruppi), [API Plugins](https://platform.claude.com/docs/it/manage-claude/plugins-api), [Claude Tag API](https://platform.claude.com/docs/it/manage-claude/claude-tag-api), [Compliance API](https://platform.claude.com/docs/it/manage-claude/compliance-api), [Claude Enterprise Analytics API](https://platform.claude.com/docs/it/manage-claude/analytics-api), [API Usage and Cost Analytics](https://platform.claude.com/docs/it/manage-claude/usage-cost-analytics-api) e [API Spend Limits](https://platform.claude.com/docs/it/manage-claude/spend-limits-api), in base agli [scope](https://platform.claude.com/docs/it/manage-claude/admin-api-keys#choose-scopes-for-a-claude-enterprise-key) che selezioni |
Una chiave creata in un’organizzazione non può essere usata per gestire un’organizzazione diversa. Se la tua azienda utilizza sia Claude Console sia Claude Enterprise, crea una chiave in ciascuna.
## Creare una chiave per un’organizzazione Claude Console
Solo i membri dell’organizzazione con il ruolo **Amministratore** possono creare chiavi API Admin. Consulta [Ruoli e permessi dell’organizzazione](https://platform.claude.com/docs/it/manage-claude/admin-api#organization-roles-and-permissions).
Nella Claude Console, vai alla pagina [Chiavi di amministrazione](https://platform.claude.com/settings/admin-keys) (`platform.claude.com/settings/admin-keys`).
Fai clic su **Crea chiave di amministrazione**, assegnale un nome, seleziona una [scadenza della chiave](https://platform.claude.com/docs/it/manage-claude/authentication#key-expiration) e fai clic su **Aggiungi**. Le chiavi della Claude Console non hanno scope selezionabili; ogni chiave ha accesso completo a tutti gli endpoint che accettano chiavi Admin API (gli endpoint service-account e federation indicati all’inizio di questa pagina non accettano chiavi Admin API).
Copia il segreto visualizzato (che inizia con `sk-ant-admin01-`) e conservalo nel tuo gestore di segreti. Il segreto completo viene mostrato una sola volta.
## Creare una chiave per un’organizzazione Claude Enterprise
Il **proprietario principale** dell’organizzazione padre Claude Enterprise può creare una chiave in grado di accedere a ogni organizzazione collegata, oppure una limitata a una singola organizzazione. Un **proprietario dell’organizzazione** può creare una chiave con soli scope della Compliance API, limitata alla propria organizzazione.
Vai a [claude.ai > Impostazioni organizzazione > API](https://claude.ai/admin-settings/api-access) e trova la sezione **Chiavi**.
Assegna un nome alla chiave e seleziona gli scope di cui hai bisogno dalla [tabella degli scope](https://platform.claude.com/docs/it/manage-claude/admin-api-keys#choose-scopes-for-a-claude-enterprise-key). Il proprietario principale può combinare scope di API diverse (ad esempio, `read:analytics` e `read:spend_limits`) in una singola chiave.
Copia il segreto visualizzato (che inizia con `sk-ant-api01-`) e conservalo nel tuo gestore di segreti. Il segreto completo viene mostrato una sola volta.
## Scegliere gli scope per una chiave Claude Enterprise
Quando crei una chiave Claude Enterprise, seleziona ogni scope richiesto dalle API che intendi chiamare. Gli scope sono fissati al momento della creazione; per aggiungere uno scope in seguito, crea una nuova chiave.
| Per chiamare... | Seleziona questi scope |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------- |
| Admin API [gestione utenti](https://platform.claude.com/docs/it/manage-claude/user-management): elencare e cercare membri e inviti; leggere i ruoli personalizzati e i relativi permessi | `read:members` |
| Admin API [gestione utenti](https://platform.claude.com/docs/it/manage-claude/user-management): modificare i ruoli dei membri, rimuovere membri, [disconnettere membri ovunque](https://platform.claude.com/docs/it/manage-claude/user-management#sign-a-member-out-everywhere) (beta), creare e ritirare inviti (per assegnare il ruolo `managed` in una modifica di ruolo o in un invito, seleziona anche `write:rbac_groups`) | `write:members` |
| Admin API [gestione utenti](https://platform.claude.com/docs/it/manage-claude/user-management): leggere i gruppi e i relativi membri | `read:rbac_groups` |
| Admin API [gestione utenti](https://platform.claude.com/docs/it/manage-claude/user-management): creare, rinominare ed eliminare gruppi; aggiungere e rimuovere membri dei gruppi; con `write:members`, assegnare il ruolo `managed` (in un invito o in una modifica di ruolo) o assegnare gruppi in un invito | `write:rbac_groups` |
| [API Plugins](https://platform.claude.com/docs/it/manage-claude/plugins-api): leggere plugin, versioni, impostazioni di installazione, condivisioni e marketplace; scaricare i file dei plugin, inclusi i file dei plugin personali dei membri; convalidare un marketplace prima di collegarlo | `read:plugins` |
| [API Plugins](https://platform.claude.com/docs/it/manage-claude/plugins-api): caricare plugin e versioni; scegliere quale versione viene distribuita ai membri; eliminare plugin, inclusi i plugin personali dei membri; configurare e rimuovere le impostazioni di installazione; configurare l’impostazione di installazione predefinita di un marketplace; convalidare un marketplace prima di collegarlo (per leggere i plugin, seleziona anche `read:plugins`) | `write:plugins` |
| [API di Claude Tag](https://platform.claude.com/docs/it/manage-claude/claude-tag-api): leggere le impostazioni di Claude Tag sui canali Slack e sui workspace Slack; elencare i pacchetti di accesso e dove sono collegati (nessun altro scope concede l’accesso alla Claude Tag API) | `read:claude_tag` |
| [API di Claude Tag](https://platform.claude.com/docs/it/manage-claude/claude-tag-api): configurare e rimuovere canali; modificare le impostazioni; collegare e scollegare i pacchetti di accesso (per leggere, seleziona anche `read:claude_tag`) | `write:claude_tag` |
| [API Spend Limits](https://platform.claude.com/docs/it/manage-claude/spend-limits-api): leggere i limiti di spesa effettivi dei membri e le richieste di aumento | `read:spend_limits` |
| [API Spend Limits](https://platform.claude.com/docs/it/manage-claude/spend-limits-api): impostare o rimuovere i limiti di spesa per utente; approvare o rifiutare le richieste di aumento | `write:spend_limits` |
| [API Claude Enterprise Analytics](https://platform.claude.com/docs/it/manage-claude/analytics-api): report su coinvolgimento, adozione, costi e utilizzo; [API Usage and Cost Analytics](https://platform.claude.com/docs/it/manage-claude/usage-cost-analytics-api): report sull’utilizzo dei token e sui costi | `read:analytics` |
| [Activity Feed della Compliance API](https://platform.claude.com/docs/it/manage-claude/compliance-activity-feed): eventi di attività a livello di organizzazione | `read:compliance_activities` |
| [Endpoint chat, file e progetti della Compliance API](https://platform.claude.com/docs/it/manage-claude/compliance-content-data) ed [endpoint sessioni della Compliance API](https://platform.claude.com/docs/it/manage-claude/compliance-sessions): leggere chat, file, progetti, trascrizioni delle sessioni e [utenti dell’organizzazione](https://platform.claude.com/docs/it/manage-claude/compliance-org-data#list-organization-users) | `read:compliance_user_data` |
| [Endpoint chat, file e progetti della Compliance API](https://platform.claude.com/docs/it/manage-claude/compliance-content-data): eliminare chat, file e progetti | `delete:compliance_user_data` |
| [Endpoint dell’organizzazione della Compliance API](https://platform.claude.com/docs/it/manage-claude/compliance-org-data): leggere i metadati dell’organizzazione e le impostazioni effettive; [API Plugins](https://platform.claude.com/docs/it/manage-claude/plugins-api): ogni endpoint `GET`, inclusi i download dei file | `read:compliance_org_data` |
| Endpoint di lettura della [gestione utenti](https://platform.claude.com/docs/it/manage-claude/user-management) dell’Admin API, ogni endpoint di lettura della Compliance API e ogni endpoint `GET` dell’[API Plugins](https://platform.claude.com/docs/it/manage-claude/plugins-api), inclusi i download dei file, con un unico scope di sola lettura (per integrazioni di audit di sicurezza; non include le API Spend Limits o Analytics) | `read:org_audit` |
Le Compliance API e Analytics API devono essere abilitate per la tua organizzazione prima che le chiavi con tali scope possano essere utilizzate. Consulta [Configurare la Compliance API](https://platform.claude.com/docs/it/manage-claude/compliance-api-access#set-up-the-compliance-api) e [Ottenere l’accesso alla Claude Enterprise Analytics API](https://platform.claude.com/docs/it/manage-claude/analytics-api#get-access-to-the-claude-enterprise-analytics-api).
Puoi creare e utilizzare chiavi con `read:plugins` o `write:plugins` solo se la tua organizzazione può utilizzare la Plugins API. La guida all’[API Plugins](https://platform.claude.com/docs/it/manage-claude/plugins-api) indica quali organizzazioni possono utilizzarla. In tali organizzazioni, le chiavi con `read:org_audit` o `read:compliance_org_data` possono anche chiamare gli endpoint di lettura della Plugins API, inclusi i download dei file, ma non la convalida del marketplace. Gli scope `read:plugins` e `write:plugins` agiscono solo sull’organizzazione in cui è stata creata la chiave. Consulta [Scope della Plugins API](https://platform.claude.com/docs/it/manage-claude/plugins-api#scopes) e [Leggere un’altra organizzazione sotto lo stesso padre](https://platform.claude.com/docs/it/manage-claude/plugins-api#reading-another-organization-under-the-same-parent).
## Usare la chiave
Passa la chiave nell’header `x-api-key` in ogni richiesta. Consulta la documentazione di ciascuna API per esempi di richiesta completi.
Una chiamata che eccede gli scope della chiave restituisce `403 Forbidden` con un messaggio che elenca gli scope di cui la chiave dispone e gli scope richiesti dall’endpoint.
## Passaggi successivi
Gestisci membri dell’organizzazione, workspace e chiavi API.
Imposta limiti di spesa per membro ed esamina le richieste di aumento per la tua organizzazione Claude Enterprise.
Genera report sulla produttività di Claude Code o sul coinvolgimento e l’adozione di Claude Enterprise.
Verifica le attività e recupera o elimina i contenuti degli utenti in tutta la tua organizzazione.