“Prompt is too long” no Claude Code: o que é e como resolver

Prompt is too long

Durante uma sessão interativa no Claude Code, esse mesmo aviso também aparece escrito de um jeito mais direto:

Context limit reached · /compact or /clear to continue

Em alguns casos, a mensagem traz um complemento explicando por que travou: o trecho “automatic compaction failed” avisa que o resumo automático falhou, enquanto “this conversation is a single exchange” indica que você enviou um texto imenso logo na primeira mensagem e ainda não há conversa anterior para resumir. Já no site claude.ai, pelo navegador, o aviso equivalente é “Your message will exceed the length limit for this chat”.

O que quer dizer

Toda vez que você envia uma pergunta nova, o Claude precisa reler a conversa inteira desde a primeira linha: tudo o que você pediu, tudo o que ele respondeu, os arquivos que ele abriu no projeto e os textos que você colou no meio do caminho. A memória dessa conversa tem um tamanho fixo chamado janela de contexto, que varia conforme o modelo escolhido (200 mil ou 1 milhão de tokens). Quando a soma de tudo ultrapassa essa janela, o pedido não cabe mais e o sistema devolve o erro.

Vale separar bem as coisas: esse aviso de tamanho da conversa não significa que a sua assinatura acabou nem que a sua cota do dia zerou. A diferença entre a memória de uma conversa e a franquia da sua conta está detalhada no guia sobre limites e tokens do Claude.

Por que acontece

Por padrão, o Claude Code já vem configurado para resumir a conversa sozinho quando ela se aproxima do teto. Por isso, quando o bloqueio “Prompt is too long” aparece na sua tela, ele costuma ter uma destas quatro causas:

• A conversa ficou longa demais e o resumo automático não deu conta. Acontece quando você passa horas trabalhando no mesmo chat, abrindo dezenas de arquivos grandes sem limpar o histórico.
• Você colou um texto gigante de uma vez só no chat. É muito comum ao colar a transcrição inteira de uma reunião de uma hora, um PDF extenso copiado ou um documento enorme do cliente. Se isso ocorre logo na primeira mensagem da conversa, não existe histórico anterior para enxugar e o erro aparece com o aviso single exchange.
• O resumo automático falhou por outro problema técnico. Nesse cenário, a mensagem exibe automatic compaction failed seguido do motivo real da falha, como uma queda temporária de conexão ou um login expirado.
• O resumo automático foi desligado nas configurações. Quando isso acontece, a própria mensagem avisa no final: auto-compact is off · /config to turn it on.

Se a conversa ficou comprida

1. 1Digite /compact no chat e aperte Enter. O Claude Code vai resumir tudo o que foi feito até ali, liberar a maior parte da janela de contexto e permitir que você continue a tarefa na mesma conversa. Você também pode orientar o que não pode ficar de fora do resumo escrevendo uma instrução logo após o comando, como /compact mantenha as decisões de cores e fontes da página de vendas.
2. 2Se o /compact responder “Not enough messages to compact”, ou se o erro voltar a aparecer na mensagem seguinte, digite /clear para encerrar o histórico atual e abrir uma conversa limpa.
3. 3Na conversa nova, peça para o Claude ler os arquivos da pasta e retomar exatamente do ponto em que vocês estavam.

Se foi um texto grande colado no chat

1. 1Rode o comando /clear para limpar a conversa travada. Quando o problema foi causado por um bloco imenso de texto colado na caixa de mensagem, o /compact não consegue resolver sozinho.
2. 2Dentro do VS Code, crie um arquivo novo na pasta do seu projeto, cole todo aquele texto lá dentro e salve com a extensão .md (por exemplo, reuniao-cliente.md).
3. 3No chat limpo, em vez de colar o texto inteiro na conversa, peça apenas para o Claude ler o arquivo salvo na pasta, escrevendo algo como “leia o arquivo reuniao-cliente.md e liste tudo o que o cliente pediu para o site”.

É exatamente assim que eu faço depois de cada reunião comercial: gravo a chamada com o cliente, salvo a transcrição como um arquivo .md dentro da pasta dele e mando o Claude ler dali. Desse jeito, ele processa uma reunião inteira sem entupir o chat.

Como resolver cada variação desse erro

