Pular para o conteúdo

Limite de uso do Claude Code: 5 horas, semanal e o que fazer

Limite de uso do Claude Code em 2026: a janela de 5 horas e o semanal no Pro, Max e Team, como ver seu uso, o que fazer no limite e 8 formas de economizar.

Por Yotam DahanAtualizado 17 min de leituraClaude Code

Limites de uso do Claude Code na tela do /usage: sessão atual com 59% usados, semana atual com 16% usados e os horários de renovação, em um plano Max

Os limites de uso do Claude Code são a cota de um plano Pro, Max ou Team: um limite de sessão renovado em uma janela móvel de cinco horas, mais um limite semanal por cima, os dois divididos com seus chats no Claude. A Anthropic não publica um número fixo de mensagens, porque o uso do Claude Code depende de quantos tokens cada pedido carrega, e uma conta de API paga por token em vez de bater em um teto. Digite /usage no Claude Code para ver quanto resta de cada limite e quando ele é renovado.

Tokens do Claude Code: o que conta como uso

Três termos que valem a pena conhecer

Token

Um pedacinho de texto que o modelo lê ou escreve. Seus arquivos, mensagens e as respostas do Claude são todos medidos em tokens.

Janela de contexto

Tudo o que o Claude enxerga na sessão atual: instruções, CLAUDE.md, a conversa e cada arquivo que ele leu.

Cache de prompt

Uma cópia guardada da conversa até aqui. Reler essa cópia custa menos do que ler tudo do zero, mas ainda conta.

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.
  • Contexto fixo. O CLAUDE.md, as notas da memória automática e a lista das suas ferramentas MCP vão junto em cada pedido. As definições completas das ferramentas MCP só carregam quando o Claude usa aquela ferramenta.
  • Ajudantes. Cada subagente, fluxo ou colega de equipe de agentes 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. Os resumos de conversa para retomar custam um pouco mesmo parados, normalmente menos de $0,04 por sessão, e as sugestões de prompt acrescentam um pedido curto depois de cada resposta.

Como funcionam os limites de uso do Claude Code em cada plano

A página de preços da Anthropic resume as regras no FAQ de planos: uma janela móvel de sessão de cinco horas em todos os planos, limites semanais nos planos pagos e uma única cota para web, desktop, celular e Claude Code. Ela também diz que não existe um número fixo de mensagens, porque o uso depende do tamanho da conversa, do modelo e dos recursos que você usa.

5

horas em cada janela móvel de sessão

25%

a mais nos limites semanais do Claude Code desde 14 de setembro de 2026

20x

o uso do Pro por sessão, no Max 20x

Do FAQ da página de preços do Claude e do artigo sobre limites semanais da Anthropic, conferidos em outubro de 2026.

PlanoComo o uso do Claude Code é medidoModelos Fable
ProUm limite de sessão de cinco horas mais um limite semanalCobrados em créditos de uso, fora dos seus limites
Max 5x e Max 20x5 ou 20 vezes o uso do Pro por sessão, mais um limite semanalAté metade do seu limite semanal, sem custo extra
TeamUma cota por assento de cinco horas e semanal; assentos Premium têm 5 vezes a de um assento StandardAssentos Premium como o Max, assentos Standard em créditos de uso
Enterprise, por usoSem limites por assento; cada token cobrado pelas taxas da APITaxas da API
API (Claude Console)Pagamento por token, com limites de taxa por nível em vez de janelasTaxas da API

As regras do Fable vêm do artigo sobre o Fable nos planos da Anthropic, que também observa que o Fable gasta o seu limite semanal mais rápido do que outros modelos.

O limite de 5 horas e o limite semanal

  • O limite de sessão é renovado em uma janela móvel de cinco horas. Quando ele acaba, o Claude Code para até o horário mostrado na mensagem.
  • O limite semanal vale para todos os modelos e é renovado em um dia e horário fixos atribuídos à sua conta, e não no momento em que você começou a trabalhar. Os artigos de ajuda da Anthropic sobre Pro e Max dizem que o seu horário de renovação aparece em Settings > Usage.
  • Os dois contam ao mesmo tempo, então um pico pesado, como um fluxo grande, pode esgotar o limite semanal antes de a janela de cinco horas ser renovada.

