--- title: API di analisi url: https://platform.claude.com/docs/it/manage-claude/analytics-api description: 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 di prodotto, e quale utilizzare dipende da quale prodotto Claude gestisce la tua organizzazione: * L’**API Claude Code Analytics** riporta le metriche giornaliere di produttività di Claude Code per le organizzazioni che utilizzano la Claude Platform. Fa parte dell’[Admin API](https://platform.claude.com/docs/it/manage-claude/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? | API | Tipo di chiave | Creata in | Chi può crearla | Cosa copre | | ----------------------------------- | --------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **API Claude Code Analytics** | Chiave Admin API (`sk-ant-admin01-...`) | Pagina [Chiavi di amministrazione](https://platform.claude.com/settings/admin-keys) (`platform.claude.com/settings/admin-keys`) nella Claude Console | Amministratore dell’organizzazione | Metriche giornaliere di Claude Code per utente: sessioni, righe di codice, commit, pull request, accettazione degli strumenti e costo stimato per modello | | **API Claude Enterprise Analytics** | Chiave Analytics API | [claude.ai > Impostazioni organizzazione > API](https://claude.ai/admin-settings/api-access) | Proprietario principale | Coinvolgimento e adozione a livello di organizzazione (attività degli utenti, riepiloghi degli utenti attivi, utilizzo di progetti, skill e connettori), più report di costo e utilizzo | 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. L’unica eccezione è l’[API Usage and Cost Analytics](https://platform.claude.com/docs/it/manage-claude/usage-cost-analytics-api), che le organizzazioni Claude Enterprise chiamano con la propria chiave Analytics API. Entrambe le API di analisi di prodotto compaiono nel [riferimento dell’Admin API](https://platform.claude.com/docs/it/api/beta/organization), ma sono API separate con tipi di chiave separati. Se la tua organizzazione usa sia la Claude Platform sia Claude Enterprise, puoi configurare entrambe le chiavi e usare ciascuna API per i propri dati. Cerchi dati sull’utilizzo dei token e sui costi anziché analisi di prodotto? Consulta l’[API Usage and Cost Analytics](https://platform.claude.com/docs/it/manage-claude/usage-cost-analytics-api), che serve sia le organizzazioni Claude Console sia quelle Claude Enterprise. Se desideri visualizzare i dati di coinvolgimento e adozione nel prodotto anziché in modo programmatico, usa la [dashboard Analytics](https://claude.ai/analytics/activity) in claude.ai. Per i casi d’uso di governance e audit (azioni dei singoli utenti, eventi di attività grezzi, contenuto delle conversazioni), consulta la [Compliance API](https://platform.claude.com/docs/it/manage-claude/compliance-api-access). ## Ottenere l’accesso alla Claude Code Analytics API La Claude Code Analytics API è disponibile per ogni organizzazione con accesso all’[Admin API](https://platform.claude.com/docs/it/manage-claude/admin-api) ed è gratuita. Segui i passaggi in [Creare una chiave Admin API](https://platform.claude.com/docs/it/manage-claude/admin-api-keys#create-a-key-for-a-claude-console-organization). Passa la chiave nell’header `x-api-key`: ```bash curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?starting_at=2025-09-08" \ -H "anthropic-version: 2026-10-21" \ -H "x-api-key: $ANTHROPIC_ADMIN_KEY" ``` Per le metriche disponibili, i parametri di richiesta e lo schema della risposta, consulta la guida all’[API Claude Code Analytics](https://platform.claude.com/docs/it/manage-claude/claude-code-analytics-api) e il [riferimento API](https://platform.claude.com/docs/it/api/beta/organization/usage_report/retrieve_claude_code). ## 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. Solo il proprietario principale dell’organizzazione può abilitare l’accesso API e creare chiavi Analytics API. Vai su [claude.ai > Impostazioni organizzazione > API](https://claude.ai/admin-settings/api-access) 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. Passa la chiave nell’header `x-api-key` e includi l’header [`anthropic-version`](https://platform.claude.com/docs/it/api/versioning) 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](https://platform.claude.com/docs/it/api/beta/organization/analytics). 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), Chat and Cowork unified (attività di chat e sessioni Cowork) 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 su costi e utilizzo:** utilizzo dei token e costi per utente e a livello di organizzazione nel tempo (piani Enterprise basati sull’utilizzo) Gli endpoint dei report su costi e utilizzo sotto `/v1/organizations/analytics/` (`usage_report`, `cost_report`, `user_usage_report` e `user_cost_report`) sono legacy e rimangono supportati. Per le nuove integrazioni, usa l’[API Usage and Cost Analytics](https://platform.claude.com/docs/it/manage-claude/usage-cost-analytics-api). Per migrare un’integrazione esistente, consulta [Migrare dai report di utilizzo e costo di Claude Enterprise](https://platform.claude.com/docs/it/manage-claude/usage-cost-analytics-api#migrate-from-enterprise-analytics-reports). Gli altri endpoint della Claude Enterprise Analytics API non sono legacy. Per i dettagli degli endpoint, i parametri e gli schemi di risposta, consulta il [riferimento della Claude Enterprise Analytics API](https://platform.claude.com/docs/it/api/beta/organization/analytics). 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 uno snapshot giornaliero per la data specificata. I dati di un determinato giorno sono in genere disponibili entro le 13:00–13:30 UTC circa del giorno successivo (un ritardo di 1 giorno). Fino ad allora, il giorno più recente disponibile è di solito 2 giorni prima della data UTC corrente. I dati arrivano più tardi nei giorni in cui una pipeline di dati a monte è in ritardo, e l’aggiornamento esatto varia in base alla query. Anziché presumere 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 lato Anthropic; contatta il supporto se il problema persiste. Gli **endpoint di costo e utilizzo** seguono un modello di aggiornamento diverso. I dati sono in genere disponibili entro 4 ore dall’utilizzo sottostante, ma possono richiedere fino a 24 ore. I valori possono essere rivisti man mano che arrivano eventi in ritardo e vengono eseguite le riconciliazioni, fino a circa 7 giorni dopo la fine del mese solare. Ad esempio, i valori del 1° ottobre possono cambiare fino al 7 novembre circa. Per totali utilizzabili ai fini della fatturazione, interroga solo i mesi terminati da almeno 7 giorni. Le risposte di costo e utilizzo includono un timestamp `data_refreshed_at`. Se ometti `ending_at`, il valore predefinito è 31 giorni dopo `starting_at` oppure l’ora corrente, a seconda di quale sia precedente. Tale intervallo può estendersi oltre `data_refreshed_at`, e i dati successivi a quel momento sono incompleti. Per risultati stabili tra chiamate ripetute, imposta `ending_at` su un valore uguale o precedente a un `data_refreshed_at` restituito in precedenza. ## Come sono definite le metriche **Utenti attivi.** Un utente viene considerato attivo per un giorno se si verifica una 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 uso degli strumenti o attività git. * Ha avuto almeno una sessione Cowork con uso degli strumenti o attività di messaggi. **Chat and Cowork unified.** Chat and Cowork unified porta le funzionalità di Cowork nella chat di claude.ai. La maggior parte dell’attività in Chat and Cowork unified viene riportata sotto il valore di prodotto `chat_cowork_unified`, non `chat` o `cowork`. Nell’attività degli utenti e nell’utilizzo di skill, connettori e plugin, questo utilizzo compare nell’oggetto `chat_cowork_unified_metrics`. Nei riepiloghi delle attività, viene conteggiato in `chat_cowork_unified_daily_active_user_count`, `chat_cowork_unified_weekly_active_user_count` e `chat_cowork_unified_monthly_active_user_count`. Quando un utente inizia a usare Chat and Cowork unified, il suo utilizzo si sposta dai tuoi dati di chat e Cowork ai dati di Chat and Cowork unified. L’utilizzo dei giorni precedenti all’inizio dell’uso di Chat and Cowork unified da parte di un utente rimane sotto chat o Cowork. I dati a livello di organizzazione, come l’utilizzo totale dei token, il costo totale e il conteggio complessivo degli utenti attivi, non cambiano. I report di costo e utilizzo filtrati per prodotto escludono l’utilizzo di Chat and Cowork unified a meno che `products[]` non includa `chat_cowork_unified`. Alcune attività degli utenti di Chat and Cowork unified, come la modalità vocale, possono ancora essere riportate sotto chat o Cowork. L’attività di un utente può anche essere suddivisa tra prodotti nel giorno in cui inizia a usare Chat and Cowork unified. Lo stesso vale per il giorno in cui la funzionalità viene disattivata per lui. Il modo in cui l’attività viene suddivisa non è garantito. Un utente può comparire sia nei conteggi di chat o Cowork sia nei conteggi di Chat and Cowork unified. Ciò può accadere in un giorno in cui usa Chat and Cowork unified e parte della sua attività viene ancora riportata sotto chat o Cowork. I conteggi settimanali e mensili possono includerlo in entrambi quando l’intervallo contiene attività di entrambi i tipi, anche in giorni diversi. Ad esempio, l’intervallo potrebbe coprire giorni prima e dopo l’inizio del suo uso di Chat and Cowork unified. Quando filtri l’attività degli utenti per progetto, l’attività di progetto di ogni giorno viene conteggiata in un solo posto. Se un utente ha inviato un messaggio di chat in Chat and Cowork unified quel giorno, tutta la sua attività di progetto viene conteggiata in `chat_cowork_unified_metrics.chat`. Altrimenti, viene conteggiata in `chat_metrics`. **Blocchi di metriche per prodotto.** Gli oggetti di metriche per prodotto (ad esempio, le metriche di Office Agent o Cowork in un record di attività utente) sono sempre presenti in ogni record. Le organizzazioni che non utilizzano quel prodotto vedono conteggi a zero anziché un oggetto `null`. L’eccezione è Chat and Cowork unified: nelle distribuzioni che non lo offrono, i suoi campi vengono omessi dalla risposta. I singoli campi all’interno di questi oggetti possono essere `null`, il che significa che il valore non è disponibile. Ad esempio, quando filtri l’attività degli utenti per progetto, `distinct_skills_used_count` in `chat_metrics` è `null`. Il [riferimento della Claude Enterprise Analytics API](https://platform.claude.com/docs/it/api/beta/organization/analytics) indica quali campi possono essere `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 espresse in centesimi.** Gli importi in valuta vengono restituiti come stringhe decimali come `"41280.000000"` (che rappresenta $412,80 USD). Per convertire in dollari, analizzali come decimali e dividi per 100. Evita l’analisi in virgola mobile binaria per valori che potrebbero superare diversi milioni di dollari. **I “rate limit” (limiti di velocità) si applicano a livello di organizzazione**, non per singola chiave, con un valore predefinito di 60 richieste al minuto su tutti gli endpoint di questa API. Se non è sufficiente per il tuo caso d’uso, contatta il tuo team di account Anthropic per discutere la modifica del limite. ## Controllo delle versioni Invia l’header `anthropic-version` in ogni richiesta; consulta [Versioni](https://platform.claude.com/docs/it/api/versioning) per le versioni disponibili. ## Limitazioni note ### Claude Code tramite Amazon Bedrock 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. ### Claude Code e Cowork con chiavi di crittografia gestite dal cliente Se la tua organizzazione usa [chiavi di crittografia gestite dal cliente](https://platform.claude.com/docs/it/manage-claude/cmek), Anthropic esclude alcuni dettagli dell’uso di Claude Code e Cowork dalle sue analisi di utilizzo, per proteggere i tuoi dati. Di conseguenza, non usare i seguenti valori della Claude Enterprise Analytics API per misurare quanto la tua organizzazione usa Claude Code o Cowork. Possono essere pari a zero o inferiori all’uso effettivo: * **Modifiche al codice:** nell’attività degli utenti, questi campi in `claude_code_metrics.core_metrics` possono essere pari a zero: `lines_of_code` (righe aggiunte e rimosse) e `commit_count`. Il campo `pull_request_count` può essere inferiore al numero reale di pull request. * **Skill avviate con un comando slash:** se un utente avvia una skill in Claude Code o Cowork digitando un comando slash, come `/skill-name`, tale uso non viene conteggiato. Ciò si applica all’utilizzo delle skill e ai conteggi delle skill di Cowork nell’attività degli utenti. Le skill che Claude invoca senza un comando slash vengono comunque conteggiate. Per altre modifiche alle analisi con chiavi di crittografia gestite dal cliente, consulta [Cosa copre CMEK su Claude Enterprise](https://platform.claude.com/docs/it/manage-claude/cmek-coverage-claude-enterprise#turned-off-or-changed). ## Passaggi successivi Monitora le sessioni di Claude Code, le modifiche al codice e l’uso degli strumenti con una chiave Admin API. Monitora l’utilizzo dei token e i costi della tua organizzazione. Riferimento degli endpoint per i dati di coinvolgimento, adozione e costo. I dati di audit e conformità utilizzano i propri tipi di chiave.