• Quando aparece “automatic compaction failed”: resolva primeiro o erro específico que vem escrito no final da mensagem, porque o comando /compact vai continuar falhando no mesmo ponto enquanto essa causa não for corrigida. Se o aviso apontar falha de autenticação, por exemplo, basta rodar /login primeiro.
• Quando aparece “single exchange”: rode /clear para esvaziar a tela e envie o pedido novamente sem colar textos gigantes direto na caixa de mensagem, salvando o conteúdo em arquivos dentro do projeto.
• Quando aparece “auto-compact is off”: digite /config no chat e ative novamente a opção Auto-compact para que o Claude Code volte a resumir as conversas longas sozinho.

Se você usa o MazyOS

Quem trabalha com o MazyOS pode rodar o /clear sem medo nenhum de perder o histórico do projeto, porque toda a memória de longo prazo fica salva nos arquivos da pasta de cada cliente. O único cuidado é lembrar que o que você combinou na sessão de hoje só vai para a pasta quando você roda o /atualizar. Por isso, sempre que a conversa começar a pesar, a ordem ideal é rodar /compact, em seguida rodar /atualizar para registrar tudo na pasta e depois dar um /clear. Se a conversa já travou num ponto em que nem o /compact passa, pode ir direto no /clear: tudo o que você salvou no último /atualizar continua intacto na pasta, como explico no FAQ sobre como o MazyOS impede o Claude de esquecer o cliente.

E pode ficar tranquilo quanto ao arquivo CLAUDE.md da raiz do projeto: mesmo quando você usa o /compact, o Claude Code relê esse arquivo direto do disco logo após o resumo, mantendo todas as regras da sua estrutura ativas.

Como evitar

• Abra uma conversa nova para cada entrega. Terminou de montar uma página ou uma proposta? Rode /clear antes de começar o próximo assunto. Além de evitar o erro de contexto cheio, isso economiza muito do seu limite diário, já que o Claude não precisa reler assuntos encerrados a cada nova mensagem.
• Transforme textos longos em arquivos `.md`. Transcrições de reuniões, briefings extensos e textos copiados de PDFs devem sempre morar na pasta do projeto para o Claude consultar sob demanda, nunca colados direto no chat.
• Use o `/compact` antes de iniciar uma etapa pesada. Se a conversa já está longa e você ainda precisa concluir um ajuste no mesmo raciocínio, rode /compact indicando em uma frase o que ele deve preservar.
• Acompanhe o medidor de contexto no VS Code. A própria caixa de digitação da extensão mostra a porcentagem da janela de contexto que já foi ocupada naquela sessão.
• Mantenha ativos apenas os MCPs e as skills que você realmente usa. Cada servidor MCP ligado ainda põe o nome das ferramentas dele no começo de toda conversa (o detalhe de cada uma só carrega quando o Claude precisa), então os parados só ocupam lugar: desligue pelo comando /mcp. O mesmo vale para o excesso de comandos extras instalados sem necessidade, e você pode ver no guia sobre o que é uma skill do Claude quanto cada uma pesa na sua janela de contexto.
• Deixe o Auto-compact sempre ligado. Com a compactação automática ativa no /config, o próprio Claude Code enxuga o histórico antes de a conversa travar.

Se nada funcionou

• Se o aviso “Prompt is too long” aparecer logo na primeira linha de uma conversa recém-aberta com /clear, o que está lotando a janela não são as mensagens, mas o que carrega junto com o projeto (como um CLAUDE.md gigantesco ou dezenas de servidores MCP e skills). Digite /context no chat para ver um gráfico colorido mostrando exatamente o que está consumindo espaço e o que cortar.
• Confira se o seu Claude Code está na versão mais recente, pois várias falhas antigas de compactação já foram corrigidas pela Anthropic. No VS Code, atualize pela aba de extensões; no terminal, ele atualiza sozinho em segundo plano ou na hora com o comando claude update.
• Tire um print do erro e da tela do /context e envie para o Claude pelo navegador em claude.ai, pedindo para ele apontar qual item está estourando a janela.
• Se você faz parte da comunidade do MazyOS, mande o print no grupo da turma seguindo o passo a passo de como funciona o suporte.

Para dominar os comandos essenciais e evitar as travas mais comuns de quem está começando, veja o nosso guia completo sobre o que é o Claude Code.