Anthropic lancia in beta la Usage and Cost Analytics API: costi di Claude per utente e modello

Se usi Claude via API per un prodotto, un’agenzia o un team interno, da poco hai uno strumento in più per capire dove vanno i tuoi soldi. Il 29 ottobre 2026 Anthropic ha aperto in beta la Usage and Cost Analytics API, una nuova coppia di endpoint che restituisce consumi e costi dell’organizzazione con un livello di dettaglio molto più alto rispetto al passato.

La novità non è solo tecnica. Cambia il modo in cui puoi attribuire la spesa: non più soltanto per chiave o per workspace, ma anche per utente, per account di servizio e per prodotto.

La fonte primaria è la documentazione ufficiale di Claude Platform, che ho usato come base per questo articolo.

Cosa è successo: due nuovi endpoint in beta

L’API espone due richieste GET sotto il percorso delle organizzazioni: una per l’uso, che restituisce conteggi di token e di richieste, e una per il costo, che restituisce gli importi in dollari statunitensi. Entrambe sono in beta, quindi ogni chiamata deve includere l’header anthropic-beta con il valore indicato dalla documentazione, oltre all’header di versione. Gli SDK ufficiali e la CLI li inviano in automatico, e questo è un dettaglio comodo se non vuoi gestire gli header a mano.

Ogni riga della risposta contiene l’intervallo temporale, il gruppo di dimensioni richieste e le metriche di uso o di costo. Se non chiedi alcun raggruppamento e nessuna suddivisione temporale, ottieni una sola riga con il totale dell’intero periodo.

Per chi lavorava già con i report di Anthropic, la documentazione tratta ora la vecchia Usage and Cost API come soluzione legacy. Resta supportata, ma la pagina dedicata consiglia di usare la nuova API per le nuove integrazioni.

Le dimensioni di raggruppamento

Il cuore della novità è il parametro di raggruppamento, che accetta fino a cinque dimensioni insieme. Tra quelle elencate dalla documentazione ci sono il modello, il workspace, la chiave API, l’attore che ha generato la richiesta, il tipo di attore, il livello di servizio, il prodotto, la finestra di contesto, la geografia di inferenza e la velocità. Compaiono anche dimensioni legate a funzioni più recenti, come gli identificativi di agenti, ambienti, deployment e sessioni dei Managed Agents.

Non tutte le dimensioni valgono per ogni organizzazione. La chiave API, per esempio, riguarda solo le organizzazioni Console, mentre il canale Slack è pensato per Claude Enterprise. Le dimensioni non applicabili tornano nulle e i relativi filtri non trovano corrispondenze.

Perché è importante per chi paga il conto

Finora la domanda più frequente nei team era semplice: chi sta consumando così tanti token? Con report per chiave e per workspace potevi indovinare, ma se più persone condividevano la stessa chiave la risposta restava vaga. Ora il campo dell’attore permette di risalire all’utente o all’account di servizio dietro la richiesta, e questo rende possibile un vero addebito interno per progetto o per persona.

Per un libero professionista o un’agenzia che gira con più clienti sullo stesso account, la cosa è ancora più concreta. Se separi i clienti con workspace diversi e poi incroci i dati con modello e livello di servizio, puoi costruire un preventivo basato sul consumo reale, non su stime a spanne.

Anche la parte sui costi è più curata. L’importo restituito è calcolato dopo gli sconti e prima dei crediti, mentre un secondo campo mostra il prezzo di listino. Il confronto tra i due ti dice quanto stai risparmiando grazie ad accordi o sconti, e ti torna utile se hai un contratto negoziato. Un caso recente è quello dello sconto del 40% di Anthropic per il governo americano, che mostra quanto i prezzi contrattuali possano discostarsi dal listino.

In sintesi: più granularità significa più controllo, e più controllo significa meno sorprese a fine mese.

Chi può usarla e con quali credenziali

L’accesso dipende dalla piattaforma da cui usi Claude. Nella Claude Console serve una chiave di amministrazione oppure un token OAuth con ambito amministrativo, e l’API non è disponibile per gli account individuali: devi avere un’organizzazione. Su Claude Enterprise occorre una chiave con ambito di lettura delle analisi, creata dal proprietario principale dopo aver attivato la Analytics API.