Os limites mudaram várias vezes este ano, e é por isso que dicas do começo de 2026 muitas vezes parecem erradas agora:

  1. 6 de maio de 2026Os limites de cinco horas do Claude Code dobram no Pro, Max, Team e Enterprise por assento, e a redução nos horários de pico acaba no Pro e no Max.
  2. 13 de maio de 2026Uma promoção aumenta em 50% os limites semanais do Claude Code até 13 de setembro.
  3. 19 de julho de 2026O Fable 5 passa para créditos de uso no Pro e nos assentos Team Standard.
  4. 14 de setembro de 2026Os limites semanais do Claude Code ficam permanentemente 25% maiores do que antes da promoção.
  5. 22 de setembro de 2026O Opus 5.5 é lançado com limites de cinco horas maiores e uma renovação de limite que os assinantes podem guardar para depois.

Fontes: o anúncio de 6 de maio da Anthropic, o artigo sobre limites semanais citado acima e o post de lançamento do Opus 5.5. Se o seu limite semanal parece menor desde meados de setembro, é o fim da promoção de 50%: o novo nível fica abaixo da promoção, mas acima de onde começou.

Limites de uso do Claude Pro: quanto você recebe?

A Anthropic não publica um número. O Pro dá pelo menos 5 vezes o uso do plano Free por sessão de cinco horas, e a página do Claude Code da Anthropic o posiciona para maratonas curtas de código em projetos pequenos. Ele usa o Opus 5.5 por padrão, segundo a documentação de configuração de modelos. Se o Pro trava você mais de duas vezes por semana, o nosso guia de preços do Claude Code mostra quando o Max compensa.

Como ver o uso do Claude Code

Cinco lugares para ver onde você está

/usage

Dentro do Claude Code: barras de uso do plano, horários de renovação e um detalhamento do que consumiu. Aperte d ou w para alternar entre 24 horas e 7 dias. O /cost e o /stats abrem a mesma tela.

Settings > Usage

No claude.ai ou no app desktop: barras da sessão atual e dos seus limites semanais, uma barra do Fable no Max e os seus créditos de uso.

Anel de uso no desktop

Na aba Code do app desktop, o anel ao lado do seletor de modelo mostra o uso do contexto e do plano.

VS Code

O /usage abre a janela Account & usage, com as mesmas barras e uma alternância entre Day e Week.

/context

Mostra o que está enchendo a conversa atual, para você entender por que cada mensagem está ficando mais pesada.

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. O detalhamento só conta as sessões daquele computador, então seus chats no claude.ai não aparecem nele, mesmo tirando dos mesmos limites.

No nosso próprio plano Max, o detalhamento apontou um hábito na hora:

Detalhamento do /usage do Claude Code dizendo que 85% do uso veio de sessões cheias de subagentes, com a dica de usar um modelo mais barato em subagentes simples
Detalhamento real do /usage, outubro de 2026. Cada subagente faz suas próprias requisições, então trabalho pesado em paralelo esgota os limites mais rápido.

Antes de uma janela acabar, o Claude Code também avisa com uma linha como You've used 85% of your session limit · resets 3:45pm.

Rastreadores de terceiros como o ccusage, de código aberto, leem os arquivos de log locais do Claude Code e estimam tokens e custos em dólar por dia ou por sessão. Eles ajudam a achar os seus dias mais pesados, mas só o /usage e Settings > Usage mostram as porcentagens reais do seu plano.

Coloque um monitor de uso na sua linha de status

A linha de status é a linha abaixo da caixa do prompt. O Claude Code consegue montar uma que mostra o tempo todo as suas porcentagens de cinco horas e semanal. Digite isto dentro do Claude Code:

Um monitor de uso na sua linha de status
/statusline mostre o nome do modelo, a minha porcentagem de uso de 5 horas e a minha porcentagem de uso semanal

Ele escreve um pequeno script e ativa para você. A documentação da linha de status da Anthropic diz que os números de uso só aparecem para assinantes Pro e Max, e só depois da primeira resposta do Claude na sessão.

Por que você bate nos limites do Claude Code tão rápido

  • 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.
  • O maior modelo, com esforço alto, para tarefas pequenas. Renomear arquivos não precisa do modelo mais capaz pensando muito, e o Fable esgota o limite semanal mais rápido.
  • Muitos ajudantes ao mesmo tempo. 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, e os loops continuam disparando enquanto você está longe.
  • Uso pesado do chat no mesmo dia. Seus chats no Claude saem da mesma cota.

A Anthropic lista as mesmas causas na sua documentação de custos, e o /usage sinaliza a que mais está custando para você, quase sempre contexto longo ou falhas de cache.

O que fazer quando você bate no limite

