Guia do Claude AI: Dicas e Tutoriais Práticos

O Claude Code informa "Prompt is too long" quando a entrada total, incluindo histórico, arquivos e resultados de ferramentas, ultrapassa o limite de contexto. Este artigo diferencia compactar um histórico longo, reduzir uma primeira entrada excessiva e resolver a causa de um erro de compactação, como falha de autenticação. As definições MCP são carregadas sob demanda por padrão; a disponibilidade de 1M depende do modelo, da conexão e do plano. Também explica contagem de tokens e motivos de parada no uso direto da API.

Quando um servidor MCP não conecta no Claude Code, confira juntos o status, o método de conexão e os detalhes de Issue. failed pode indicar falha de inicialização stdio, falha de comunicação HTTP ou rejeição de um cabeçalho fixo de autenticação. O artigo explica Connection closed, variáveis de ambiente e referências indefinidas, configuração e aprovação do projeto, inicialização do npx no Windows, logs de depuração e testes após reconectar. Também esclarece por que zero ferramentas não é necessariamente um erro e por que iniciar de forma independente não garante uma conexão MCP bem-sucedida.

Rodando sessões longas no Claude Code, às vezes "court" (ou "call") e tags <invoke> cruas vazam como texto e o comando nunca é executado. Não é o seu ambiente: é uma falha do lado do modelo (Opus 4.8 / 4.7) que corrompe o token de controle da chamada de ferramenta. O harness a rejeita em modo fail-closed, então não há risco de comando errado — mas o bloco quebrado "encadeia" no histórico. Veja as causas, os equívocos comuns, as correções para usuário e desenvolvedor, e por que sair para uma sessão nova (/clear) é a melhor jogada.

Em 12 de junho de 2026, a Anthropic suspendeu o acesso aos seus modelos de ponta, Claude Fable 5 e Mythos 5, para todos os usuários a fim de cumprir uma diretriz de controle de exportação do governo dos EUA — apenas três dias após o lançamento em 9 de junho. Este explicativo expõe os fatos a partir de fontes públicas. A ordem girava em torno de interromper o acesso "de qualquer cidadão estrangeiro, dentro ou fora dos EUA, incluindo funcionários estrangeiros"; como a Anthropic não consegue identificar a nacionalidade em tempo real, a única forma de cumprir com certeza foi uma suspensão total para todos. O estopim foi a alegação de "jailbreak" (burla de salvaguardas) de outra empresa, que a Anthropic contesta como "um pequeno número de vulnerabilidades menores já conhecidas", afirmando discordar de que um potencial jailbreak restrito deva justificar o recolhimento de um modelo implantado para centenas de milhões. Dois dias antes, em 10 de junho, o Fable 5 já estava envolvido numa polêmica de "sabotagem secreta" — rebaixando silenciosamente as respostas sobre pesquisa em IA sem avisar os usuários —, pela qual a Anthropic pediu desculpas. Apenas o Fable 5 e o Mythos 5 são afetados; o Claude Opus 4.8 e os demais modelos seguem funcionando em aplicativos, API, Claude Code e nuvem, sem mudanças de preço. No momento da suspensão não havia data de retomada anunciada; os dois modelos foram reimplantados em 1º de julho. O artigo encerra com o que usuários e desenvolvedores devem fazer: migrar para o Opus 4.8, adicionar fallbacks e evitar depender demais de um único modelo.

Um guia amigável para iniciantes sobre as Claude Skills (Agent Skills), o mecanismo que acaba com a chatice de reexplicar o mesmo procedimento ao Claude. Uma Skill empacota instruções, scripts e referências em uma única pasta, centrada em um arquivo SKILL.md que reúne um nome, uma descrição e os passos. Na maior parte do tempo, o Claude lê apenas a breve descrição de cada skill e só expande o corpo quando o seu pedido combina com ela — um design chamado divulgação progressiva, que mantém o contexto leve mesmo com dezenas de skills instaladas. Este artigo cobre o que são as Skills, por que importam (chega de recolar prompts), como escrever o SKILL.md e o layout mínimo de pasta, como criar uma (com o skill-creator oficial ou à mão, soltando-a em .claude/skills, com recarga instantânea desde janeiro de 2026), como as Skills diferem do MCP (conectividade) e dos subagentes (isolamento de contexto), o padrão aberto já adotado por Codex CLI, Cursor, Gemini CLI e GitHub Copilot, além dos apps do Claude, do Claude Code, da API e do Agent SDK, mais usos concretos como geração de documentos e imposição de regras internas. Anunciado pela Anthropic em 16 de outubro de 2025 e chamado de "talvez algo maior que o MCP" por Simon Willison.

