Limites de uso do Claude Code: como gastar menos tokens

Os limites de uso do Claude Code medem os tokens que suas sessões consomem: todo o texto que o Claude lê dos seus arquivos e da conversa, e todo o texto que ele escreve de volta. Nos planos Pro, Max e Team esse uso sai de uma cota que é renovada em uma janela móvel de cinco horas, com um limite semanal por cima, e ela é dividida com seus chats no Claude. Em uma conta de API você paga por cada token, e a Anthropic não publica um número fixo de mensagens para nenhum plano.

O resto deste guia explica o que conta, como cada plano mede o uso, como ver onde você está e oito hábitos que fazem o mesmo plano render muito mais.

Tokens do Claude Code: o que conta como uso

Toda vez que você manda uma mensagem, o Claude Code envia a conversa inteira de novo: as instruções, seu CLAUDE.md, cada mensagem anterior e cada arquivo que ele leu. Por isso, como explica o guia de custos da Anthropic, uma pergunta de uma linha no fim de uma sessão longa consome uso pela conversa toda.

Além das suas mensagens, isto também soma:

• Arquivos e saídas que o Claude lê. Logs grandes, planilhas, PDFs e imagens entram no contexto e ficam lá.
• Raciocínio. O raciocínio estendido é cobrado como tokens de saída, e um nível de esforço mais alto significa mais raciocínio.
• Ajudantes. Cada subagente ou fluxo que o Claude inicia faz suas próprias requisições, além das suas.
• Trabalho agendado. Um /loop ou uma tarefa agendada dispara no seu intervalo mesmo quando você não está, reenviando o contexto a cada vez.
• Pequenas requisições em segundo plano. Recursos como resumos de conversa para retomar custam um pouco mesmo parados, o que a documentação coloca normalmente abaixo de $0.04 por sessão.

Como funcionam os limites do Claude Code em cada plano

A página de preços da Anthropic diz que todo plano tem limites renovados em uma janela móvel de cinco horas, que os planos pagos somam limites semanais e que sua atividade na web, no desktop, no celular e no Claude Code tira da mesma cota.

Como ver o seu uso

Nos planos pagos, o detalhamento do /usage atribui o uso recente a skills, subagentes, plugins e servidores MCP individuais, e sinaliza comportamentos como contexto longo ou falhas de cache quando eles passam a causar um décimo do seu uso recente. Antes de uma janela acabar, o Claude Code também pode avisar com uma linha como You've used 85% of your session limit · resets 3:45pm.

Por que você bate no limite antes do esperado

• Uma sessão longa para tudo. Cada mensagem carrega o histórico completo, então tarefas sem relação na mesma sessão ficam pagando umas pelas outras.
• Voltar depois de uma pausa. Na assinatura o cache de prompt dura uma hora, caindo para cinco minutos quando você passa a usar créditos de uso, então a primeira mensagem depois de uma pausa longa reprocessa o contexto inteiro sem o desconto do cache.
• O maior modelo, com esforço alto, para tarefas pequenas. Renomear arquivos não precisa do modelo mais capaz pensando muito.
• Muitos ajudantes ao mesmo tempo. Subagentes e fluxos multiplicam as requisições, e a documentação da Anthropic diz que equipes de agentes usam cerca de 7 vezes mais tokens que uma sessão comum quando os colegas rodam em plan mode.
• Loops e agendamentos esquecidos ligados. Eles continuam disparando enquanto a sessão fica parada.
• Uso pesado do chat no mesmo dia. Seus chats no Claude saem da mesma cota.
• Picos grandes. O uso conta ao mesmo tempo contra a cota da sessão e a semanal, então um pico pesado pode esgotar o limite semanal antes de a janela de cinco horas ser renovada.

O que acontece quando você bate no limite

As mensagens de limite estão listadas na referência de erros da Anthropic, e cada uma informa o horário de renovação. Em uma sessão interativa conectada com uma assinatura, o Claude Code pode esperar e continuar a tarefa sozinho depois da renovação, desde que você deixe a sessão aberta.

Você também tem estas opções:

• /rate-limit-options mostra formas de continuar, incluindo esperar e seguir automaticamente.
• /usage-credits ativa os créditos de uso, que deixam você trabalhar além do limite do plano pelas taxas padrão da API; no Pro e no Max dá para definir um limite mensal de gasto em Settings > Usage.
• /upgrade abre a página para mudar para um plano maior, com limites base maiores.
• Uma conta no Claude Console com créditos de API, para uma maratona intensa cobrada por token.

8 formas de gastar menos tokens

A escolha do modelo é a alavanca mais fácil de ver em números: na API, os preços de saída variam 100 vezes entre o menor e o maior modelo atual.

1. Limpe entre tarefas. O /clear começa uma conversa nova e não custa nada, então o contexto antigo para de ir junto em cada mensagem. Rode /rename antes se quiser voltar a ela com /resume.
2. Compacte nas pausas naturais, com um foco. /compact keep the decisions and the list of files we changed encolhe o histórico mantendo o que importa. Faça isso entre tarefas, não no meio delas, e use o "Summarize from here" do menu de voltar para comprimir só uma parte da sessão.
3. Combine o modelo com o trabalho. O Opus 5.5 é o padrão nos planos pagos; troque com /model para o Sonnet no trabalho do dia a dia e para o Haiku em tarefas simples e mecânicas.
4. Baixe o esforço em trabalho simples. /effort low serve para renomear, formatar e fazer edições rápidas, e o Opus 5.5 já vem em medium por padrão. Para uma pergunta difícil, digite ultrathink naquele prompt em vez de subir o esforço da sessão inteira.
5. Seja específico e aponte arquivos. "Corrija a tabela de preços em @index.html" lê um arquivo; "melhore o site" faz o Claude vasculhar tudo.
6. Mantenha o CLAUDE.md enxuto. Ele é carregado em toda sessão, então deixe abaixo de 200 linhas e leve procedimentos passo a passo para skills, que só carregam quando usadas. O guia do CLAUDE.md mostra o que vai onde, e como criar uma skill do Claude cobre o resto.
7. Desligue o que você não usa. Desative servidores MCP parados no /mcp, peça resumos em vez de despejos completos de log e passe trabalho pesado em logs para um subagente, para que só o resumo volte.
8. Planeje mudanças grandes e pare cedo. O plan mode evita retrabalho caro, o Esc interrompe um caminho errado na hora e, depois de duas correções que não funcionaram, um /clear com um prompt melhor vale mais que uma terceira tentativa.

Quando uma tarefa longa precisa continuar amanhã, uma nota de passagem deixa você começar do zero sem perder o fio:

Escreva uma nota de passagem curta em handoff.md: no que estávamos trabalhando, o que está pronto, o que falta, os arquivos envolvidos e as decisões que eu tomei. Mantenha em menos de 20 linhas.

Depois rode /clear e comece a próxima sessão com "Leia @handoff.md e continue de onde paramos". A cheat sheet do Claude Code lista todos os comandos citados aqui em uma página.

O que fazer agora

Abra o /usage na sua próxima sessão e olhe o detalhamento antes de mudar qualquer coisa, para saber se o seu maior gasto é contexto longo, ajudantes ou um modelo pesado. Depois escolha dois hábitos da lista, como limpar entre tarefas e baixar o esforço no trabalho de rotina, e use os dois por uma semana. O tutorial para iniciantes coloca esses hábitos em um primeiro projeto, e o curso de Claude Code tem aulas sobre como escrever prompts sem perder tempo e como dar ao Claude o contexto certo.