O que o Claude não faz bem? Os limites que valem conhecer antes de adotar

Fala aí, beleza? Quem chega no Claude esperando mágica leva o primeiro susto na primeira semana 🙂

Não porque a ferramenta seja ruim, mas porque a distância entre "faz tudo sozinho" e o uso real é maior do que a internet vende

Este post reúne os limites que estão DOCUMENTADOS (do modelo e do Claude Code) e, principalmente, o que cada um deles significa na prática de quem vai adotar

Sem hype, sem prompt mágico, sem promessa de fórmula secreta

Não espere imagens: o Claude não gera fotos nem ilustrações

O sintoma é sempre igual: a pessoa pede uma imagem pra thumbnail, pra post, pra capa, e recebe outra coisa

A causa é simples, e é bom saber ANTES de assinar: o Claude não faz geração de foto nem de ilustração como as ferramentas específicas de imagem

O que ele faz é montar diagramas, gráficos e visuais interativos dentro da conversa, e aceitar upload de imagem pra análise

Ou seja, visual estruturado ele entrega, arte não

Como prevenir: alinhe a expectativa antes de adotar

Se o entregável final é uma imagem, o Claude entra no fluxo (organizando ideia, explicando conceito, montando o diagrama), e a geração fica com outra ferramenta

Alucinação: respostas convincentes que não se sustentam

Aqui mora o limite mais famoso e o mais perigoso, porque ele não parece um erro

O sintoma: uma citação que soa autoritativa e não tem base nenhuma, um link que não abre, e a versão mais bizarra, o modelo afirmando que enviou um email ou que produziu um documento externo

A causa não é teoria de internet, é a própria Anthropic documentando: alucinação é uma limitação atual dos modelos de fronteira, e isso inclui citações convincentes que não estão fundamentadas em fatos

Somado a isso, ele não tem acesso a ferramentas ou softwares que não estejam explicitamente integrados (email, processador de texto, transferência de arquivo)

Quando ele diz que "mandou", ele não mandou

Pré-inscrição Formação Claude Code

Domine o Claude Code do básico ao avançado

Você vai aprender a criar sistemas completos com Claude Code, sem precisar ser programador. Inscreva-se para ter acesso a um desconto de lançamento e bônus especiais!

Quero minha vaga

E como reduzir isso na prática:

A documentação oficial lista técnicas que funcionam:

• dar permissão explícita pro modelo dizer que não sabe
• em documentos longos (acima de 20 mil tokens), pedir que ele extraia primeiro as citações palavra por palavra e só depois faça a tarefa
• verificação best-of-N, que é rodar o mesmo prompt várias vezes e comparar as saídas
• refinamento iterativo
• instruir a usar APENAS os documentos fornecidos, e não o conhecimento geral

E aqui vem a parte que ninguém gosta de ler: a mesma documentação diz que essas técnicas reduzem significativamente, mas NÃO eliminam a alucinação

Então a prevenção real é cultural, não técnica: dado que vai virar decisão, você confere na fonte

Data de corte: quando a resposta está certa, mas velha

Sintoma clássico: a resposta vem redondinha, bem escrita, confiante, e desatualizada

A causa é a data de corte do conhecimento

E tem uma nuance que a documentação faz questão de separar: existe o corte de conhecimento confiável (a data até a qual o conhecimento é mais extenso e confiável) e o corte dos dados de treino (a faixa mais ampla do que entrou no treinamento)

Não é a mesma coisa, e é por isso que às vezes ele "sabe" algo recente pela metade

A saída documentada é a busca na web, que existe justamente pra cobrir esse buraco, trazendo informação atual com as fontes citadas

Detalhe útil: você pode desligar a busca nas conversas que não precisam de informação atual, o que economiza uso

Como prevenir: qualquer dado sensível a tempo (preço, versão, quem lançou o quê) entra na categoria "conferir na fonte", com busca ligada ou com o link na mão

O ponto cego do Claude Code: sem verificação executável, você vira o loop

Esse é o limite que mais dói em quem faz vibe coding e só percebe depois

O sintoma: o código "parece pronto", a explicação está linda, e a quebra aparece três dias depois

A causa está escrita nas boas práticas oficiais: ele funciona melhor quando recebe uma verificação que consiga rodar sozinho

Suite de testes, código de saída de build, linter, um script que compara a saída com uma fixture, screenshot do navegador comparado ao design

Sem nada disso, "parece pronto" é o único sinal disponível, e aí VOCÊ vira o loop de verificação, com cada erro esperando ser notado por você

É como contratar alguém muito rápido e não ter nenhum jeito de checar o serviço além de olhar por cima

O que fazer no lugar:

Dê a ele algo que ele mesmo possa rodar, e exija evidência em vez de afirmação de sucesso

A orientação oficial é essa: mostrar a saída do teste, o comando que rodou e o que ele retornou, ou o screenshot do resultado

"Funcionou" não é evidência, é opinião 😀

