API di Analisi del Codice Claude

• Analisi della Produttività degli Sviluppatori: Traccia sessioni, righe di codice aggiunte/rimosse, commit e pull request create utilizzando Claude Code
• Metriche di Utilizzo degli Strumenti: Monitora i tassi di accettazione e rifiuto per 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
• Reportistica Personalizzata: Esporta dati per costruire dashboard esecutive e report per i team di gestione
• Giustificazione dell’Utilizzo: Fornisci metriche per giustificare ed espandere l’adozione di Claude Code internamente

​

Avvio rapido

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

User-Agent: YourApp/1.0.0 (https://yourapp.com)

​

API di Analisi del Codice Claude

​

Concetti chiave

• Aggregazione giornaliera: Restituisce metriche per un singolo giorno specificato dal parametro starting_at
• Dati a livello utente: Ogni record rappresenta l’attività di un utente per il giorno specificato
• Metriche di produttività: Traccia sessioni, righe di codice, commit, pull request e utilizzo degli strumenti
• Dati di token e costi: Monitora l’utilizzo e i costi stimati suddivisi per modello Claude
• Paginazione basata su cursore: Gestisci grandi set di dati con paginazione stabile utilizzando cursori opachi
• Freschezza dei dati: Le metriche sono disponibili con un ritardo fino a 1 ora per coerenza

​

Esempi di base

​

Ottieni analisi per un giorno specifico

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: $ADMIN_API_KEY"

​

Ottieni analisi con paginazione

# Prima richiesta
curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?\
starting_at=2025-09-08&\
limit=20" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

# Richiesta successiva utilizzando il cursore dalla risposta
curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?\
starting_at=2025-09-08&\
page=page_MjAyNS0wNS0xNFQwMDowMDowMFo=" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

​

Parametri di richiesta

​

Metriche disponibili

​

Dimensioni

• date: Data in formato RFC 3339 (timestamp UTC)
• actor: L’utente o la chiave API che ha eseguito le azioni di Claude Code (sia user_actor con email_address o api_actor con api_key_name)
• organization_id: UUID dell’organizzazione
• customer_type: Tipo di account cliente (api per clienti API, subscription per clienti Pro/Team)
• terminal_type: Tipo di terminale o ambiente dove è stato utilizzato Claude Code (es. vscode, iTerm.app, tmux)

​

Metriche principali

• num_sessions: Numero di sessioni distinte di Claude Code 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 attraverso la funzionalità di commit di Claude Code
• pull_requests_by_claude_code: Numero di pull request create attraverso la funzionalità PR di Claude Code

​

Metriche delle azioni degli strumenti

• 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

• model: Identificatore del modello Claude (es. claude-3-5-sonnet-20241022)
• 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 USD per questo modello
• estimated_cost.currency: Codice valuta per l’importo del costo (attualmente sempre USD)

​

Struttura della risposta

{
  "data": [
    {
      "date": "2025-09-01T00:00:00Z",
      "actor": {
        "type": "user_actor",
        "email_address": "[email protected]"
      },
      "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-3-5-sonnet-20241022",
          "tokens": {
            "input": 100000,
            "output": 35000,
            "cache_read": 10000,
            "cache_creation": 5000
          },
          "estimated_cost": {
            "currency": "USD",
            "amount": 1025
          }
        }
      ]
    }
  ],
  "has_more": false,
  "next_page": null
}

​

Paginazione

1. Effettua la tua richiesta iniziale con il parametro opzionale limit
2. Se has_more è true nella risposta, utilizza il valore next_page nella tua prossima richiesta
3. Continua fino a quando has_more è false

​

Casi d’uso comuni

• Dashboard esecutive: Crea report di alto livello che mostrano l’impatto di Claude Code sulla velocità di sviluppo
• Confronto di strumenti AI: Esporta metriche per confrontare Claude Code con altri strumenti di codifica AI come Copilot e Cursor
• Analisi della produttività degli sviluppatori: Traccia le metriche di produttività individuali e del team nel tempo
• Tracciamento 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 l’adozione di Claude Code internamente

​

Domande frequenti

​

Quanto sono freschi i dati di analisi?

​

Posso ottenere metriche in tempo reale?

​

Come vengono identificati gli utenti nei dati?

• user_actor: Contiene email_address per utenti che si autenticano tramite OAuth (più comune)
• api_actor: Contiene api_key_name per utenti che si autenticano tramite chiave API

​

Qual è il periodo di conservazione dei dati?

​

Quali distribuzioni di Claude Code sono supportate?

​

Quanto costa utilizzare questa API?

​

Come calcolo i tassi di accettazione degli strumenti?

​

Quale fuso orario viene utilizzato per il parametro data?

​

Vedi anche

• Panoramica API di Amministrazione
• Riferimento API di Amministrazione
• Dashboard di Analisi del Codice Claude
• API di Utilizzo e Costi - Traccia l’utilizzo dell’API in tutti i servizi Anthropic
• Gestione identità e accesso
• Monitoraggio dell’utilizzo con OpenTelemetry per metriche personalizzate e avvisi