Extensão do Claude parou de funcionar depois de atualizar? O roteiro de checagem do mais barato ao mais caro

Fala aí, beleza? Tu atualizou, abriu o editor e o Claude simplesmente não responde mais

O impulso é sempre o mesmo: desinstalar tudo, limpar tudo, reinstalar do zero e rezar

Só que esse é o passo MAIS caro do roteiro, e quase nunca é o primeiro

Reinstalar apaga a evidência antes de você descobrir o que quebrou, e aí na próxima atualização você não faz ideia do que fazer de novo

A lógica aqui é outra: ir do mais barato pro mais caro, isolando a causa em vez de arrancar peça no chute

Cada seção abaixo é um degrau. Se resolveu no degrau 1, você nem precisa ler o resto =)

Passo mais barato: o que <code>/doctor</code> e <code>/status</code> já respondem sozinhos

Sintoma: depois da atualização o comportamento ficou estranho, mas não aparece um erro claro na tela. Às vezes abre, às vezes não

Causa provável: instalação ou configuração inconsistente, ou sessão vencida. Duas coisas que o próprio Claude Code sabe checar

Solução: antes de mexer em QUALQUER coisa, roda o checkup

1. Rode o diagnóstico dentro do Claude Code:

/doctor

Ele faz um checkup de instalação e configuração e consegue corrigir os problemas que encontra. O erro comum deste passo é pular ele achando que é genérico demais, e depois passar meia hora mexendo em coisa que o <code>/doctor</code> já teria resolvido

2. Se o <code>claude</code> nem inicia, use o equivalente direto no shell:

claude doctor

O erro comum aqui é insistir em abrir a sessão pra rodar <code>/doctor</code> quando a sessão é justamente o que não abre

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

3. Confira o estado da conta:

/status

Ele mostra a organização, o e-mail salvo e a linha de Login. Essa linha é a que mais entrega problema silencioso

Como prevenir: transforme esses dois comandos em reflexo pós-atualização. Atualizou, rodou <code>/doctor</code> e <code>/status</code>, aí sim você começa a investigar de verdade

Login expirado ou credencial que não chega na IDE:

Esse aqui é o campeão de falso alarme. Você jura que a extensão quebrou e o que morreu foi a sessão

Sintoma A: o <code>/status</code> mostra a linha de Login com <code>Expired: log in again</code>

A correção é uma linha:

/login

E se liga nisso: quando faltam três dias pro login expirar, o Claude Code já mostra um aviso no início da sessão pedindo pra rodar <code>/login</code>. Aquele aviso que você fechou sem ler na segunda-feira é o motivo da sexta-feira estar quebrada, haha

Sintoma B: funciona no terminal, falha na extensão do VS Code ou do JetBrains

Esse é diferente, e a documentação oficial é bem direta: se as credenciais funcionam no terminal mas não na extensão, o processo da IDE provavelmente não herdou o ambiente do shell

Ou seja, o problema não é a credencial, é QUEM está lendo ela

Quando não dá pra apontar uma causa óbvia, o caminho é reautenticar do zero:

1. Desconecte a conta:

/logout

Ele desconecta a conta Anthropic e também reseta o estado de setup inicial, então o próximo <code>claude</code> refaz login e configuração. O erro comum deste passo é achar que <code>/logout</code> é só um logout inofensivo: ele mexe no primeiro uso também, e é exatamente por isso que funciona

2. Reinicie com <code>claude</code> e complete a autenticação de novo. Essa é a orientação oficial e resolve a maioria dos casos de falha de login sem causa aparente

3. Se o navegador não abrir sozinho, pressione <code>c</code> para copiar a URL de OAuth e cole no navegador na mão. O erro comum aqui é ficar esperando a aba abrir e concluir que travou

E um lembrete de requisito, porque volta e meia a confusão é essa: o Claude Code funciona com qualquer assinatura paga do Claude (Pro, Max, Team ou Enterprise) ou com conta do Claude Console, e nenhuma chave de API é exigida

Ou seja, se você está caçando onde colar uma chave, você está caçando a coisa errada. Chave é papo de integração própria, aquele mundo da documentação da Claude API, não do login da extensão

Como prevenir: renove no aviso dos três dias, não no dia em que parar

O ícone da extensão desapareceu no VS Code:

Sintoma: a extensão está instalada, aparece lá na lista, mas nada surge na barra do editor

Causas e correções oficiais, na ordem que custa menos:

1. Abra a Command Palette e rode <code>Developer: Reload Window</code>. Muita coisa pós-atualização é só a janela do editor precisando recarregar

2. Tenha um arquivo aberto. Só a pasta aberta não basta pro ícone aparecer na barra do editor. O erro comum deste passo é abrir o projeto, olhar a árvore de arquivos e concluir que a extensão sumiu

3. Cheque o workspace trust. A extensão não funciona em Restricted Mode, ponto. Se você abriu aquele projeto clonado ontem e clicou em não confiar, é isso

4. Confira a versão do editor: VS Code 1.94.0 ou superior. A versão você vê em Help → About

5. Se precisar achar ou gerenciar a extensão, busque por <code>Claude Code</code> na Extensions view (Cmd+Shift+X no Mac, Ctrl+Shift+X no Windows e Linux)

6. Precisa de um caminho alternativo pra abrir? Na Command Palette (Cmd+Shift+P / Ctrl+Shift+P), digite <code>Claude Code</code> e escolha <code>Open in New Tab</code>

Como prevenir: atualize o editor junto com a extensão, e evite abrir projeto em modo restrito quando você depende da extensão pra trabalhar

‘No available IDEs detected’: o erro que engana

Esse texto parece dizer que a IDE quebrou. Quase sempre não é isso

Sintoma: você roda <code>/ide</code> e recebe <code>No available IDEs detected</code>

Causa primeira, e a checagem oficial: confirmar que o <code>claude</code> foi iniciado a partir do terminal integrado da IDE

É o tipo de detalhe bobo que come uma tarde inteira. Você abriu o terminal do sistema por costume, e o Claude Code não tem como enxergar a IDE dali

Se você usa uma IDE JetBrains, a checagem oficial tem três partes:

1. Rode o Claude Code a partir da raiz do projeto

2. Confirme que o plugin JetBrains está habilitado nas configurações da IDE

3. Reinicie a IDE por completo. E olha, pode ser necessário mais de um reinício. Não é lenda, está na documentação

Tem também uma configuração própria do plugin que salva o caso do binário em caminho esquisito: em Settings → Tools → Claude Code (Beta) dá pra definir o comando Claude (por exemplo <code>claude</code>, <code>/usr/local/bin/claude</code> ou <code>npx @anthropic-ai/claude-code</code>), suprimir notificações e habilitar atualizações automáticas

Se o <code>claude</code> está num caminho que a IDE não encontra, é ali que você informa o caminho completo

E se você está no WSL2 com IDE JetBrains? Aí muda o suspeito: a causa usual do <code>No available IDEs detected</code> é o NAT do WSL2 ou o Firewall do Windows bloqueando a conexão entre o WSL2 e a IDE rodando no host Windows

Ou seja, você pode reinstalar o plugin dez vezes que não vai adiantar, o problema é rede

Como prevenir: padronize abrir o Claude Code sempre pelo terminal integrado. Vira músculo e esse erro some do seu dia

Quando a culpa é da versão: changelog, rollback e instalação duplicada

Sintoma: quebrou exatamente depois de uma atualização. A correlação é direta demais pra ser coincidência

Aqui a ordem importa MUITO, porque é fácil piorar a situação

1. Leia o changelog antes de qualquer coisa. O changelog oficial do Claude Code lista novidades, melhorias e correções por versão, e é gerado a partir do CHANGELOG.md no GitHub. Se o seu sintoma já está descrito como correção de uma versão, acabou a investigação

2. Teste a versão anterior da extensão. No VS Code, clique com o botão direito na extensão, escolha <code>Install Another Version</code> e selecione a versão desejada na lista. O erro comum deste passo é desinstalar e reinstalar torcendo pra voltar a versão antiga: reinstalação te dá a mais nova de novo, rollback é outro caminho

3. Considere ir pra frente em vez de pra trás. Nem todo problema se resolve voltando:

claude update

Esse comando aplica a atualização imediatamente, sem esperar a checagem em segundo plano

4. Se sua instalação é via npm, use o comando certo:

npm install -g @anthropic-ai/claude-code@latest

O erro comum deste passo é rodar <code>npm update -g</code>, que respeita a faixa de semver da instalação original e pode simplesmente não te levar até a versão mais nova. Você jura que atualizou e não atualizou

