AmministrazioneMonitoraggio

API di analisi

Copy page



Comprendi quale API di analisi e quale chiave API servono alla tua organizzazione, quindi fornisci l'accesso alle metriche di produttività di Claude Code o ai dati di coinvolgimento e adozione di Claude Enterprise.

Anthropic fornisce due API di analisi, e quale utilizzare dipende da quale prodotto Claude gestisce la tua organizzazione:

• La Claude Code Analytics API riporta le metriche giornaliere di produttività di Claude Code per le organizzazioni che utilizzano la Claude Platform. Fa parte dell'Admin API e utilizza una chiave Admin API.
• La Claude Enterprise Analytics API riporta dati di coinvolgimento, adozione e costo a livello di organizzazione per tutti i prodotti Claude (chat, progetti, Claude Code e altro) per le organizzazioni Claude Enterprise. Utilizza una chiave Analytics API creata in claude.ai.

Le due API utilizzano tipi di chiave diversi, creati in luoghi diversi da ruoli diversi. Questa pagina descrive quale API è adatta alla tua organizzazione e come creare la chiave corretta.

Di quale API hai bisogno?

I tipi di chiave non sono intercambiabili: una chiave Admin API non può chiamare la Claude Enterprise Analytics API, e una chiave Analytics API non può chiamare l'Admin API. Entrambe le API compaiono nel riferimento dell'Admin API, ma sono API separate con tipi di chiave separati. Se la tua organizzazione utilizza sia la Claude Platform sia Claude Enterprise, puoi fornire entrambe le chiavi e utilizzare ciascuna API per i propri dati.

Ottenere l'accesso alla Claude Code Analytics API

La Claude Code Analytics API è disponibile per ogni organizzazione con accesso all'Admin API ed è gratuita.

1. 1

   Crea una chiave Admin API

   Segui i passaggi in Creare una chiave Admin API.

2. 2

   Chiama l'API

   Passa la chiave nell'header x-api-key:

   curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?starting_at=2025-09-08" \
     --header "anthropic-version: 2023-06-01" \
     --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

   

Per le metriche disponibili, i parametri di richiesta e lo schema di risposta, consulta la guida alla Claude Code Analytics API e il riferimento API.

Ottenere l'accesso alla Claude Enterprise Analytics API

La Claude Enterprise Analytics API è disponibile per le organizzazioni Claude Enterprise. I dati di coinvolgimento e adozione sono disponibili su tutti i piani Enterprise. Gli endpoint di costo e utilizzo si applicano ai piani Enterprise basati sull'utilizzo; per i piani Enterprise basati sulle postazioni, riflettono solo i crediti di utilizzo.

1. 1

   Accedi come proprietario principale

   Solo il proprietario principale dell'organizzazione può abilitare l'accesso API e creare chiavi Analytics API.

2. 2

   Abilita l'accesso API e crea una chiave

   Vai su claude.ai > Organization settings > API e abilita l'accesso API pubblico, quindi crea una chiave Analytics API. Le chiavi hanno lo scope read:analytics. Copia il segreto visualizzato e conservalo nel tuo gestore di segreti.

3. 3

   Chiama l'API

   Passa la chiave nell'header x-api-key e includi l'header anthropic-version in ogni richiesta. Gli endpoint si trovano sotto https://api.anthropic.com/v1/organizations/analytics/. Per esempi di richieste, parametri e schemi di risposta, consulta il riferimento della Claude Enterprise Analytics API.

La Claude Enterprise Analytics API fornisce:

• Attività degli utenti: metriche giornaliere per utente su chat (conversazioni, messaggi, progetti, file, artifact), Claude Code (sessioni, commit, pull request, righe di codice, azioni degli strumenti) e altri prodotti Claude
• Riepiloghi delle attività: utenti attivi giornalieri, settimanali e mensili a livello di organizzazione, conteggio delle postazioni e inviti in sospeso
• Utilizzo di progetti, skill e connettori: ripartizioni dell'adozione per progetti chat, skill e connettori
• Report di costo e utilizzo: utilizzo di token e costo nel tempo per utente e a livello di organizzazione (piani Enterprise basati sull'utilizzo)

Per i dettagli degli endpoint, i parametri e gli schemi di risposta, consulta il riferimento della Claude Enterprise Analytics API. Le sezioni seguenti trattano l'aggiornamento dei dati, le definizioni delle metriche e le indicazioni operative che si applicano a tutti questi endpoint.

Disponibilità e aggiornamento dei dati

I dati della Claude Enterprise Analytics API sono disponibili per le date a partire dal 1° gennaio 2026.

Gli endpoint di coinvolgimento e adozione (attività degli utenti, riepiloghi, progetti, skill, connettori) restituiscono un'istantanea giornaliera per la data specificata. I dati di un determinato giorno sono in genere disponibili a partire dalle 17:00 UTC circa del giorno successivo (un ritardo di 1 giorno); fino ad allora, il giorno più recente disponibile è di solito due giorni prima della data UTC corrente. Occasionalmente i dati arrivano più tardi e l'aggiornamento esatto varia in base alla query, quindi anziché presupporre un orario fisso, controlla la risposta di errore: richiedere una data non ancora disponibile restituisce un errore 400 che indica il giorno più recente disponibile. Se i dati non sono disponibili ben oltre il ritardo tipico, di solito ciò indica un guasto della pipeline di dati da parte di Anthropic; contatta l'assistenza se il problema persiste.

Gli endpoint di costo e utilizzo seguono un modello di aggiornamento diverso. I dati sono in genere disponibili entro quattro ore dall'utilizzo sottostante, ma possono richiedere fino a 24 ore. I valori per una determinata data possono essere rivisti fino a 30 giorni man mano che arrivano eventi tardivi e viene eseguita la riconciliazione. Per totali di qualità adatta alla fatturazione, interroga date di almeno 30 giorni nel passato.

Come sono definite le metriche

Utenti attivi. Un utente conta come attivo per un giorno se è vera una qualsiasi delle seguenti condizioni: ha inviato almeno un messaggio di chat in Claude, ha avuto almeno una sessione Claude Code (locale o remota) associata alla tua organizzazione Claude Enterprise che includeva "tool use" (uso degli strumenti) o attività git, oppure ha avuto almeno una sessione Cowork con uso degli strumenti o attività di messaggistica.

Blocchi di metriche per prodotto. Gli oggetti di metriche per prodotto (ad esempio, le metriche Office Agent o Cowork su un record di attività utente) sono sempre presenti su ogni record. Le organizzazioni senza utilizzo di quel prodotto vedono valori tutti a zero anziché null.

Nomi dei connettori. I nomi dei connettori sono normalizzati tra le diverse fonti. Ad esempio, Atlassian MCP server, mcp-atlassian e atlassian_MCP compaiono tutti come atlassian nell'endpoint di utilizzo dei connettori.

Lavorare con l'API

I cursori di paginazione sono legati alla query che li ha emessi. Sugli endpoint di costo e utilizzo, non modificare i parametri della query a metà sequenza: se modifichi products[], group_by[], order_by, l'intervallo di date o qualsiasi filtro e passi un vecchio cursore, la richiesta restituisce un errore 400. Per modificare i parametri, ricomincia dalla prima pagina senza cursore.

I parametri di tipo lista usano la notazione con parentesi quadre. Ripeti il parametro per ogni valore, ad esempio products[]=chat&products[]=claude_code.

I campi degli importi sono stringhe decimali in centesimi. Gli importi in valuta vengono restituiti come stringhe decimali come "41280.000000" (che rappresenta $412,80). Per convertire in dollari, analizza il valore come decimale e dividi per 100. Evita il parsing in virgola mobile binaria per valori che possono superare diversi milioni di dollari.

I "rate limit" (limiti di velocità) si applicano a livello di organizzazione, non per chiave, con un valore predefinito di 60 richieste al minuto su tutti gli endpoint di questa API. Se ciò non è sufficiente per il tuo caso d'uso, contatta il team del tuo account Anthropic per discutere la modifica del limite.

Controllo delle versioni

Invia l'header anthropic-version in ogni richiesta; consulta Versioni dell'API per le versioni disponibili.

Limitazioni note

Se la tua organizzazione utilizza Claude Code tramite Amazon Bedrock, la Claude Enterprise Analytics API non restituisce l'attività di Claude Code per tale utilizzo.

Passaggi successivi