E tem uma regra que vale colar na parede: teste serve pra verificar a correção, não pra definir a solução

Se a tarefa for inviável ou se algum teste estiver incorreto, o certo é ele AVISAR, não contornar o teste

Segurança: a revisão do que ele propõe continua sendo sua

Sintoma: aprovar comando e código no automático, no next, next e finish, sem ler

A causa é explícita na documentação de segurança do Claude Code: a responsabilidade de revisar o código e os comandos propostos quanto à segurança, antes de aprovar, é do usuário

Não é pegadinha, está lá escrito

Existem salvaguardas, e elas são boas:

• sistema de permissões, com aprovação explícita pra operações sensíveis
• análise sensível ao contexto, que detecta instruções potencialmente danosas
• sanitização de entrada contra injeção de comando
• aprovação de comandos de rede que buscam conteúdo na web, tipo curl e wget
• conteúdo de resultado de ferramenta tratado como dado NÃO confiável, e instruções colocadas ali podem ser ignoradas ou sinalizadas como possível injeção

Tem ainda o /security-review sob demanda, com prompt especializado que checa padrões comuns de vulnerabilidade: injeção de SQL, XSS, falhas de autenticação e autorização, tratamento inseguro de dados e vulnerabilidades em dependências

Como prevenir: revisão humana obrigatória em ação difícil de reverter, destrutiva ou que afeta sistema compartilhado

Os rm -rf da vida não são hora de confiar no piloto automático

Base grande, contexto cheio e travadas de performance

Sintoma: lentidão, consumo alto de recurso, busca que não acha arquivo que existe, e aquela falha esquisita de contexto que enche de novo e de novo

A causa tem várias frentes

A documentação registra que o Claude Code pode consumir recursos significativos ao processar bases de código grandes

E existe a falha documentada de autocompact thrashing ("Autocompact is thrashing: the context refilled to the limit"): a compactação automática funcionou, mas o contexto encheu de novo várias vezes seguidas, e aí ele PARA de tentar pra não desperdiçar chamada de API

As saídas documentadas:

Pra diagnosticar, tem o /doctor, que faz checagem automática de instalação, configurações, extensões e uso de contexto

Pra isolar problema de performance, a orientação é reiniciar em modo seguro, pra ver se um plugin, servidor MCP ou hook é a causa:

claude --safe-mode

Se o uso de memória continuar alto, o /heapdump grava um detalhamento de memória

Pro contexto que reenche, as recomendações são: pedir pra ler arquivos grandes em pedaços menores, rodar /compact com um foco que descarte saída grande, mover o trabalho de arquivo grande pra um subagente com janela de contexto separada, ou rodar /clear se a conversa anterior não for mais necessária

E tem o caso do arquivo que "sumiu": se a busca, as menções @arquivo, agentes ou skills customizadas do Claude Code não encontram arquivos, o binário do ripgrep embutido pode não estar rodando no seu sistema, e a orientação é instalar o pacote ripgrep da plataforma

No WSL, o desempenho de leitura de disco pode resultar em MENOS correspondências do que o esperado, então não é você ficando maluco

Um limite pequeno que assusta à toa: tabela markdown com mais de 200 linhas renderiza só as 200 primeiras, seguidas de uma linha indicando quantas não foram mostradas

Nada se perde: a tabela completa continua na conversa, e o comando /copy copia todas as linhas, inclusive as que ficaram fora da tela

Sobre janela de contexto, vale saber que Opus 5 e Sonnet 5 têm 1 milhão de tokens de contexto e até 128 mil tokens de saída, e que a compactação de contexto (que resume automaticamente as partes anteriores da conversa no servidor pra ela continuar além do limite) está em beta

A recomendação oficial, aliás, é não depender só da compactação: começar uma janela de contexto NOVA costuma ser melhor, porque os modelos atuais são muito eficazes em descobrir o estado a partir do sistema de arquivos local, com git rastreando o estado, log do que foi feito e checkpoints restauráveis

Limites de uso e cobrança: onde a conta surpreende

Sintoma: bater no limite antes do esperado, ou tomar uma cobrança separada que você não esperava

As causas, todas documentadas:

• o limite de sessão dos planos Pro e Max reseta a cada cinco horas
• o limite semanal reseta em um horário fixo da semana atribuído à conta, e esse dia e horário não mudam conforme o uso nem conforme a data da assinatura
• nos planos Pro e Max, os limites são COMPARTILHADOS entre o Claude e o Claude Code, e o uso pela IDE conta pro mesmo limite
• conversa longa que aciona o gerenciamento automático de contexto consome mais do limite de uso

Se você quer entender o que cada plano entrega antes de assinar, dá pra ir mais fundo nos limites de uso por plano

E tem a parte da cobrança, que confunde muita gente: usar créditos de API pelo Claude Code é cobrado às taxas padrão de API, distintas do preço dos planos Pro e Max

A assinatura paga (Pro, Max, Team, Enterprise) não inclui o uso da API pelo Console, que é cobrado separadamente

