A resposta curta
Confira antes de culpar o MCP. O /usage do Claude Code mostra que parte do seu uso recente do plano foi para cada servidor MCP. Se essa parte é pequena, sessões longas e a escolha do modelo custam mais. Se é grande, desconecte os servidores que você não usa e depois reduza o número de chamadas.
Neste guia
Qual limite você atingiu?
O Claude Code nomeia o limite na própria mensagem, e o que você pode fazer depende de qual é. Em uma assinatura, o uso é contado em uma sessão contínua de cinco horas e em uma janela semanal, e as duas contam ao mesmo tempo.
| Você vê | O que significa | O que destrava |
|---|---|---|
You've hit your session limit / You've hit your weekly limit | Uma cota contínua compartilhada por todos os modelos. Trocar de modelo não a devolve. | Espere o horário de redefinição que aparece na mensagem ou adicione créditos de uso com /usage-credits. |
You've hit your Opus limit / You've hit your Sonnet limit | Um limite só para essa família de modelos. | Troque para um modelo de fora da família com /model e continue trabalhando. |
You've hit your monthly spend limit | Seus créditos de uso chegaram a um limite de gastos. Existem versões da mensagem para uma pessoa, uma organização e uma equipe. | Aumente o limite em Configurações, Uso, no claude.ai, ou peça ao seu administrador. |
Você não precisa ficar de olho no relógio. Com login por assinatura, o Claude Code mostra esta linha e continua depois da redefinição:
Continuing automatically at 3:45pm · esc to cancel
Isso exige a versão 2.1.234 ou posterior e vem ativado por padrão.
Mais uma coisa da documentação: um único pico de atividade intensa, como uma grande distribuição paralela de workflows, pode esgotar a cota semanal antes que a janela de sessão seja redefinida.
Como ver o que seus servidores MCP custam?
Três comandos do Claude Code respondem. Comece pelo primeiro.
/usagecom uma assinatura, mostra os limites do seu plano e detalha o uso recente por skill, subagente, plugin e servidor MCP, em porcentagem. Pressione d para as últimas 24 horas ou w para os últimos 7 dias./contextmostra o que enche sua janela de contexto agora, incluindo as definições de ferramentas MCP./mcplista seus servidores e permite desligar os que você não usa.
Leia os números tendo estes limites em mente
- Os números são aproximados e vêm do histórico de sessões desta máquina. O uso de outros dispositivos ou do claude.ai não está incluído.
- A parte de um servidor conta só as requisições que usaram um resultado de ferramenta dele. O custo de carregar a lista de ferramentas dele não entra nessa parte: procure em
/context. /usagetambém sinaliza comportamentos que respondem por 10% ou mais do seu uso recente, como contexto longo ou falhas de cache, cada um com uma dica.
Depois, leia a linha do MCP
O que costuma custar mais do que o MCP?
O Claude Code envia sua conversa inteira a cada requisição. Então a maior parte do peso é o tamanho dessa conversa, com que frequência ela recomeça fria e qual modelo a lê.
-
Uma sessão longa
Cada requisição relê a conversa inteira. Uma pergunta de uma linha em uma sessão aberta o dia todo ainda consome uso com todo esse histórico.
Faça isto
/clearao mudar para um trabalho sem relação. Não custa nada. -
Um cache frio
Sua primeira mensagem depois de uma pausa maior que o tempo de vida do cache reprocessa todo o seu contexto. O tempo de vida é de uma hora em uma assinatura, e de cinco minutos quando você usa créditos de uso.
Faça istoNão deixe uma sessão enorme parada para voltar a ela depois. No Pro e no Max, ao retomar uma sessão grande, o Claude Code oferece continuar a partir de um resumo.
-
O modelo
O Opus custa várias vezes mais por turno que o Sonnet, e o Sonnet mais que o Haiku. O pensamento estendido também acrescenta tokens.
Faça isto
/modelpara o Sonnet na maior parte da programação, e/effortpara reduzir o pensamento em tarefas simples. -
Trabalho esquecido
Uma tarefa agendada dispara no intervalo dela mesmo com a sessão parada. Cada subagente envia as próprias requisições além das suas, e as equipes de agentes usam cerca de 7 vezes mais tokens que uma sessão padrão quando os colegas de equipe rodam em modo de plano.
Faça istoConfira os loops e os subagentes em
/usagee pare o que você não precisa mais.
O que cortar primeiro, em ordem?
Se o /usage mostra o MCP como uma fatia grande, siga esta lista. Cada passo dá mais trabalho que o anterior.
- Desconecte os servidores que você não usa2 minutos
Rode
/mcpe desligue o que você não tocou nesta semana. O próprio guia de custos do Claude Code dá o mesmo conselho. Você perde essas ferramentas até religá-las. - Confira se o Tool Search está ativadoUma verificação
O Claude Code adia por padrão as definições de ferramentas MCP, então só os nomes das ferramentas e as instruções do servidor entram no seu contexto até que uma ferramenta seja usada. Fica desativado com um
ANTHROPIC_BASE_URLpersonalizado, comENABLE_TOOL_SEARCH=falsee em modelos anteriores à geração Claude 4.5 na Plataforma de Agentes do Google Cloud. - Use uma CLI onde existir uma boaOnde houver
gh,aws,gcloudesentry-clinão acrescentam listagem por ferramenta, e o guia de custos os chama de mais eficientes em contexto do que os servidores MCP. A ressalva: muitos serviços têm um servidor MCP e nenhuma CLI. - Fique de olho nos resultados grandesAo longo do uso
O Claude Code avisa quando uma ferramenta MCP devolve mais de 10.000 tokens e limita um resultado a 25.000 por padrão. Tudo o que volta passa a fazer parte da conversa, que o Claude Code relê a cada requisição seguinte. Peça menos campos ou uma página menor.
- Reduza o número de chamadas2 minutos para instalar
O que sobra é o número de requisições. Cada chamada de ferramenta é mais uma, levando a conversa inteira, e só escrever a tarefa como um programa as elimina. É isso que o Delta MCP faz.
E se o MCP ainda for uma fatia grande?
Então o custo são as chamadas. Cada chamada de ferramenta é mais uma requisição, então uma tarefa de dez etapas são dez requisições, cada uma levando a conversa inteira. O Tool Search não muda isso.
O Delta MCP é um app gratuito que fica entre o Claude Code e seus servidores MCP. Sua IA escreve cada tarefa como um programa em vez de uma chamada de ferramenta por etapa, e o Delta MCP o verifica, aplica tudo ou nada e guarda em Activity, pronto para desfazer. Medimos no Claude Code com o Tool Search ativado:
Sonnet 5.5, de duas a três execuções por variante, o resultado final verificado em cada serviço.
| Tarefa | Tokens | Chamadas ao modelo | Medido em |
|---|---|---|---|
| Corrigir uma release, como códigoCerberus, 152 ferramentas | 13,4× menos | 26 → 6,5 | 5 de outubro |
| Limpar 20 tickets atrasadosUm gerenciador de tickets | 4,8× menos | 5 → 2 | 2 de outubro |
| Fazer login, adicionar 3 contatos e listar os trêsMicrosoft Playwright MCP | 3,9× menos | 12,6 → 4 | 2 de outubro |
Perguntas
Por que meu limite do Claude Code acabou tão rápido?
Em geral, a conversa, não uma ferramenta. O Claude Code envia sua conversa inteira a cada requisição, então uma sessão longa, um cache frio depois de uma pausa, um modelo caro ou tarefas agendadas e subagentes esquecidos vão somando. Rode /usage: ele sinaliza qualquer comportamento com 10% ou mais do seu uso recente.
Trocar de modelo resolve “You've hit your session limit”?
Não. Os limites de sessão e semanal são compartilhados entre todos os modelos. Só os limites do Opus e do Sonnet são por família de modelos: depois de um deles, /model para um modelo de fora da família mantém você trabalhando.
Os servidores MCP contam no meu limite do Claude Code?
Contam. As definições de ferramentas deles (adiadas por padrão), cada chamada e cada resultado fazem parte das requisições que o Claude Code envia, e toda requisição conta. O /usage mostra a parte de cada servidor. No Pro e no Max, os limites são compartilhados entre o Claude e o Claude Code, então o chat usa a mesma cota.
Quando meu limite do Claude Code é redefinido, e ele continua sozinho?
A mensagem mostra a hora da redefinição. Com uma assinatura, duas janelas correm ao mesmo tempo: uma sessão contínua de cinco horas e uma semanal. Em uma sessão interativa, desde a versão 2.1.234, o Claude Code espera e continua a tarefa interrompida depois da redefinição. Vem ativado por padrão, e Esc cancela. /usage-credits permite continuar na hora.
Qual servidor MCP gasta mais?
Rode /usage e pressione w para os últimos 7 dias: cada servidor tem uma porcentagem. Os números são aproximados e vêm só desta máquina. O /context mostra o que as ferramentas de cada servidor ocupam na sua janela.
O Delta MCP aumenta ou corrige meu limite?
Não. O limite é da Anthropic. O que o Delta MCP muda é quantas requisições uma tarefa de várias etapas faz: 3,3–24,1× menos tokens nos nossos testes.
Fontes
- Claude Code, Manage costs effectively (documentation) O detalhamento do /usage por servidor MCP e seus alertas de 10%; por que o uso sobe em uma sessão longa; tempo de vida do cache; escolha do modelo; sobrecarga do MCP; equipes de agentes.
- Claude Code, Error reference (documentation) As mensagens de limite de sessão, semanal, Opus, Sonnet e de gastos, e quais limites são compartilhados entre os modelos.
- Claude Code, Interactive mode (documentation) Esperar a redefinição de um limite de uso e continuar automaticamente (versão 2.1.234).
- Claude Code, Connect Claude Code to tools via MCP (documentation) Tool Search ativado por padrão e quando fica desativado; o aviso de 10.000 tokens e o limite padrão de 25.000 tokens em um resultado de ferramenta.
- Claude Help Center, Models, usage, and limits in Claude Code O Opus custa várias vezes mais por turno que o Sonnet, e o Sonnet mais que o Haiku; toda mensagem anterior é reenviada a cada turno.
- Claude Help Center, Use Claude Code with your Pro or Max plan Os limites de uso são compartilhados entre o Claude e o Claude Code.
- Claude Help Center, Usage limit best practices O limite de sessão de cinco horas e o limite semanal nos planos pagos.
- Delta MCP, Benchmarks Cada medição do Delta MCP desta página, com seu método.
Continue lendo
- Como reduzir o consumo de tokens do MCP e por que é altoComo reduzir o consumo de tokens do MCP: meça com /context, veja os dois custos (lista de ferramentas e idas e voltas) e compare as soluções, até o Tool Search.
- Arquivo de configuração MCP: Claude, Cursor, VS Code e maisOnde Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, Gemini CLI e Codex guardam a configuração MCP: arquivo, chave JSON, servidor remoto e limite.
- MCP vs CLI para agentes de IA: de onde vem a conta de tokensMCP ou CLI para seu agente de IA? O custo de cada um em tokens, o que as medições mostram, quando a CLI ganha, quando o MCP ganha e onde o código vence os dois.