5. Cheque instalação duplicada, que é o degrau que mais engana aqui. Múltiplas instalações do Claude Code podem gerar version mismatch e comportamento inesperado. A orientação oficial é manter só uma, preferindo a instalação nativa em <code>~/.local/bin/claude</code> no macOS e Linux, ou <code>%USERPROFILE%\.local\bin\claude.exe</code> no Windows

Esse caso é sorrateiro: você atualiza uma instalação e o sistema continua chamando a outra. Já vi gente jurar de pé junto que atualizou tudo, e o binário que rodava era o do vizinho, kkk

O erro comum deste passo é rodar o update, ver a versão nova na saída do comando e parar por aí: se sobrou mais de uma instalação, a que o seu PATH chama pode continuar sendo a velha. Deixa uma só e o sintoma some junto

Como prevenir: uma instalação só, e atualizar CLI e extensão no mesmo momento

Conflito com outra extensão: use o Extension Bisect antes de desinstalar tudo

Sintoma: você passou por todos os degraus acima, está tudo certo, e o problema continua

Causa: outra extensão interferindo

E aqui vem o ponto onde a maioria das pessoas desiste e sai desinstalando no chute

Só que o VS Code tem um utilitário nativo exatamente pra isso: o Extension Bisect

Você inicia pelo comando <code>Help: Start Extension Bisect</code> na Command Palette

Ele desabilita metade das extensões por vez e pergunta se o problema continua, repetindo o corte até isolar a responsável

Se você conhece busca binária, é ela, aplicada ao seu editor. Em vez de testar uma a uma, você corta o universo no meio a cada rodada. Muito mais rápido, e você termina com um NOME em vez de um palpite

E um detalhe que economiza tempo de verdade: desinstalar a extensão do Claude Code não basta

Rodar <code>claude</code> no terminal integrado do VS Code reinstala a extensão automaticamente

Pra manter desinstalada, desligue o <code>Auto-install IDE extension</code> no <code>/config</code> ou defina <code>autoInstallIdeExtension</code> como false

O erro comum aqui é desinstalar, abrir o terminal integrado pra testar, e concluir que a extensão está com defeito porque voltou sozinha 😀

Como prevenir: anote o resultado do bisect. Na próxima atualização você já sabe qual dupla briga

Se o que parou foi a extensão no navegador:

Às vezes não é o editor, é a integração com o browser que emudeceu

Sintoma: as ferramentas de navegador simplesmente pararam de responder

Primeiro, os requisitos:

• Extensão Claude in Chrome versão 1.0.36 ou superior, disponível na Chrome Web Store
• Google Chrome, Microsoft Edge ou outros navegadores baseados em Chromium (Brave, Arc, Vivaldi, Opera)
• Plano direto da Anthropic (Pro, Max, Team ou Enterprise) e login via <code>/login</code>

O diagnóstico tem comando próprio:

/chrome

Ele mostra o status da conexão, gerencia permissões, reconecta a extensão e deixa escolher qual navegador conectado usar

A integração está OK quando o painel mostra <code>Status: Enabled</code> e <code>Extension: Installed</code>. Se não mostra as duas coisas, você já sabe onde está o buraco

Agora, as causas específicas, porque cada mensagem quer uma correção diferente:

Esse último é ótimo, porque parece bug e é só um popup do JavaScript esperando você clicar em OK, haha

Como prevenir: ao retomar uma sessão longa, rode <code>/chrome</code> e reconecte antes de sair pedindo coisa

Conclusão

O roteiro inteiro cabe em duas ideias: barato antes de caro, isolar antes de remover

Reinstalar do zero não é diagnóstico, é rendição. E o pior: te devolve ao mesmo lugar na próxima atualização, sem nenhuma informação nova na mão

Seu próximo passo concreto, na ordem:

1. Rode <code>/doctor</code> e <code>/status</code> agora, antes de mexer em qualquer configuração
2. Anote o que mudou na última atualização (CLI, extensão, editor, navegador, os três juntos?)
3. Confira o changelog antes de partir pra rollback ou pro Extension Bisect

Se em algum degrau o sintoma sumir, para ali e registra o que era. Esse registro é o que faz a próxima vez levar cinco minutos em vez de uma tarde

Até o próximo post! =)