Pra referência de ordem de grandeza, o Claude Opus 5, lançado em 24 de julho de 2026, custa US$5 por milhão de tokens de entrada e US$25 por milhão de tokens de saída

Saber qual modelo é o padrão do seu plano também ajuda: o Sonnet 5 é o padrão do Free e do Pro, e o Opus 5 é o padrão do Max, sendo o modelo mais forte disponível no Pro e disponível pra Max, Team e Enterprise

O Claude Code está incluso nos planos Pro e Max, e funciona em IDEs suportadas (VS Code e forks como o Cursor, além das IDEs JetBrains)

Solução prática: separe conversas em vez de arrastar uma eterna, desligue a busca quando o assunto não depende de informação atual, e saiba em qual modelo você está gastando

O que apareceu na prática montando um projeto do zero

No vídeo em que eu monto um projeto do zero com o Claude Code, alguns desses limites apareceram sem eu precisar procurar

O primeiro foi no Windows: a instalação terminou sem criar a variável de ambiente que aponta pro binário, e o comando simplesmente não rodava

Só voltou a funcionar depois que eu configurei isso manualmente no usuário do Windows, fechei o terminal e testei de novo

Já vi esse tipo de problema de permissão insuficiente na instalação acontecer em outros casos, e no Mac isso não apareceu, a execução ficou disponível de forma nativa

Detalhe honesto: logo na primeira execução, a própria ferramenta avisa que pode errar, antes mesmo de liberar o trabalho na pasta

Outro ponto que só se sente usando: no modo padrão ele pergunta antes de cada ação, e cada permissão pedida deixa o desenvolvimento PAUSADO enquanto você aprova arquivo por arquivo

Num projeto simples eu precisei autorizar edição várias vezes, e existe outra maneira de trabalhar sem esse ritmo de perguntas

Usar só o terminal também afasta parte das pessoas, e foi por isso que eu acabei indo pro VS Code, pra ter uma interface mais parecida com um chat

No fim, o projeto de teste (uma calculadora de IMC com HTML, CSS e JavaScript) rodou no navegador sem problema

Ou seja: pro primeiro projeto ele entrega bem, mas o caminho tem tropeço de ambiente e tem revisão humana no meio, não é o "senta e vira as costas" que o hype promete

Tarefas que é melhor não delegar ao Claude

Recorte prático, pra você não descobrir do jeito ruim:

• Geração de imagem: foto e ilustração não são o jogo dele, e insistir só gasta seu limite
• Qualquer coisa que dependa de dado atual com a busca desligada: aí você está pedindo pra tomar resposta velha com cara de nova
• Ação irreversível ou destrutiva: a revisão humana continua importante justamente aqui
• Mudança em sistema compartilhado: o estrago não é só seu, é do time
• Aprovação no automático de comando de rede: a aprovação de curl e wget existe por um motivo, leia antes de dar OK
• Casos de alto risco: a Política de Uso define Requisitos para Casos de Uso de Alto Risco, incluindo usos jurídicos, financeiros e relacionados a emprego, além de decisões de saúde

Nesse último grupo, as salvaguardas adicionais exigidas incluem supervisão humana no circuito (human-in-the-loop) e divulgação de que se trata de IA, quando as saídas são voltadas ao consumidor

Não é sugestão de blog, é regra de uso

Tabela: limite, o que a documentação oferece e o que continua com você

Vale adotar mesmo com esses limites?

Vale, e o motivo é meio contraintuitivo: as limitações do Claude são conhecidas, escritas e nomeadas

Tem página de troubleshooting com o nome da falha, tem documento de boas práticas dizendo que sem verificação executável você vira o loop, tem política de uso separando os casos de alto risco

O system card do Claude Opus 5, publicado em 24 de julho de 2026, é o documento de avaliação de segurança mais detalhado já divulgado junto de um lançamento de modelo

Isso é sinal de transparência, não de perfeição

Pra quem serve bem: quem tem projeto com teste, build ou lint rodando, quem revisa o que aprova, e quem trata o modelo como um dev muito rápido que precisa de checagem

Pra quem vai frustrar: quem quer imagem pronta, quem quer resposta atual sem ligar busca, e quem quer aprovar tudo no automático e depois reclamar do resultado

Se você chega esperando mágica, a queda é grande

Se você chega esperando velocidade com revisão, é muito massa

Conclusão

Os limites não são defeito escondido, são o contrato de uso: nada de foto e ilustração, alucinação que reduz mas não zera, conhecimento com data de corte, verificação que precisa existir do seu lado, segurança que passa pela sua aprovação, contexto que enche e limite de uso que é compartilhado

Próximo passo concreto, na ordem: comece por uma tarefa que TENHA verificação executável, ative as práticas anti-alucinação (permitir "não sei", citação literal, restringir às fontes), e rode /doctor e /security-review antes de escalar o uso pro projeto sério

Expectativa calibrada é o que separa quem adota e fica de quem testa e desiste na primeira semana 🙂

Até o próximo post!