O que acontece no limite
  1. Aviso antecipado

    O Claude Code avisa quando a maior parte da janela já foi usada

  2. Limite atingido

    As requisições param até o horário de renovação mostrado na mensagem

  3. Esperar ou pagar

    O Claude Code espera e continua, ou você adiciona créditos de uso

  4. De volta ao trabalho

    Depois da renovação, a tarefa interrompida continua de onde parou

Toda mensagem de limite informa o horário de renovação. A referência de erros da Anthropic lista cada variação, e a tabela mais abaixo explica todas.

Quando o limite de uso do Claude Code é renovado?

O limite de sessão é renovado no horário da mensagem, e o semanal no horário semanal fixo da sua conta; o /usage mostra os dois. Se o Claude Code parar você no meio de uma resposta, ele pode terminar primeiro a etapa em andamento e mostrar Usage limit reached · wrapping up. A Anthropic diz que essa pequena margem está sendo liberada aos poucos e vale uma vez por semana no Pro e em todo limite de cinco horas no Max.

Você não precisa reiniciar a tarefa à mão. Em uma sessão interativa conectada com uma assinatura, o Claude Code espera e depois continua sozinho, mostrando Continuing automatically at 3:45pm · esc to cancel. Deixe a sessão aberta; para uma renovação a mais de 24 horas, como um limite semanal, ele pergunta antes, e você escolhe Wait here, then continue automatically no /rate-limit-options.

Continue trabalhando com créditos de uso

Os créditos de uso, que até pouco tempo atrás se chamavam extra usage, deixam você continuar trabalhando além de um limite pelas taxas padrão da API. No Pro ou no Max, o /usage-credits abre Settings > Usage, onde você os ativa, paga um saldo antecipado e define um limite mensal de gasto (artigo sobre créditos de uso). No Team e no Enterprise, o mesmo comando abre as configurações de uso da sua organização ou manda um pedido ao seu admin.

Se você recarrega com frequência, os pacotes pré-pagos do artigo sobre pacotes de uso da Anthropic custam menos do que pagar conforme usa:

Pacotes de créditos de uso no Pro, Max e Team
$45

por um pacote de $50, 10% de desconto

$200

por um pacote de $250, 20% de desconto

$700

por um pacote de $1.000, 30% de desconto

Os pacotes só valem depois que você passa dos limites do seu plano, e o desconto para depois de $2.000 em pacotes por mês no Pro e no Max. Conferido em outubro de 2026.

Outros caminhos

  • Uma renovação gratuita do limite. A Anthropic de vez em quando dá uma renovação aos planos elegíveis, a mais recente no lançamento do Opus 5.5. Se você tiver uma, um botão Reset for free aparece em Settings > Usage na web ou no app desktop, não no terminal, e ele recarrega na hora o limite de sessão ou o semanal. Guarde para uma semana de prazo apertado.
  • /upgrade abre a página para mudar para um plano maior. Os novos limites valem na hora; rode /logout e /login para o Claude Code reconhecê-los.
  • Uma conta no Claude Console com créditos de API, para uma maratona intensa cobrada por token.

Mensagens de limite do Claude Code e o que significam

O que você vêO que significaSolução
You've used 85% of your session limit · resets 3:45pmA janela de cinco horas está quase usadaTermine a etapa atual e escreva uma nota de passagem
You've hit your session limit · resets 3:45pmA janela de cinco horas acabouDeixe o Claude Code esperar e continuar, ou ative os créditos de uso
You've hit your weekly limit · resets Mon 12:00amO limite semanal acabouTrocar de modelo não ajuda; use créditos de uso, uma renovação de limite ou um plano maior
You've hit your Opus limit · resets 3:45pmUm limite de uma família de modelosRode /model e escolha um modelo fora dessa família
You've hit your monthly spend limitSeus créditos de uso chegaram ao teto que você definiuAumente em Settings > Usage, ou espere o horário de renovação que a mensagem cita
Usage credits required for 1M contextVocê escolheu um modelo com contexto de 1M que o seu plano só oferece com créditosRode /model e escolha a versão sem [1m]
Fast mode requires usage creditsO fast mode nunca usa os limites do planoAtive os créditos de uso, ou mantenha a velocidade normal
Server is temporarily limiting requests (not your usage limit)Uma limitação curta do lado do servidorEspere um minuto e tente de novo; confira status.claude.com

8 formas de reduzir o uso de tokens no Claude Code

Comece olhando. O /context mostra o que enche a conversa antes mesmo de você digitar qualquer coisa:

Comando /context do Claude Code mostrando o uso de tokens por categoria: prompt de sistema, ferramentas do sistema, skills, mensagens e espaço livre de 1 milhão de tokens
Uma sessão nova: cerca de 27k de 1m de tokens já estão ocupados pelo prompt de sistema, pelas ferramentas e pelas skills. Cada mensagem soma a isso, e é por isso que sessões longas custam mais por turno.

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.

Preço de tabela da API por milhão de tokens de saída em USD, outubro de 2026
  • Haiku 5.5$0,50
  • Sonnet 5.5$10
  • Opus 5.5 (padrão)$20
  • Fable 5.1$50

Da página de preços da Anthropic; a taxa do Haiku 5.5 vale para prompts de até 100K tokens. Assinantes não pagam essas taxas, mas o modelo decide a velocidade com que a cota acaba.

  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. Compactar lê a conversa inteira, então faça isso entre tarefas, não a cada poucos minutos.
  3. Combine o modelo com o trabalho. Troque com /model para o Sonnet no trabalho do dia a dia e para o Haiku em tarefas simples e mecânicas. O /model opusplan planeja com o Opus e depois constrói com o Sonnet.
  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. Cite o arquivo em vez de colar. "Corrija a tabela de preços em index.html" deixa o Claude abrir só o que precisa. A central de ajuda da Anthropic observa que @index.html puxa o arquivo inteiro, então use um caminho simples para arquivos grandes.
  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 arquivo 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. Plugins também contam: cada um ativado acrescenta as descrições das suas skills a toda sessão, e o nosso guia de plugins do Claude Code mostra quanto custam os mais usados.
  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:

Nota de passagem antes de recomeçar
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. Está avaliando o agente da OpenAI? A nossa comparação Codex vs Claude Code coloca os limites dos dois lado a lado.

Teste rápido0 de 3 corretas

Por que uma pergunta rápida custa mais no fim de uma sessão longa?

Você vê "You've hit your weekly limit". Qual destas opções faz você voltar a trabalhar hoje?

Quanto custa o /clear?

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 nosso guia sobre como usar o Claude Code 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.

Rotina de sessão para economizar tokens

Um checklist para o começo, o meio e o fim da sessão, um seletor de modelo e esforço para 10 tarefas comuns e um registro de uma semana para achar o que drena seu plano.

Digite seu e-mail e a seção completa abre aqui mesmo. Você também ganha uma aula grátis do curso.

Sem spam. Cancele com um clique. Usamos seu e-mail para enviar o curso e dicas de IA.

Perguntas frequentes

O Claude Code usa mais tokens que o chat do Claude?

Normalmente, sim. Cada turno do Claude Code carrega conteúdo de arquivos, chamadas de ferramentas e raciocínio em várias etapas, e a documentação de custos da Anthropic diz que uma única sessão de depuração pode usar mais do que um dia de chat. Os dois tiram dos mesmos limites do plano.

O /clear ou uma sessão nova zera o meu limite de uso do Claude Code?

Não. O /clear e uma sessão nova só esvaziam o contexto, para as próximas mensagens custarem menos, mas nenhum dos dois recarrega o limite de cinco horas ou o semanal. Trocar de modelo também não, a menos que a mensagem cite uma família de modelos, como um limite do Opus.

O Claude Code no VS Code ou no app desktop tem limites separados?

Não. As extensões do VS Code e do JetBrains, a aba Code do app desktop e o terminal contam todos para os mesmos limites dos seus chats no Claude. No VS Code, o /usage abre uma janela Account & usage com as mesmas barras.

Uma chave de API sai mais barata que o Pro ou o Max para o Claude Code?

Só para uso leve ou por scripts. A cobrança pela API conta cada token pelo preço de tabela, sem janela de sessão, e a documentação de custos da Anthropic coloca a média em empresas em cerca de $13 por desenvolvedor por dia ativo, o que soma mais rápido do que um plano no trabalho diário com as mãos na massa.

Scripts com claude -p e o Agent SDK contam nos limites do meu plano?

Sim, quando você está conectado com o seu plano. A Anthropic suspendeu uma mudança prevista para junho de 2026 que os teria separado. Os créditos mensais de API do Max e do Team só cobrem esses usos quando você os roda com uma chave de API da organização vinculada no Console, e nunca cobrem o Claude Code interativo.

Existe um painel de uso do Claude Code?

Para a sua própria conta, Settings > Usage no claude.ai é o painel, e o /usage mostra as mesmas barras no terminal. Admins dos planos Team e Enterprise também têm um painel de análise do Claude Code e um relatório de gastos por usuário no console de administração.

Continue lendo