FAQ
Técnico

O Windows SmartScreen bloqueia executáveis baixados da internet que não têm assinatura conhecida. O Claude Desktop é oficial, não é vírus.

Solução:

1. Clique em Mais informações na janela de aviso
2. Clique em Executar mesmo assim
3. O instalador roda normal

Se mesmo assim bloquear, clique com botão direito no .exe, vá em Propriedades, marque Desbloquear e clique em OK.

macOS Gatekeeper bloqueia apps baixados fora da App Store na primeira vez.

Solução:

1. Abra Ajustes do Sistema (ou Preferências do Sistema)
2. Vá em Privacidade e Segurança
3. Role até o fim e você vai ver uma mensagem "Claude foi bloqueado" com botão Abrir assim mesmo
4. Clique nesse botão e confirme

Alguns antivírus (especialmente Avast, AVG, McAfee) marcam o Claude Desktop como falso positivo.

Solução:

• Pausa o antivírus por 10 minutos durante a instalação
• Adiciona a pasta C:\Users\SeuUsuario\AppData\Local\AnthropicClaude\ como exceção permanente
• Baixa o instalador de novo de claude.com/download
• Instala e reativa o antivírus depois

O Windows Installer ficou travado numa operação anterior.

Solução:

1. Aperte Win + R, digite services.msc e pressione Enter
2. Procure o serviço Windows Installer
3. Clique com botão direito → Parar, espera 10 segundos, Iniciar
4. Tenta instalar de novo

Se persistir, reinicia o computador e tenta de novo.

Git é requisito obrigatório do Claude Code Desktop pra criar worktrees isolados de sessão.

Solução no Mac: abra o Terminal e digite git --version. Se não estiver instalado, o próprio Mac vai oferecer pra instalar as Developer Tools. Aceita. Leva uns 5 minutos. Depois reinicie o Claude Desktop.

Alternativa: instale via Homebrew: brew install git.

O Claude Desktop não conseguiu detectar o Git porque ele não está no PATH do sistema.

Solução:

1. Baixe o instalador oficial em git-scm.com/downloads/win
2. Execute e durante a instalação, na tela Adjusting your PATH environment, escolha a opção Git from the command line and also from 3rd-party software (opção do meio, default)
3. Finaliza a instalação
4. Reinicia o computador (não só o Claude)
5. Abre o Claude Desktop e testa a tab Código

Significa que sua assinatura Claude Pro (ou superior) não está ativa na conta logada.

Solução:

1. Acesse claude.ai/upgrade no navegador
2. Confirme que você está logado com a mesma conta que usou no Claude Desktop
3. Confirme que o plano Pro está ativo (não o Free)
4. Volta no Claude Desktop, faz logout pelo menu (ícone do usuário no canto), e loga de novo
5. A tab Código deve aparecer

Se o plano está pago mas não sincroniza, force uma atualização: feche o Claude Desktop completamente (Cmd+Q no Mac, fechar pela bandeja do Windows) e abra de novo.

Esse é o erro mais comum. Autenticação expirou ou a conta não tem permissão.

Solução passo a passo:

1. No app, clique no menu do usuário → Sign out
2. Feche o Claude Desktop COMPLETAMENTE (não só a janela)
3. Abra de novo e faça login
4. Se persistir, verifique em claude.ai/settings/subscription se seu plano está ativo
5. Se a CLI do Claude Code funciona mas o Desktop não, é problema do cache do Desktop — reinstala

O Claude Desktop tentou abrir o navegador pro OAuth mas bateu em firewall ou bloqueio.

Solução:

• Copie o link que aparece no app (geralmente começa com https://claude.ai/oauth/)
• Cola manualmente no navegador
• Complete o login
• Volta pro Claude Desktop — ele detecta automaticamente

Motivos possíveis: pasta não existe mais, Git LFS faltando, ou permissões bloqueadas.

Diagnóstico rápido:

1. Verifique se a pasta ainda existe no caminho original
2. Se o repo usa Git LFS, instale em git-lfs.com e rode git lfs install
3. Se a pasta tem problema de permissão (pasta do sistema), escolhe outra pasta — por exemplo uma pasta nova em ~/Documentos/
4. Reinicia o Claude Desktop

O Desktop App não herda o shell completo — ele lê só o PATH básico do seu perfil.

Solução:

1. Abra o Terminal e confirme que node --version e npm --version funcionam
2. Se funcionam, o problema é que o Claude não acha os binários. Adicione o caminho explícito no arquivo ~/.claude/settings.json:

{
  "env": {
    "PATH": "/usr/local/bin:/opt/homebrew/bin:$PATH"
  }
}

Reinicia o Claude Desktop depois de salvar o arquivo.

Cache corrompido ou atualização no meio do caminho.

Solução em ordem:

1. Feche o app completamente (Cmd+Q ou pela bandeja do Windows)
2. Abra de novo — o Claude costuma auto-atualizar e resolver sozinho
3. Se persistir, reinicie o computador
4. Se ainda persistir, reinstale pegando a versão mais recente em claude.com/download

Isso é por design, não é bug. Depois que uma sessão inicia, o modelo fica travado até o fim dela.

Como trocar:

• Clica em + Nova sessão na sidebar esquerda
• Antes de escrever o primeiro prompt, escolhe o modelo diferente no dropdown ao lado do botão enviar
• Aí sim escreve e envia — a nova sessão inteira vai rodar no modelo escolhido

A sessão antiga continua rodando no modelo original — você pode alternar entre elas na sidebar.

Pode ser um loop infinito ou chamada de ferramenta externa que não retornou.

Solução:

1. Clica no botão de parar (quadrado) ao lado do prompt — isso interrompe a execução atual
2. Se o botão não responde, digite uma instrução nova e aperta Enter — o Claude interrompe o atual e segue
3. Se o chat inteiro travou, fecha a sessão, abre uma nova na mesma pasta
4. Se o app inteiro travou, força o fechamento (Cmd+Option+Esc no Mac, Ctrl+Shift+Esc no Windows)

Você provavelmente tá em modo Auto accept edits e ele tá seguindo as instruções literalmente.

Solução imediata:

1. Clica em stop pra interromper
2. Troca o permission mode pra Ask permissions (default recomendado) no seletor ao lado do send button
3. Digite desfaz tudo que você fez desde X e aperta Enter — ele reverte as mudanças
4. Ou usa o diff view pra rejeitar as mudanças específicas que não queria

Se você usa o Claude Desktop numa rede corporativa com proxy, precisa configurar as variáveis de ambiente.

Variáveis necessárias:

HTTPS_PROXY=http://proxy.empresa.com:8080
HTTP_PROXY=http://proxy.empresa.com:8080
NO_PROXY=localhost,127.0.0.1

No Mac, adicione em ~/.zshrc ou ~/.bash_profile. No Windows, adicione nas variáveis de ambiente do sistema (Win+R → sysdm.cpl → Avançado → Variáveis de Ambiente).

Peça ao seu TI pra liberar os domínios: claude.ai, anthropic.com, api.anthropic.com.

Algumas redes corporativas fazem SSL inspection que injeta certificados próprios.

Solução:

• Peça ao TI o certificado CA da empresa (arquivo .crt ou .pem)
• Instale no chaveiro do sistema (Keychain no Mac, Gerenciador de Certificados no Windows)
• Reinicia o Claude Desktop
• Se persistir, teste conectar num hotspot de celular pra confirmar que é problema de rede corporativa e não do app