Per monitorare i costi di Claude Code e Codex CLI, puoi leggere i log locali e calcolare stime basate sui token. Queste cifre non coincidono automaticamente con gli addebiti di un abbonamento; inoltre, un controllo di budget che ignora l’uso senza tariffa può sottostimare il totale.
Prima di iniziare: log, tariffe e account
Un tutorial di Shattered.io propone un registro locale in Python che legge i file JSONL delle sessioni, cioè file di testo con un oggetto JSON per riga, e applica una tabella di tariffe mantenuta dall’utente. Il tutorial indica Python 3.11 o successivo. I suoi report d’esempio sono dichiarati sintetici.
Per Claude Code, il tutorial indica i log in ~/.claude/projects, oppure in una directory configurata. Per Codex CLI, il codice di OpenAI registra sessioni JSONL nella directory delle sessioni Codex, normalmente ~/.codex/sessions o una directory scelta dall’utente. Il registro descritto dal tutorial raggruppa i consumi per giorno, modello, progetto o strumento.
Prima di calcolare un costo, chiarisci quale uso stai misurando. Una stima che applica tariffe API ai token è un’equivalenza teorica alle tariffe API, non il prezzo di un abbonamento. L’uso con chiave API e quello tramite un piano, come un account ChatGPT per Codex, seguono basi di fatturazione diverse.
| Aspetto | Registro locale | Account del provider |
| Dato di partenza | Log di sessione locali | Utilizzo o fatturazione mostrati nell’account |
| Risultato | Conteggi dei token e stime calcolate con una tabella di tariffe | Riferimento per l’utilizzo del piano o gli addebiti del provider |
| A cosa serve | Analizzare consumi per progetto, modello o periodo | Controllare l’utilizzo e la fatturazione dell’account |
Cinque passaggi per tenere sotto controllo le stime
- Scegli la base di fatturazione. Separa le sessioni con chiave API da quelle svolte tramite abbonamento. Una stima al prezzo API può aiutare a confrontare i token, ma non rappresenta da sola il costo del piano.
- Individua i log delle sessioni. Parti dalle directory locali di Claude Code o Codex CLI. Il registro descritto da Shattered.io legge file JSONL e consente di aggregare l’attività per giorno, modello, progetto o strumento.
- Controlla quali contatori legge il parser di Codex. Nel fixture del codice di OpenAI compaiono
total_token_usage, il conteggio cumulativo, elast_token_usage, il consumo dell’ultima richiesta. Il parser descritto dal tutorial calcola le differenze tra i totali cumulativi. Il fixture include anchecache_write_input_tokens, un campo che quel parser non conserva.
| Campo | Ambito registrato | Utilità per l’analisi |
total_token_usage | Utilizzo cumulativo della sessione | Seguire il totale accumulato nel tempo |
last_token_usage | Utilizzo dell’ultima richiesta | Esaminare il consumo associato a una singola richiesta |
La presenza di cache_write_input_tokens nel fixture non basta a stabilire come debba essere prezzato. Se una categoria di token non entra nel parser, il conteggio prodotto potrebbe non includerla.
- Fai bloccare il controllo quando manca una tariffa. Nel codice pubblicato del registro, l’aggregatore conta i token non prezzati, ma il comando
guardcontrolla solo la somma in dollari. Se un modello o una tariffa necessaria manca, l’uso può restare fuori dal totale e il controllo può lasciar passare un budget apparentemente rispettato. Per applicare un limite, la regola deve considerare anche i token non prezzati e rifiutare il controllo quando sono presenti.Per Claude Code, Anthropic documenta l’hookUserPromptSubmit, eseguito prima che Claude elabori il prompt: il codice di uscita 2 blocca l’evento nei casi supportati. È un controllo al momento dell’invio del prompt, non un meccanismo per terminare un’attività già avviata. Per Codex, la funzione shell proposta dal tutorial esegue il controllo prima di lanciare il programma tramite quella funzione; avviarecodexdirettamente evita quel passaggio. - Confronta la stima con l’account e con il lavoro prodotto. Usa l’area di utilizzo o fatturazione del provider per verificare l’attività dell’account. Per valutare il costo del lavoro, registra anche i risultati accettati e il tempo di revisione: un contributore Reddit, u/Gooner-Psy, ha raccontato di aver separato la spesa equivalente alle tariffe API dal tempo di editing. Per un riepilogo, ha riferito 2,40 dollari di token e tre ore di editing. È un’esperienza individuale, non una misura valida per ogni progetto.
Come valutare un dashboard
In una recensione pubblicata il 14 aprile 2026, AI Coding Daily ha mostrato CodeBurn con stime giornaliere, suddivisioni per progetto e modello, attività di strumenti e server MCP, e un filtro per provider. Il recensore ha precisato che i costi sono calcolati con tariffe API: per chi usa un abbonamento, quelle cifre non equivalgono necessariamente all’utilizzo o agli addebiti del piano.
Controllo finale
- Verifica che il parser distingua i totali cumulativi dal consumo per richiesta.
- Controlla che il conteggio dei token senza tariffa impedisca al controllo di dichiarare valido un budget incompleto.
- Confronta le stime locali con l’utilizzo e la fatturazione dell’account del provider.
