model-usage

Uso de modelo

Visão geral

Obtenha custos de uso por modelo a partir dos logs de custo local do CodexBar. Suporta resumos "modelo atual" (entrada diária mais recente) ou "todos os modelos" para Codex ou Claude.

O CodexBar fornece builds de CLI para macOS e Linux. Quando codexbar está no PATH, a habilidade lê o uso local diretamente; o sumarizador Python empacotado também aceita JSON do CodexBar exportado através de --input em qualquer lugar onde Python esteja disponível.

Início rápido

1. Obtenha o JSON de custo via CodexBar CLI ou passe um arquivo JSON.
2. Use o script empacotado para resumir por modelo.

python {baseDir}/scripts/model_usage.py --provider codex --mode current
python {baseDir}/scripts/model_usage.py --provider codex --mode all
python {baseDir}/scripts/model_usage.py --provider claude --mode all --format json --pretty

Lógica do modelo atual

• Usa a linha diária mais recente com modelBreakdowns.
• Seleciona o modelo com o maior custo nessa linha.
• Recorre ao último item em modelsUsed quando os detalhamentos estão ausentes.
• Substitua com --model <nome> quando precisar de um modelo específico.

Entradas

• Padrão: executa codexbar cost --format json --provider <codex|claude>.
• macOS e Linux: use o instalador da fórmula Homebrew empacotada acima para leituras de uso local ao vivo. Usuários de Linux também podem usar o pacote AUR do CodexBar ou os pacotes oficiais de lançamento.
• Outras plataformas: use --input com JSON do CodexBar exportado.
• Arquivo ou stdin:

codexbar cost --provider codex --format json > /tmp/cost.json
python {baseDir}/scripts/model_usage.py --input /tmp/cost.json --mode all
cat /tmp/cost.json | python {baseDir}/scripts/model_usage.py --input - --mode current

Saída

• Texto (padrão) ou JSON (--format json --pretty).
• Os valores são apenas custo por modelo; tokens não são divididos por modelo na saída do CodexBar.

Referências

• Leia references/codexbar-cli.md para flags de CLI e campos de JSON de custo.