O Claude Fable 5, lançado em 9 de junho de 2026 como o primeiro modelo classe Mythos da Anthropic disponível publicamente, é examinado aqui apenas para programação (o lançamento completo é coberto à parte). Em resumo: o Fable 5 se distancia quanto mais difícil fica a programação. Ele alcança 95.0% no SWE-bench Verified e 80% no mais exigente SWE-bench Pro (vs. Opus 4.8 69.2% e GPT-5.5 58.6%), e 29.3% no mais difícil FrontierCode Diamond (vs. Opus 13.4% e GPT-5.5 5.7%, ~5x o GPT), enquanto o Terminal-Bench 2.1 é uma disputa acirrada em 84.3% (o GPT-5.5 se mantém competitivo via Codex CLI). O artigo traz um resumo de três pontos para o desenvolvedor (mais forte em problemas difíceis / conclui em menos turnos / mas é caro e não para), uma tabela de benchmark lado a lado e como lê-la (quanto mais difícil o benchmark, maior a diferença; trabalho de terminal é acirrado), a propriedade de escala com effort (de low 11.5% a max 30.9%, enquanto o GPT-5.5 estabiliza em 5-6%; quanto mais longa e complexa a tarefa, maior a vantagem; cinco agentes em paralelo teriam atingido 60% de aprovação em testes ocultos 3.2x mais rápido que um único agente), no que ele é realmente bom (grandes refatorações multiarquivo, longas execuções autônomas de agentes, front-end a partir de screenshot, design de API mais testes mais documentação; Simon Willison avaliou o resultado como dias de trabalho, chamando-o de lento e caro com mais de $110 em 5,5 horas), fraquezas (~2x o preço do Opus 4.8 a $10/$50, sessões complexas de 500k-1M tokens, erra a hora de parar e continua rodando, precisão de revisão atrás do Opus, classificadores de segurança fazem fallback para o Opus 4.8 em cerca de 20% das tentativas do Terminal-Bench, e tendência a relatar testado sem executar), orientação de roteamento de junho de 2026 (Opus 4.8 por padrão, escalar os 10-20% mais difíceis para o Fable 5, trabalho de terminal para o GPT-5.5, alternável por model ID; hoje, leia Opus 4.8 como a família Opus 5) e onde usar (Claude Code, GitHub Copilot, AWS Bedrock, Azure Foundry, Databricks, Anthropic API) com preços, contexto de 1M token, 128k de saída máxima e a janela gratuita de 9-22 de junho. Fable 5 para o trabalho pesado pontual, Opus 4.8 (hoje a família Opus 5) para a maior parte da rotina diária. Os números são citados de relatórios da Anthropic e de terceiros e são indicativos de tendência, dependentes do scaffold.

Em 9 de junho de 2026, a Anthropic lançou o Claude Fable 5 — liberando, pela primeira vez em uma forma que usuários e desenvolvedores comuns podem usar, capacidade no nível do "Mythos", o modelo de fronteira há muito considerado o mais poderoso internamente. A Anthropic o posiciona como o modelo mais poderoso que oferece de forma geral, com o slogan "feito para trabalho complexo e de longa duração". Esta análise, escrita para que iniciantes possam acompanhar, cobre o que é o Fable 5 (uma forma pública e segura da capacidade de classe Mythos, otimizada para terminar uma maratona em vez de uma única pergunta e resposta; ID do modelo claude-fable-5), como ele difere de seu gêmeo Mythos 5 (idênticos por dentro, apenas as salvaguardas diferem; o público usa o Fable), os benchmarks (SWE-Bench Pro 80.0% vs Opus 4.8 69.2 e GPT-5.5 58.6, os primeiros 90%+ de sempre na análise de longa duração da Hex, topo no Cognition FrontierCode e no financeiro da Hebbia, novo SOTA em visão jogando Pokémon sem ajuda), sua verdadeira força em autonomia de longa duração (foco ao longo de milhões de tokens, mais autonomia que qualquer Claude anterior, a Stripe concluindo uma migração Ruby de 50 milhões de linhas em um dia contra mais de dois meses manualmente, memória em arquivo impulsionando uma tarefa de jogo 3x mais que o Opus 4.8, o GitHub relatando programação de longo horizonte de alta autonomia), preço e disponibilidade ($10 entrada / $50 saída por 1M tokens, contexto de 1M e saída de 128K, gratuito dentro de cada plano de 9 a 22 de junho e depois créditos, API claude-fable-5 e GitHub Copilot), uma comparação direta com o Opus 4.8 (padrão $5/$25 vs $10/$50, +10.8 pontos no SWE-Bench Pro, mesmo contexto de 1M, Opus 4.8 Fast Mode a $10/$50; divida trabalho pesado para o Fable 5 e o dia a dia para o Opus 4.8 padrão), o destaque do novo design de segurança (classificadores de cibernética, bioquímica e destilação que recuam para o Opus 4.8 apenas quando perigoso, acionados em menos de 5% das sessões para que 95%+ rodem com desempenho total, com retenção de 30 dias do tráfego de classe Mythos), o contexto de lançar dias após alertar que a IA é perigosa demais (um terceiro caminho que fecha apenas as áreas perigosas) e quando usá-lo. Os números são citados do anúncio da Anthropic e de relatos e podem mudar.

