O TokenEater monitora os limites de uso do Claude e do OpenAI Codex a partir da barra de menus do macOS. Mostra percentuais ao vivo com limites de cor, um painel com histórico e gráficos de ritmo, widgets nativos do WidgetKit e uma sobreposição flutuante com as sessões do Claude Code em andamento. Lê o token OAuth que o Claude Code guarda no Chaveiro do macOS e chama o endpoint de uso da Anthropic, somente leitura; para o Codex, lê ~/.codex/auth.json.
O que ela faz
Onde TokenEater roda e o que acrescenta, segundo a documentação
Percentuais na barra de menus para as janelas de cinco horas e semanal, com código de cores
Painel com minigráficos, gráficos de ritmo e histórico de 24 h a 90 d a partir dos registros locais de sessão
Widgets nativos do WidgetKit para o uso do Claude e do Codex
Sobreposição Agent Watchers que lista as sessões ativas do Claude Code e salta para o terminal
Várias contas do Claude, cada uma com sua própria pasta de configuração
Notificações por evento e temas personalizados
Quando usar
Boa adequação
Você paga o Claude Pro, Max ou Team e quer ver a janela semanal antes que ela acabe
Você usa o Claude Code ou o Codex CLI o dia todo em um Mac
Não indicado para
O plano gratuito do Claude, que não expõe dados de uso
Contas do Codex com chave de API
Windows ou Linux
Como instalar o TokenEater
Você precisa de: macOS 14 ou posterior; Plano Claude Pro, Max ou Team, ou Codex CLI conectado com o ChatGPT
Baixe o TokenEater.dmg na página de versões do GitHub e arraste-o para Aplicativos
Ou com o Homebrew: brew tap AThevon/tokeneater e depois brew install --cask tokeneater (brew trust AThevon/tokeneater no Homebrew 6+)
Entre uma vez no Claude Code para que o token OAuth fique no Chaveiro
Abra o TokenEater; o item da barra de menus aparece
Permissões e segurança
A que ela tem acesso
Lê o token OAuth do Claude Code no Chaveiro do macOS por meio da ferramenta security
Lê ~/.codex/auth.json para o Codex
Chama endpoints de uso e de perfil somente leitura; o README afirma que nunca grava nem renova tokens
Notas de segurança dos mantenedores
Builds compilados a partir do código-fonte não são notarizados, por isso o Gatekeeper bloqueia a primeira abertura
Revise a fonte antes de conceder ao agente acesso a credenciais ou sistemas de produção. Documentamos o que os mantenedores informam; não auditamos o código.
Limitações
Depende de endpoints de uso não documentados que os fornecedores podem alterar
Ferramenta de programação agêntica da Anthropic que lê sua base de código, edita arquivos e executa comandos pelo terminal, por IDEs, pelo app desktop ou pelo navegador.
Atenção: Não está incluído no plano Claude Free, e o uso nas assinaturas é limitado pelos limites de cada plano.
O TokenEater funciona com o plano gratuito do Claude?
Não. O README diz que o plano gratuito do Claude não expõe dados de uso; é necessário um plano Pro, Max ou Team.
Como o TokenEater lê o uso do Claude?
Ele lê o token OAuth que o Claude Code armazena no Chaveiro do macOS e chama os endpoints de uso e de perfil da Anthropic, somente leitura; o README afirma que nunca grava nem renova credenciais.
O TokenEater é compatível com o Codex?
Sim, com o Codex CLI conectado pelo ChatGPT: ele lê o token em ~/.codex/auth.json. Contas do Codex com chave de API não são compatíveis.