Poucas coisas quebram tanto uma sessão de código quanto um “usage limit reached” no meio de uma refatoração. Os limites do Claude Code são bem previsíveis quando você consegue enxergá-los. Este guia explica as janelas, os jeitos nativos de conferir o uso e como deixar tudo visível no Mac.
Como funcionam os limites de uso do Claude Code
Nos planos de assinatura do Claude, o uso do Claude Code é medido em janelas, e não por token:
- Sessão atual (janela de 5 horas). O uso conta dentro de uma janela móvel de umas cinco horas, que começa na sua primeira mensagem. Quando ela reseta, você tem uma janela cheia de novo.
- Limite semanal. Um limite separado, somando todos os modelos ao longo de sete dias.
- Limites semanais por modelo. Alguns planos também têm limites semanais para modelos específicos, como o Opus.
A Anthropic não divulga os números exatos, e eles dependem do seu plano: o Max 5x e o Max 20x dão cinco e vinte vezes a cota por sessão do Pro. O uso é compartilhado com o chat do Claude na mesma conta. Você também pode conferir na web, no claude.ai, em Settings → Usage. Na prática, existem dois relógios: o de 5 horas decide a sua tarde, o semanal decide a sua semana.
Se você usa o Claude Code com uma chave de API em vez de assinatura, paga por token e essas janelas não se aplicam; seus gastos aparecem no Anthropic Console.
Como ver seu uso dentro do Claude Code
Dentro do Claude Code, rode:
/usage
Ele mostra quanto você já usou da sessão atual e dos limites semanais, e quando cada um reseta. É preciso, mas você tem que lembrar de perguntar, e a informação só aparece enquanto você está olhando aquele terminal.
Deixe seus limites sempre visíveis no Mac
O Vibe Console mostra o uso do Claude Code e do Codex o tempo todo, sem você digitar comando nenhum:
- Anéis no notch e na barra de ferramentas. Um anel por provedor mostra quanto da janela atual você já usou. Um segundo arco, mais fino e opcional, mostra o limite semanal (nos Ajustes: Desativado, Dentro ou Fora).
- Passe o mouse para ver os detalhes. O card lista a sessão atual, o limite semanal de todos os modelos e os limites por modelo, como Opus e Sonnet, cada um com o horário de reset.
- Alertas. Uma notificação do macOS quando um limite passa de 80% e de novo em 100%, uma vez por janela. Quando um limite reseta, um card no notch e um som avisam que você está liberado. Silencie os provedores que não interessam.
- Barra de menus. Se quiser, mostre os limites dos provedores escolhidos na barra de menus, no lugar do ícone.
O uso atualiza a cada minuto enquanto você trabalha, e dá para clicar num anel para atualizar na hora.
De onde vêm os números
Para mostrar seu uso do Claude, o Vibe Console lê o login do Claude Code no seu Mac e pede o seu uso à Anthropic, os mesmos dados que o /usage mostra. O macOS pergunta uma vez se você permite. O login fica no seu Mac e só é enviado para a Anthropic. Você escolhe quais provedores são lidos em Ajustes → Contas. Os detalhes estão na nossa política de privacidade.
Limites de uso do Codex
Os planos do Codex também medem o uso numa janela principal de 5 horas e numa janela semanal. O Vibe Console mostra esses limites do mesmo jeito, ao lado do Claude, para você jogar o trabalho para o agente que tiver folga.
Como fazer seus limites renderem
- Leia a porcentagem junto com o horário de reset. 60% usados faltando uma hora para a janela acabar está ótimo; 60% usados com dez minutos de janela, não.
- Use um modelo mais leve para tarefas simples. Guarde o modelo maior para planejamento e problemas difíceis.
- Mantenha o contexto enxuto. Limpe ou compacte conversas longas e aponte o agente para os arquivos que importam, em vez do repositório inteiro. Skills que economizam tokens ajudam; veja como instalar skills de agentes.
- Planeje o trabalho em paralelo em volta da janela. Vários agentes gastam uma janela várias vezes mais rápido. Veja como rodar agentes em paralelo.
- Divida o trabalho entre provedores. Quando o Claude estiver perto do limite e o Codex não, passe a revisão ou as tarefas menores para o Codex.
Perguntas frequentes
Quanto dura a janela de limite de uso do Claude Code?
A janela da sessão dura umas cinco horas a partir da sua primeira mensagem, e existe um limite semanal separado. Confira o /usage ou o card do anel para ver seus horários exatos de reset.
O que acontece quando eu bato no limite?
O Claude Code avisa que você atingiu o limite da sessão ou o semanal e quando ele reseta. Trocar de modelo não ajuda nesses limites, mas ajuda num limite por modelo, como o do Opus. Para continuar trabalhando, espere o reset, faça upgrade do plano ou rode /usage-credits para seguir com créditos de uso.
O Vibe Console muda os meus limites?
Não. Ele só lê e mostra. Quem decide os limites são o seu plano e o seu agente.
Teste grátis por 14 dias: baixe o Vibe Console.