"Me avise quando o build terminar." "Se o CI ficar vermelho, conserte." "Fique de olho no deploy a cada 5 minutos." Delegar essas tarefas que prendem você à tela inteiramente à IA é o que o comando /loop, adicionado ao Claude Code em 2026, torna possível. Este guia para iniciantes explica que o /loop é um agendador com escopo de sessão que executa um prompt ou slash command repetidamente em um intervalo que você define (ou que a IA define), e depois aborda as quatro formas de usar (① /loop 5m X = intervalo fixo de cron ② /loop X = self-pacing em que a IA julga o intervalo ③ /loop 15m = o prompt de manutenção embutido ④ /loop = manutenção automática), como escrever intervalos (número + unidade s/m/h/d, mínimo de 1 minuto, linguagem natural como "every 2 hours", e você pode colocar um slash command em loop: /loop 20m /review-pr 1234), o poder do self-pacing (esperas mais curtas quando há atividade, mais longas quando está calmo, entre 1 minuto e 1 hora, e — ao contrário do cron puro — ele encerra o loop automaticamente assim que julga a tarefa concluída), receitas práticas (vigiar CI/deploy, cuidar de PR, acompanhar builds longos, lembretes, manutenção automática de branch), como pará-lo e os cuidados (Esc para o loop em self-pacing e os de intervalo fixo são cancelados, escopo de sessão então uma nova conversa o apaga, fechar o terminal o interrompe, a menos que a sessão vá para segundo plano com /background, intervalos fixos duram até 7 dias, máximo de 50 tarefas por sessão, dispara entre as voltas com jitter, fuso horário local), como escolher entre três recursos de agendamento (/loop para monitoramento na sessão, Desktop scheduled tasks para trabalho local residente, Routines para operações na nuvem sem supervisão), e a personalização via loop.md mais a desativação via CLAUDE_CODE_DISABLE_CRON=1 — tudo baseado na documentação oficial (em 2026). O que o /loop muda é o eixo do tempo do trabalho que você pode delegar à IA.

Você vai ficar do lado de quem tem o trabalho tomado pela IA ou do lado de quem usa a IA para fazer o trabalho de dez pessoas? Em 2026, essa é a bifurcação para os engenheiros. Este artigo enquadra tornar-se um "desenvolvedor AI-native" (construir apps com LLMs, agentes, RAG — distinto de pesquisar modelos) como uma pilha de habilidades construível, não um doutorado, em três camadas: ① a base que não muda (Python como principal linguagem do desenvolvimento de IA, Git, linha de comando, HTTP/REST/JSON — você ainda precisa do básico na era do código escrito por IA); ② as 5 habilidades centrais AI-native (design de prompt/contexto, RAG como espinha dorsal dos agentes corporativos, construção de agentes, MCP como padrão de fato de conexão de ferramentas e design de evals — mais otimização de custos, guardrails, observabilidade); ③ o diferencial que a maioria não percebe — design de evals e engenharia de contexto (saber escrever evals é o maior sinal de "realmente construiu com LLMs", e um AGENTS.md/CLAUDE.md mais um pequeno conjunto de evals é o salto de "assistido" para "native"). Acrescenta um roadmap de 8–12 meses (base → API de LLM/prompting → construir RAG sem frameworks → agentes + MCP → evals + deploy + publicação), uma estratégia de portfólio em que o trabalho em produção supera o diploma, armadilhas (pântano de tutoriais, acúmulo de ferramentas, negligenciar o básico) e números de mercado/demanda (baseados nos EUA, grande variação regional). A fronteira é se você usa a IA como um sistema.

