Guia do Claude AI: Dicas e Tutoriais Práticos

O mesmo plano Pro tem limites de geração de imagens diferentes no Chat do ChatGPT e no Codex / Work. Os modelos Claude não criam fotos nem ilustrações diretamente, mas o Claude Code pode gerar imagens com HTML, SVG, código ou APIs externas. O guia mostra como escolher a entrada, definir o tamanho de exibição antes da composição, separar referências de partes novas e revisar as imagens em tamanho original.

Se o Claude Code mostrar "API Error: Opus 5.5's safeguards flagged this message" ou "safeguards flagged this session", um classificador de segurança acoplado ao modelo reagiu ao conteúdo da conversa e impediu que aquele modelo respondesse. Os títulos das Issues também chamam isso de "Message flagged by safeguards". Os classificadores rodam no lado do servidor e olham não só a sua última frase, mas a conversa inteira, os arquivos lidos e até o CLAUDE.md; por isso, uma mensagem comum como "hi" pode ser barrada, e a Anthropic reconhece os falsos positivos. Com base na referência de erros oficial, na documentação de configuração de modelos, na página Refusals and fallback da API e na Central de Ajuda, explicamos o que significam as categorias cyber, bio, reasoning_extraction, general_harms e frontier_llm do campo Details, quando o Claude Code troca automaticamente para outro modelo e quando simplesmente para, como usar Esc duas vezes para voltar, /clear, /model, --safe-mode e /feedback, a ampliação do CVP de 6 de outubro de 2026 para três níveis que cobrem também o Opus 5.5 e o Sonnet 5.5, e como as solicitações barradas são cobradas. Os relatos no GitHub desde 22 de setembro ficam separados das explicações oficiais e são tratados como casos não confirmados.

Perguntar a uma IA "Que tipo de pessoa eu sou?" só traz de volta uma versão inflada e convincente do que você mesmo digitou. O que funciona é o caminho inverso: deixar a IA fazer as perguntas para tirar de você fatos reais, pedir ajuda para organizar os pontos em comum e colocá-los em palavras, e tomar a decisão final você mesmo. Este artigo traz 8 prompts para usar em sequência: entrevista, pontos fortes, valores, pontos fracos, condições do trabalho que combina com você, rascunho da apresentação pessoal, simulação de entrevista e uma revisão do ponto de vista contrário. Também explica por que não aceitar as respostas sem questionar, incluindo a tendência de achar "certeiras" palavras que servem para qualquer pessoa (o experimento de Forer, de 1949) e a tendência da IA de concordar com você; que informações podem entrar e quais evitar; e como usar a memória e os projetos no ChatGPT, no Claude e no Gemini, tudo verificado nas páginas de ajuda oficiais de cada empresa.

