---
title: API Claude Code Analytics
url: https://platform.claude.com/docs/it/manage-claude/claude-code-analytics-api
description: Accedi in modo programmatico alle analisi di utilizzo di Claude Code e alle metriche di produttività della tua organizzazione con l'API Admin Claude Code Analytics.
---
**L'Admin API non è disponibile per gli account individuali.** Per collaborare con i colleghi e aggiungere membri, configura la tua organizzazione nella pagina [Organization](https://platform.claude.com/settings/organization) (`platform.claude.com/settings/organization`) nella Claude Console.
L'API Admin Claude Code Analytics fornisce accesso programmatico alle metriche di utilizzo aggregate giornalmente per gli utenti di Claude Code, consentendo alle organizzazioni di analizzare la produttività degli sviluppatori e creare dashboard personalizzate. Questa API fornisce maggiori dettagli rispetto alla [dashboard Analytics](https://platform.claude.com/claude-code) di base, senza la complessità dell'integrazione OpenTelemetry.
Questa API ti consente di monitorare, analizzare e ottimizzare meglio l'adozione di Claude Code:
* **Analisi della produttività degli sviluppatori:** Monitora sessioni, righe di codice aggiunte/rimosse, commit e pull request create utilizzando Claude Code
* **Metriche di uso degli strumenti:** Monitora i tassi di accettazione e rifiuto per i diversi strumenti di Claude Code (Edit, MultiEdit, Write, NotebookEdit)
* **Analisi dei costi:** Visualizza i costi stimati e l'utilizzo dei token suddivisi per modello Claude
* **Report personalizzati:** Esporta i dati per creare dashboard esecutive e report per i team di gestione
* **Giustificazione dell'utilizzo:** Fornisci metriche per giustificare ed espandere internamente l'adozione di Claude Code
**Credenziali Admin API richieste.** Questi endpoint fanno parte dell'Admin API. Puoi accedervi utilizzando una [chiave Admin API](https://platform.claude.com/docs/it/manage-claude/admin-api-keys), un token OAuth con lo scope `org:admin`, oppure una chiave personale o di account di servizio che non sia limitata a un workspace; le chiavi API di workspace non funzionano. Consulta [Autenticazione](https://platform.claude.com/docs/it/manage-claude/admin-api#authentication) per i dettagli.
**Claude Platform on AWS:** L'API Claude Code Analytics non è attualmente disponibile. Visualizza invece l'utilizzo di Claude Code nella pagina **Usage** della Claude Console.
**Organizzazioni Claude Enterprise:** L'attività di Claude Code per gli utenti di claude.ai è riportata dall'API Claude Enterprise Analytics, che utilizza una chiave API Analytics invece di una chiave API Admin. Consulta [API Analytics](https://platform.claude.com/docs/it/manage-claude/analytics-api) per scoprire quale API e quale tipo di chiave sono necessari alla tua organizzazione.
## Avvio rapido
Ottieni le analisi di Claude Code della tua organizzazione per un giorno specifico:
```bash cURL
curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?\
starting_at=2025-09-08&\
limit=20" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"
```
**Imposta un header User-Agent per le integrazioni**
Se stai creando un'integrazione, imposta l'header User-Agent per aiutare Anthropic a comprendere i modelli di utilizzo:
```text wrap
User-Agent: YourApp/1.0.0 (https://yourapp.com)
```
## API Claude Code Analytics
Monitora l'utilizzo di Claude Code, le metriche di produttività e l'attività degli sviluppatori in tutta la tua organizzazione con l'endpoint `/v1/organizations/usage_report/claude_code`.
### Concetti chiave
* **Aggregazione giornaliera:** Restituisce le metriche per un singolo giorno specificato dal parametro `starting_at`
* **Dati a livello di utente:** Ogni record rappresenta l'attività di un utente per il giorno specificato
* **Metriche di produttività:** Monitora sessioni, righe di codice, commit, pull request e uso degli strumenti
* **Dati su token e costi:** Monitora l'utilizzo e i costi stimati suddivisi per modello Claude
* **Paginazione basata su cursore:** Gestisci grandi set di dati con una paginazione stabile tramite cursori opachi
* **Aggiornamento dei dati:** Le metriche sono disponibili con un ritardo massimo di 1 ora per garantire la coerenza
Per i dettagli completi sui parametri e gli schemi di risposta, consulta il [riferimento dell'API Claude Code Analytics](https://platform.claude.com/docs/it/api/beta/organization/usage_report/retrieve_claude_code).
### Esempi di base
#### Ottieni le analisi per un giorno specifico
```bash cURL
curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?\
starting_at=2025-09-08" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"
```
#### Ottieni le analisi con paginazione
```bash cURL
# Prima richiesta
curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?\
starting_at=2025-09-08&\
limit=20" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"
# Richiesta successiva usando il cursore dalla risposta
curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?\
starting_at=2025-09-08&\
page=page_MjAyNS0wNS0xNFQwMDowMDowMFo=" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"
```
### Parametri della richiesta
| Parametro | Tipo | Obbligatorio | Descrizione |
| ------------- | ------- | ------------ | -------------------------------------------------------------------------------------- |
| `starting_at` | string | Sì | Data UTC in formato YYYY-MM-DD; restituisce le metriche solo per questo singolo giorno |
| `limit` | integer | No | Numero di record per pagina (predefinito: 20, massimo: 1000) |
| `page` | string | No | Token cursore opaco dal campo `next_page` della risposta precedente |
### Metriche disponibili
Ogni record della risposta contiene le seguenti metriche per un singolo utente in un singolo giorno:
#### Dimensioni
* **date:** Data in formato RFC 3339 (timestamp UTC)
* **actor:** L'utente o la chiave API che ha eseguito le azioni di Claude Code (`user_actor` con `email_address` oppure `api_actor` con `api_key_name`)
* **organization\_id:** UUID dell'organizzazione
* **customer\_type:** Tipo di account cliente (`api` per i clienti API, `subscription` per i clienti Pro/Team)
* **terminal\_type:** Tipo di terminale o ambiente in cui è stato utilizzato Claude Code (ad esempio, `vscode`, `iTerm.app`, `tmux`)
#### Metriche principali
* **num\_sessions:** Numero di sessioni Claude Code distinte avviate da questo attore
* **lines\_of\_code.added:** Numero totale di righe di codice aggiunte in tutti i file da Claude Code
* **lines\_of\_code.removed:** Numero totale di righe di codice rimosse in tutti i file da Claude Code
* **commits\_by\_claude\_code:** Numero di commit git creati tramite la funzionalità di commit di Claude Code
* **pull\_requests\_by\_claude\_code:** Numero di pull request create tramite la funzionalità PR di Claude Code
#### Metriche delle azioni degli strumenti
Suddivisione dei tassi di accettazione e rifiuto delle azioni degli strumenti per tipo di strumento:
* **edit\_tool.accepted/rejected:** Numero di proposte dello strumento Edit che l'utente ha accettato/rifiutato
* **multi\_edit\_tool.accepted/rejected:** Numero di proposte dello strumento MultiEdit che l'utente ha accettato/rifiutato
* **write\_tool.accepted/rejected:** Numero di proposte dello strumento Write che l'utente ha accettato/rifiutato
* **notebook\_edit\_tool.accepted/rejected:** Numero di proposte dello strumento NotebookEdit che l'utente ha accettato/rifiutato
#### Suddivisione per modello
Per ogni modello Claude utilizzato:
* **model:** Identificatore del modello Claude (ad esempio, `claude-opus-5`)
* **tokens.input/output:** Conteggi dei token di input e output per questo modello
* **tokens.cache\_read/cache\_creation:** Utilizzo dei token relativi alla cache per questo modello
* **estimated\_cost.amount:** Costo stimato in centesimi di USD per questo modello
* **estimated\_cost.currency:** Codice valuta per l'importo del costo (attualmente sempre `USD`)
### Struttura della risposta
L'API restituisce i dati nel seguente formato:
```json
{
"data": [
{
"date": "2025-09-08T00:00:00Z",
"actor": {
"type": "user_actor",
"email_address": "developer@company.com"
},
"organization_id": "dc9f6c26-b22c-4831-8d01-0446bada88f1",
"customer_type": "api",
"terminal_type": "vscode",
"core_metrics": {
"num_sessions": 5,
"lines_of_code": {
"added": 1543,
"removed": 892
},
"commits_by_claude_code": 12,
"pull_requests_by_claude_code": 2
},
"tool_actions": {
"edit_tool": {
"accepted": 45,
"rejected": 5
},
"multi_edit_tool": {
"accepted": 12,
"rejected": 2
},
"write_tool": {
"accepted": 8,
"rejected": 1
},
"notebook_edit_tool": {
"accepted": 3,
"rejected": 0
}
},
"model_breakdown": [
{
"model": "claude-opus-5-5",
"tokens": {
"input": 100000,
"output": 35000,
"cache_read": 10000,
"cache_creation": 5000
},
"estimated_cost": {
"currency": "USD",
"amount": 113
}
}
]
}
],
"has_more": false,
"next_page": null
}
```
## Paginazione
L'API supporta la paginazione basata su cursore per le organizzazioni con un numero elevato di utenti:
1. Effettua la richiesta iniziale con il parametro opzionale `limit`.
2. Se `has_more` è `true` nella risposta, usa il valore `next_page` nella richiesta successiva.
3. Continua finché `has_more` non è `false`.
Il cursore codifica la posizione dell'ultimo record e garantisce una paginazione stabile anche quando arrivano nuovi dati. Ogni sessione di paginazione mantiene un confine dei dati coerente per garantire che non vengano persi o duplicati record.
## Casi d'uso comuni
* **Dashboard esecutive:** Crea report di alto livello che mostrano l'impatto di Claude Code sulla velocità di sviluppo
* **Confronto tra strumenti di IA:** Esporta le metriche per confrontare Claude Code con altri strumenti di codifica basati su IA come Copilot e Cursor
* **Analisi della produttività degli sviluppatori:** Monitora le metriche di produttività individuali e di team nel tempo
* **Monitoraggio e allocazione dei costi:** Monitora i modelli di spesa e alloca i costi per team o progetto
* **Monitoraggio dell'adozione:** Identifica quali team e utenti stanno ottenendo il massimo valore da Claude Code
* **Giustificazione del ROI:** Fornisci metriche concrete per giustificare ed espandere internamente l'adozione di Claude Code
## Domande frequenti
### Quanto sono aggiornati i dati analitici?
I dati analitici di Claude Code compaiono in genere entro 1 ora dal completamento dell'attività dell'utente. Per garantire risultati di paginazione coerenti, nelle risposte sono inclusi solo i dati più vecchi di 1 ora.
### Posso ottenere metriche in tempo reale?
No, questa API fornisce solo metriche aggregate giornalmente. Per il monitoraggio in tempo reale, valuta l'utilizzo dell'[integrazione OpenTelemetry](https://code.claude.com/docs/en/monitoring-usage).
### Come vengono identificati gli utenti nei dati?
Gli utenti vengono identificati tramite il campo `actor` in due modi:
* **`user_actor`:** Contiene `email_address` per gli utenti che si autenticano tramite OAuth (il caso più comune)
* **`api_actor`:** Contiene `api_key_name` per gli utenti che si autenticano con una chiave API
Il campo `customer_type` indica se l'utilizzo proviene da clienti `api` (API a consumo) o da clienti `subscription` (piani Pro/Team).
### Qual è il periodo di conservazione dei dati?
I dati analitici storici di Claude Code vengono conservati e sono accessibili tramite l'API. Non è specificato alcun periodo di eliminazione per questi dati.
### Quali distribuzioni di Claude Code sono supportate?
Questa API monitora solo l'utilizzo di Claude Code sulla Claude API. L'utilizzo tramite [Claude in Amazon Bedrock](https://platform.claude.com/docs/it/build-with-claude/claude-in-amazon-bedrock), [Claude in Microsoft Foundry](https://platform.claude.com/docs/it/build-with-claude/claude-in-microsoft-foundry), [Claude su Google Cloud](https://platform.claude.com/docs/it/build-with-claude/claude-on-vertex-ai) o [Claude Platform on AWS](https://platform.claude.com/docs/it/build-with-claude/claude-platform-on-aws) non è incluso.
### Quanto costa utilizzare questa API?
L'API Claude Code Analytics è gratuita per tutte le organizzazioni con accesso all'API Admin.
### Come calcolo i tassi di accettazione degli strumenti?
Tasso di accettazione dello strumento = `accepted / (accepted + rejected)` per ogni tipo di strumento. Ad esempio, se lo strumento edit mostra 45 accettate e 5 rifiutate, il tasso di accettazione è del 90%.
### Quale fuso orario viene utilizzato per il parametro della data?
Tutte le date sono in UTC. Il parametro `starting_at` deve essere in formato YYYY-MM-DD e rappresenta la mezzanotte UTC di quel giorno.
## Vedi anche
L'API Claude Code Analytics ti aiuta a comprendere e ottimizzare il flusso di lavoro di sviluppo del tuo team. Scopri di più sulle funzionalità correlate:
* [API Admin](https://platform.claude.com/docs/it/manage-claude/admin-api)
* [Riferimento dell'API Admin](https://platform.claude.com/docs/it/api/beta/organization)
* [Dashboard Claude Code Analytics](https://platform.claude.com/claude-code)
* [API Usage and Cost](https://platform.claude.com/docs/it/manage-claude/usage-cost-api) - Monitora l'utilizzo dell'API in tutti i servizi Anthropic
* [API Compliance](https://platform.claude.com/docs/it/manage-claude/compliance-api) - Recupera dati di audit e attività
* [Gestione delle identità e degli accessi](https://code.claude.com/docs/en/iam)
* [Monitoraggio dell'utilizzo con OpenTelemetry](https://code.claude.com/docs/en/monitoring-usage) per metriche personalizzate e avvisi