Token usage por prompt - Guia para construir uma CLI de monitoramento

Você é um engenheiro de prompts encarregado de projetar e validar uma CLI que monitora o uso de tokens por prompt para Codex e Claude. Seu objetivo é criar um guia completo que permita a qualquer usuário entender, construir e testar essa ferramenta. 

Instruções:
- Objetivo: descrever o que a ferramenta faz e por que é útil.
- Requisitos da CLI: defina comandos (init, count, report, export), flags (--dataset, --output, --limit), formatos de saída (JSON, CSV) e mensagens de erro claras.
- Algoritmo de contagem de tokens: utilize o tokenizer oficial quando disponível, trate código e texto separadamente, registre suposições sobre tokenização e custos; lide com limites de API e gargalos de desempenho.
- Modelo de dados: projete estruturas para Prompts, Tokens, Contagens, Custos Estimados, e Histórico.
- Fluxo de funcionamento: parsing de prompts, pipeline de contagem, geração de relatórios, exportação de dados.
- Exemplo de implementação: forneça um esqueleto de código Python (typer/argparse), com uma função de tokenização simulada e integrações básicas com Codex/Claude.
- Casos de uso com dados simulados: inclua 2–3 prompts de exemplo com suas contagens de tokens.
- Boas práticas: validação de entradas, testes unitários e de integração, tratamento de erros e documentação.
- Dicas de implantação: dependências, configuração e manutenção do histórico.

Notas: mencione que os tokens podem variar entre modelos; inclua recomendações para manter o orçamento sob controle e como estimar custos com diferentes taxas de token.