Em 28 de setembro de 2026, a Anthropic lançou o Claude Sonnet 5.5, e o Sonnet 5 passou para Legacy. Este artigo confronta no texto original a documentação oficial (lista de modelos, página do Sonnet 5.5, What's new, guia de migração, preços, thinking, effort e cache de prompt), o anúncio, a documentação e o CHANGELOG do Claude Code e o changelog do GitHub. Reúne as especificações principais (claude-sonnet-5-5, contexto de 1 milhão, saída máxima de 128 mil, data de corte do conhecimento em junho de 2026 e descontinuação não antes de 28 de setembro de 2027), o preço ($2 de entrada e $10 de saída, o mesmo do Sonnet 5, com a leitura de cache reduzida de $0,20 no lançamento para $0,10 em 7 de outubro de 2026, enquanto o tamanho mínimo para cache caiu de 1.024 para 512 tokens) e os valores da tabela comparativa da Anthropic (70,6% no Terminal-Bench 4.0 e 1844 no GDPval-AA v2.1, a 2 pontos do Opus 5.5, embora o próprio anúncio diga que o Opus 5.5 é claramente mais forte em trabalhos complexos e sem resposta definida). Depois, explica as cinco mudanças que fazem um código que funcionava no Sonnet 5 dar erro 400 (desligar o raciocínio passa a ser between_tools, com effort high ou abaixo; uso forçado de ferramenta; blocos de raciocínio vinculados ao modelo e à conversa; a ferramenta antiga de computer use na API do Claude e no Google Cloud; e combinações da ferramenta advisor) e como corrigi-las, as mudanças que acontecem sem erro, como o texto entre chamadas de ferramentas passar para blocos thinking, a diferença no effort padrão (high na API, medium no Claude Code), como escolher entre ele, o Opus 5.5 e o Haiku, o uso no Claude Code (/model sonnet a partir da v2.1.284) e no GitHub Copilot, e os passos da migração.

Mandei o Projects do Claude Code (beta público) construir um site inteiro para consultar quanta memória os LLMs locais exigem. Da criação ao último merge foram cerca de 20 horas: 10 threads, 11 PRs, cerca de 23 mil linhas e cerca de 190 milhões de tokens (97,7% deles leituras de cache). Durante a noite, três tarefas avançaram em paralelo, as threads se coordenaram entre si por meio do coordenador e, quando troquei as instruções para deixar tudo por conta dele, ele passou a decidir sozinho as próximas tarefas. Por outro lado, ninguém criou a lógica que decide "isto pode ser publicado?" na fronteira entre as threads da coleta de dados e das páginas, e a produção mostrava zero modelos. Os dados reais também revelaram bugs que os testes com dados de exemplo nunca mostraram, e a publicação num servidor acessível só por SSH travou. Registro tudo com medições: os tropeços para começar, a diferença entre aprovar cada passo e deixar por conta dele, como o crédito de configuração foi consumido e para que tipo de trabalho ele serve ou não.

Abrir as sessões uma por uma para trocar o modelo e o esforço toda vez que sai um modelo novo dá trabalho. Quando testei no meu próprio ambiente em 24 de setembro de 2026, pedir ao assistente para "mudar todas para isto" funcionou tanto no Claude Code Desktop quanto no Codex, sem que eu precisasse mexer em cada sessão. No Claude Code Desktop, as ferramentas que o app entrega ao assistente mudaram as sessões sem enviar mensagem, e as mudanças sobreviveram ao reinício do app. Porém, ele só enxerga sessões locais do desktop, o padrão são as 20 mais recentes e não consegue mudar a sessão que faz o pedido. No Codex, o padrão para chats novos foi mudado no config.toml, e o assistente usou um mecanismo interno para mudar um por um os 115 chats existentes no meu ambiente. Os chats que estavam abertos no app receberam uma mensagem de confirmação cada. Este artigo mostra em que os dois diferem, o que alcançam e o que não alcançam, exemplos de pedido e 4 cuidados: guardar os valores antigos, definir o escopo, reler tudo e conferir uma sessão com os próprios olhos.

As sessões na nuvem do Claude Code saíram do research preview e ficaram disponíveis oficialmente em 23 de setembro de 2026. O seu repositório do GitHub é clonado numa máquina virtual na nuvem da Anthropic, onde o Claude corrige o código e faz push de uma branch, então o trabalho não para quando você fecha o notebook. O uso sai dos mesmos limites do seu plano normal, sem cobrança à parte pela VM. Além disso, quem já assina o Pro recebe um crédito único de US$ 100 e quem assina o Max, US$ 250: resgatando até 7 de outubro, ele é consumido primeiro até 5 de novembro, 07h59 UTC (Projects e Routines ficam de fora). Com base na documentação oficial e nos posts da conta oficial, este artigo mostra em que as sessões na nuvem diferem do Claude Code local e do Remote Control (quais configurações vêm junto e quais não, os modos de permissão, os quatro níveis de acesso à rede e onde guardar segredos), como começar pelo navegador e pelo terminal, como resgatar o crédito e os cuidados que constam nos termos completos da oferta, e para quais trabalhos elas servem e para quais não.

A Anthropic lançou o Claude Opus 5.5 em 22 de setembro de 2026. A visão geral oficial de modelos agora recomenda começar pelo Opus 5.5 na dúvida, e o Opus 5 passou para a categoria Legacy. Este artigo confronta o texto original da documentação oficial (visão geral de modelos, What's new, guia de migração e preços), o anúncio e a documentação e o CHANGELOG do Claude Code, e organiza as especificações principais (claude-opus-5-5, contexto de 1M, saída máxima de 128K, corte de conhecimento em junho de 2026, desativação não antes de 22 de setembro de 2027), o preço ($4 de entrada / $20 de saída, 20% abaixo dos $5 / $25 do Opus 5, com a leitura de cache 60% mais barata, a $0,20; mas a diferença na leitura de cache para o Fable 5.1 é de só 20%, e ela custa o mesmo que no Sonnet 5) e os números da tabela comparativa da Anthropic (a maior pontuação em 7 de 9 linhas, incluindo 66,4% no Terminal-Bench 4.0 e 1846 no GDPval-AA v2.1, enquanto o GPT-6 Astra lidera no AutomationBench e no Terminal-Bench-Science 0.1 na mesma tabela). Em seguida, explica o que significa a queda do effort padrão de high para medium, as quatro mudanças que transformam código que funcionava no Opus 5 em erros 400 (não dá para desligar o raciocínio, uso forçado de ferramentas, blocos de raciocínio vinculados ao modelo e à conversa, e a ferramenta antiga de computer use na Claude API e no Google Cloud) e como corrigi-las, as mudanças que não geram erro, como o texto entre chamadas de ferramenta passando para blocos de raciocínio, o Opus 5.5 virando o modelo padrão do Claude Code sem herdar as configurações de effort salvas e, por fim, como escolher entre Opus 5.5, Fable 5.1, Sonnet 5 e Opus 5, além dos passos da migração.

Se o Claude Code mostra “claude.ai connectors are disabled because ANTHROPIC_API_KEY or another auth source is set and takes precedence over your claude.ai login”, uma credencial como a variável de ambiente ANTHROPIC_API_KEY tem prioridade sobre o login do claude.ai salvo, e os conectores que você adicionou no claude.ai não estão sendo carregados. O login não sumiu; só não é usado por causa da ordem de prioridade. Com base na documentação oficial de autenticação e de MCP e no CHANGELOG, este artigo explica a ordem de prioridade da autenticação, como ver qual credencial está em uso com /status e pelas variáveis de ambiente, de onde a chave vem (configuração do shell, .env, env e apiKeyHelper nos arquivos de configurações), como remover a chave, reiniciar e conferir, o que se perde ao continuar com a chave de API (conectores, Remote Control, /schedule) e a diferença na cobrança, e como impedir o aviso com disableClaudeAiConnectors. Pontos que não estão na documentação oficial aparecem separados, como verificações feitas no próprio Claude Code.

Se o Claude Code mostrar “API Error: The response stopped arriving. The response above may be incomplete.” no meio de uma resposta, a conexão continuou aberta, mas os dados pararam de chegar, e o temporizador de monitoramento do Claude Code a encerrou. A saída concluída permanece: confira o estado do trabalho e responda continue para retomar de onde parou. Esta mensagem é a versão renomeada do que aparecia como “Response stalled mid-stream” antes da v2.1.227. Com base na referência oficial de erros e na documentação de configuração de rede, explicamos as diferenças para Connection lost mid-response, The response stalled before a response was produced e Streaming response ended before any complete data was received, por que não há reenvio, como -p e os subagentes lidam com ela, como verificar a versão, o caminho da rede e os temporizadores de monitoramento, e o que registrar ao relatar o problema. Os cinco relatos que abrimos no GitHub são tratados separadamente da explicação oficial, como casos não confirmados.

Se o Claude Code mostrar “Login expired · Please run /login”, a renovação automática do login salvo foi recusada e o Claude Code apagou as credenciais. As instruções seguintes não chegam à API e param na sua máquina, então entre de novo com /login em vez de repetir a tentativa. Com base na referência oficial de erros, explicamos a diferença para Not logged in, OAuth token has expired e Your account is on hold, a mudança da mensagem na v2.1.206, os passos da verificação com /status até entrar de novo, o que fazer com -p e em CI, e o que verificar quando a mensagem se repete: versão, Keychain, relógio e CLAUDE_CONFIG_DIR. Os 6 relatos do GitHub aparecem à parte, como casos sem causa confirmada.

Quando o Claude Cowork foi incorporado ao chat em 16 de setembro de 2026, três recursos de criação chegaram em beta ao mesmo tempo: Claude Docs para documentos, Claude Slides para apresentações e Claude Design para design visual. Este artigo é sobre o primeiro deles. Em uma frase, o Claude Docs transforma o que sai de uma conversa em um documento que você pode continuar editando. Peça que ele escreva a discussão como uma especificação que o time possa compartilhar, e o Claude redige na sua frente, perguntando sobre o que estiver faltando antes de começar. O que você recebe é texto formatado com títulos e tabelas, e um único documento pode conter várias abas. Dá para editar você mesmo, ou selecionar um trecho dentro do documento, deixar um comentário e mencionar @Claude para que ele faça a mudança. A força que as pessoas ignoram é que também dá para transformar uma sessão do Claude Code em uma especificação, um runbook ou um relatório. Saiu do beta em 8 de outubro de 2026 e já está em todos os planos, inclusive o gratuito, mas ainda faltam coisas: a exclusão não pode ser desfeita, não há permissão só para comentar, e Team e Enterprise não podem compartilhar fora da organização. Este artigo dá a essas ausências tanto espaço quanto aos recursos, e conclui para o que a ferramenta serve e para o que não serve.