Registros locais ajudam a acompanhar o consumo de Claude Code e Codex CLI, mas o custo calculado a partir de tokens não equivale automaticamente à cobrança de uma assinatura. Para controlar gastos, separe a estimativa do uso informado pelo provedor e faça o controle rejeitar qualquer consumo que não consiga precificar.
1. Identifique o que você está medindo
Um registro local acompanha eventos e contagens salvos no computador. Uma estimativa equivalente à tarifa de API multiplica os tokens por valores definidos numa tabela de preços; ela não revela, por si só, quanto uma assinatura cobra ou consome do limite do plano.
Um script em Python descrito pela Shattered.io lê arquivos JSONL, formato em que cada linha contém um registro, e agrupa o uso por dia, modelo, projeto ou ferramenta. O script aplica uma tabela de tarifas mantida pelo usuário. Os relatórios de exemplo do tutorial são sintéticos, não medições de uso nem faturas reais.
| Medição | Relatório local | Conta do provedor |
| Base | Registros de uso e tabela de tarifas configurada pelo usuário | Uso informado pelo plano ou cobranças da conta |
| Resultado | Contagens de tokens e estimativas calculadas a partir dessas contagens | Referência para consultar o uso do plano ou as cobranças do provedor |
| Uso principal | Analisar consumo por período, modelo, projeto ou ferramenta | Conferir o uso e as cobranças registrados na conta |
Claude Code usado com cobrança por API e Claude Code usado em uma assinatura não têm a mesma base de cobrança. O mesmo cuidado vale para o Codex: o acesso por uma conta ChatGPT e o uso com uma chave de API correspondem a formas diferentes de contabilizar o consumo. Compare o relatório local com a área de uso ou cobrança da conta correspondente, sem tratar uma estimativa de API como o valor de uma assinatura.
2. Confira os contadores antes de somar o uso do Codex
No fixture de código do OpenAI, total_token_usage representa o uso acumulado e last_token_usage registra o uso da solicitação mais recente. Um relatório pode trabalhar com diferenças entre totais acumulados ou usar os dados por solicitação; esses campos não devem ser confundidos.
| Campo | Escopo registrado | Para que serve na análise |
total_token_usage | Uso acumulado até aquele registro | Comparar totais sucessivos para estimar a variação entre registros |
last_token_usage | Uso da solicitação mais recente | Examinar o consumo associado a uma solicitação individual |
O fixture também inclui cache_write_input_tokens, além de campos de entrada em cache, saída de raciocínio e totais. O parser Codex descrito no tutorial calcula diferenças entre totais acumulados e não armazena cache_write_input_tokens. Por isso, confira quais categorias o seu relatório retém antes de interpretar o total; a presença do campo, por si só, não define como ele é cobrado.
3. Faça o controle rejeitar uso sem preço
O código publicado pelo tutorial contabiliza tokens sem preço, mas a verificação de orçamento considera apenas a soma em dólares. Se um modelo ou uma tarifa necessária não estiver na tabela, o valor não precificado pode ficar fora da soma que o controle verifica. Um controle que pretende impor um teto deve interromper a aprovação quando houver uso sem preço, em vez de tratar o total parcial como completo.
No Codex, a verificação descrita depende de iniciar o programa por uma função de shell que confere o orçamento antes. Abrir o Codex diretamente, sem passar por essa função, contorna essa checagem.
A Anthropic documenta UserPromptSubmit como um hook executado antes de Claude processar um prompt. Para eventos compatíveis, o código de saída 2 bloqueia o evento. Esse ponto permite barrar um prompt antes do processamento; não é uma forma de encerrar uma tarefa que já esteja em andamento.
4. Concilie o uso e considere o trabalho aceito
Use os registros locais para entender padrões de consumo e consulte a conta do provedor para acompanhar o uso ou as cobranças correspondentes. Se o resultado do trabalho também importa, registre separadamente o gasto estimado, o que foi aceito e o tempo de revisão.
Um participante do Reddit, u/Gooner-Psy, relatou acompanhar o custo equivalente à API por texto aceito e o tempo de edição à parte. Em um exemplo pessoal, mencionou US$ 2,40 em tokens e três horas de edição para um texto de apresentação. É um relato individual, não uma referência geral de custo. A distinção é útil: o total de tokens não inclui, por si só, o tempo gasto para revisar ou refazer uma saída.
5. Use um painel pelo que ele mede
Em uma análise publicada em 14 de abril de 2026, a AI Coding Daily mostrou o CodeBurn com gráficos de atividade diária, divisões por projeto e modelo, uso de ferramentas e servidores MCP, além de um filtro por provedor. A pessoa que conduziu a análise explicou que os custos exibidos são estimativas baseadas em tarifas de API, não o uso ou a cobrança de uma assinatura.
Um painel pode facilitar a leitura de padrões e a separação do consumo por provedor. Para conferir o que foi cobrado ou consumido no plano, consulte também a conta do provedor.
