Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Ogni API nella sezione Admin di questa guida (l'Admin API, le Analytics API, la Compliance API, la Spend Limits API, la Usage and Cost API e la Rate Limits API) viene autenticata con una chiave API Admin. Non hai bisogno di una chiave separata per ogni API.
Il luogo in cui crei la chiave dipende da quale prodotto Claude utilizza la tua organizzazione.
| La tua organizzazione | Crea la chiave in | Prefisso della chiave | Chi può crearla | Funziona con |
|---|---|---|---|---|
Claude Console (Claude Platform, platform.claude.com) | Claude Console > Settings > Admin keys | sk-ant-admin01-... | I membri dell'organizzazione con il ruolo admin | Admin API, Usage and Cost API, Rate Limits API, Claude Code Analytics API e l'Activity Feed della Compliance API |
Claude Enterprise (claude.ai) | claude.ai > Organization settings > API | sk-ant-api01-... | Il primary owner dell'organizzazione principale (tutte le organizzazioni collegate). Un organization owner può crearne una che include solo gli scope della Compliance API, limitata alla propria organizzazione | Compliance API, Claude Enterprise Analytics API e Spend Limits API, in base agli scope che selezioni |
Una chiave creata in un'organizzazione non può essere utilizzata per gestire un'organizzazione diversa. Se la tua azienda utilizza sia Claude Console sia Claude Enterprise, crea una chiave in ciascuna.
Accedi come admin dell'organizzazione
Solo i membri dell'organizzazione con il ruolo admin possono creare chiavi API Admin. Consulta Ruoli e autorizzazioni dell'organizzazione.
Apri le impostazioni delle chiavi Admin
Crea la chiave
Fai clic su Create key, assegnale un nome e fai clic su Create. Le chiavi di Claude Console non hanno scope selezionabili; ogni chiave include l'accesso completo all'Admin API.
Copia e conserva il segreto
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.
Accedi come primary owner o come organization owner
Il primary owner dell'organizzazione principale di Claude Enterprise può creare una chiave in grado di accedere a ogni organizzazione collegata, oppure una limitata a una singola organizzazione. Un organization owner può creare una chiave con i soli scope della Compliance API, limitata alla propria organizzazione.
Apri le impostazioni API
Vai su claude.ai > Organization settings > API e trova la sezione Keys.
Fai clic su + Create key
Assegna un nome alla chiave e seleziona gli scope di cui hai bisogno dalla tabella degli scope. Il primary owner può combinare scope di API diverse (ad esempio, read:analytics e read:spend_limits) su una singola chiave.
Copia e conserva il segreto
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.
Quando crei una chiave Claude Enterprise, seleziona tutti gli scope richiesti dalle API che intendi chiamare. Gli scope sono fissati al momento della creazione; per aggiungere uno scope in un secondo momento, crea una nuova chiave.
| Per chiamare... | Seleziona questi scope |
|---|---|
| Spend Limits API: leggere i limiti di spesa effettivi dei membri e le richieste di aumento | read:spend_limits |
| Spend Limits API: impostare o rimuovere i limiti di spesa per utente; approvare o rifiutare le richieste di aumento | write:spend_limits |
| Claude Enterprise Analytics API: report su coinvolgimento, adozione, costi e utilizzo | read:analytics |
| Activity Feed della Compliance API: eventi di attività a livello di organizzazione | read:compliance_activities |
| Endpoint dei contenuti della Compliance API: leggere chat, file, progetti e utenti | read:compliance_user_data |
| Endpoint dei contenuti della Compliance API: eliminare chat, file e progetti | delete:compliance_user_data |
| Endpoint dell'organizzazione della Compliance API: leggere i metadati dell'organizzazione e le impostazioni effettive | read:compliance_org_data |
Le API Compliance e Analytics devono essere abilitate per la tua organizzazione prima che le chiavi con tali scope possano essere utilizzate. Consulta Configura la Compliance API e Analytics API.
Passa la chiave nell'header x-api-key in ogni richiesta. Consulta la documentazione di ciascuna API per esempi completi di richieste.
Una chiamata che supera gli scope della chiave restituisce 403 Forbidden con un messaggio che elenca gli scope posseduti dalla chiave e gli scope richiesti dall'endpoint.
Gestisci i membri dell'organizzazione, i workspace e le 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.
Was this page helpful?