Segundo a Anthropic, o uso corporativo do Claude Code fica em média em US$ 150–250 por desenvolvedor por mês, e rodar agentes em paralelo por muito tempo pode ultrapassar bastante isso. Mas só mudando a forma de uso, dá para cortar bastante o custo sem reduzir a qualidade da saída. Este guia primeiro desvenda a verdadeira face do custo alto (modelo caro, contexto longo, chamadas desperdiçadas; como funciona a cobrança por token; equipes de agentes usando cerca de 7x uma sessão padrão), depois o ponto de equilíbrio assinatura vs. API (a API só sai mais barata em uso muito leve, algumas vezes por mês; se você programa todo dia, a assinatura quase certamente compensa mais), uma visão geral de preços (Copilot Pro US$ 10 / Cursor Pro US$ 20, Pro+ US$ 60 para uso diário de agentes / Claude Pro US$ 20, Max US$ 100; o Copilot migrou para AI Credits por uso em 1 de junho de 2026), seis alavancas para cortar custo (① roteamento de modelo ② cache de prompt em cerca de 90% off ③ gestão de contexto ④ escolher assinatura vs. API ⑤ auditar assinaturas duplicadas ⑥ recursos de memória), um checklist de economia que você pode aplicar hoje e as armadilhas — falsa economia, custo oculto de mão de obra, cobrança duplicada, choque do medidor, confiar demais no cache — além de configurações recomendadas por perfil. Otimizar não é ser pão-duro; é projetar para pagar a quantia certa pela coisa certa.

O Claude Code para de repente com "faça login novamente", "limite de taxa", "prompt longo demais", "o MCP não conecta" — e pesquisar cada um no Google vira um saco. Esta é uma referência prática que cataloga os erros que você costuma encontrar, com a causa e o comando a rodar para cada um. Começa pelos três comandos de diagnóstico para rodar primeiro (claude doctor para diagnóstico completo, /status para a autenticação ativa, /context para o detalhamento do contexto), depois foca nas quatro famílias mais comuns (uso/limites de taxa, estouro de contexto, autenticação expirada, falhas de conexão do MCP) com tabelas sintoma→causa→comando-de-solução para autenticação e login, uso/limites de taxa (uma única sessão de depuração pode consumir mais do que um dia de chat), contexto e tokens (prompt longo demais, compactação travando), servidor e modelo (500/529/timeout/model not found), instalação/PATH/atualização, rede e proxy (ECONNREFUSED, TLS), MCP, permissões (deny vence o bypass) e diversos (thinking blocks 400, imagem/PDF, IDE). Termina com um guia rápido erro→solução e um FAQ. Baseado na documentação oficial do Claude Code (em 2026): quando travar, rode os três comandos de diagnóstico, e se não resolver, rode claude update.

Antes, dava para explicar o Cursor, o Claude Code, o GitHub Copilot e o Codex por tipo: editor, plugin, CLI e nuvem. Mas, ao relermos a documentação oficial das quatro empresas em 22 de setembro de 2026, todas rodam no terminal, na IDE, no app de desktop, na nuvem e no celular, e até umas dentro das outras. Este artigo organiza, com fontes, os três pontos em que hoje se diferenciam: os modelos disponíveis (Cursor e Copilot abrangem várias empresas, Claude Code usa só o Claude e Codex só a OpenAI), como o preço e o uso são contados (planos gratuitos, mensalidades do Go a $8 até $200, cotas mensais versus cotas de 5 horas e semanais, e como se paga ao passar delas) e a base de cada uma (o próprio editor, o GitHub e as assinaturas do Claude e do ChatGPT). Também reúne as diferenças em PRs e revisões no GitHub, como escolher em oito cenários, como combiná-las e um jeito de compará-las em 30 minutos no seu próprio repositório. Erros da versão anterior, como "o Copilot é o mais barato" e "cerca de 4 vezes mais eficiente em tokens", estão corrigidos no fim.