La documentazione descrive anche due ambienti cloud. Su Claude Platform on AWS entrambi gli endpoint sono disponibili tramite autorizzazioni IAM, ma ogni richiesta copre soltanto i workspace della regione interrogata, quindi devi ripetere la chiamata regione per regione. Su Claude Models on Google Cloud servono permessi IAM distinti per uso e costi. In entrambi i casi alcune dimensioni, come quelle degli agenti gestiti, risultano sempre nulle.

Se oggi usi il piano consumer

Se stai pensando ai piani personali, questa API non fa per te. I piani per singoli utenti sono stati appena rinominati, come racconto in questo approfondimento su Claude Max e Ultra, e restano fuori da questi report organizzativi. Per un professionista che usa solo l’app, la strada resta il controllo dei limiti dall’interfaccia.

Limiti, tempistiche e differenze con la vecchia API

Prima di buttarti sull’integrazione, è bene conoscere i vincoli. La data di inizio non può precedere il primo gennaio 2026 e deve cadere negli ultimi 365 giorni. Una singola richiesta copre al massimo 31 giorni, che diventano 24 ore se scegli la suddivisione al minuto. Le suddivisioni temporali disponibili sono al minuto, all’ora e al giorno, sempre in UTC.

Qui c’è la differenza più importante rispetto alla vecchia API. I dati dei report legacy comparivano in genere entro cinque minuti, mentre nella nuova API si aggiornano di norma entro quattro ore e possono impiegare fino a 24 ore. Ogni risposta riporta un campo con l’orario dell’ultimo aggiornamento, utile per capire se i dati più recenti sono completi.

Inoltre i valori possono ancora cambiare fino a circa sette giorni dopo la fine del mese. Per chiudere un conteggio definitivo, quindi, conviene interrogare soltanto mesi conclusi da almeno una settimana.

Cambia anche la forma dei dati. La vecchia API restituiva intervalli temporali in ordine cronologico, compresi quelli vuoti. La nuova restituisce righe ordinate per importanza, per impostazione predefinita dalla più grande, e omette le combinazioni senza dati. Se hai già dashboard costruite sul formato precedente, dovrai riadattarle: cambiano il nome del parametro per l’intervallo, il significato del limite di righe e i campi che identificano gli utenti.

Un dettaglio sui costi: le richieste coperte da un impegno di Priority Tier compaiono nell’uso con il relativo livello di servizio, ma non contribuiscono all’importo, e la quota fissa dell’impegno non è inclusa. Se hai questo tipo di contratto, tieni conto di questa lacuna nei tuoi calcoli.

Come puoi sfruttarla subito

Il modo più pratico per iniziare è partire da un report semplice: totale dei costi del mese raggruppato per modello e per workspace. Da lì aggiungi l’attore per scoprire chi pesa di più, poi il livello di servizio per capire se stai pagando extra per priorità che non ti servono.

Alcune idee concrete per un team o un’agenzia:

• costruire un report mensile per cliente, usando un workspace per ciascuno;
• impostare un controllo settimanale sui modelli più costosi, per valutare se alcuni flussi possono passare a un modello più economico;
• confrontare importo e prezzo di listino per verificare l’effetto degli sconti contrattuali.

Ricorda però che, con un ritardo fino a un giorno, questa API non è adatta ad allarmi in tempo reale. Per bloccare una spesa fuori controllo ti servono limiti di budget e quote lato workspace, non un report a posteriori.

Perché conta anche per chi fa SEO e marketing con l’AI

Molti flussi di contenuti, analisi di keyword e automazioni di marketing oggi poggiano su chiamate API ripetute. Quando il volume cresce, la differenza tra un progetto sostenibile e uno in perdita sta spesso nel costo per attività. Sapere quanto consuma ogni automazione ti permette di fissare un prezzo corretto al cliente e di scegliere il modello giusto per ogni compito. Se lavori con questi strumenti, ti consiglio anche di rivedere le nostre risorse su Claude AI per scegliere la configurazione più adatta.

Conclusioni

La Usage and Cost Analytics API non è una funzione appariscente, ma risolve un problema reale: rendere la spesa AI leggibile e attribuibile. È ancora in beta, quindi aspettati modifiche, e il ritardo nei dati la rende uno strumento di analisi più che di controllo immediato.

Se gestisci un’organizzazione su Claude, il passo successivo è semplice: leggi la documentazione ufficiale, genera una chiave di amministrazione e prova un primo report mensile per modello e workspace. In pochi minuti vedrai dove si concentra la spesa e potrai decidere dove intervenire. Dimmi nei commenti se vuoi una guida passo passo con esempi di chiamata.