Solucionar problemas de instalação e login

Se a instalação falhar ou você não conseguir fazer login, encontre seu erro abaixo. Para problemas de tempo de execução após o Claude Code estar funcionando, consulte Troubleshooting. Para problemas de configuração, como configurações não sendo aplicadas ou hooks não disparando, consulte Debug your configuration.

Encontre seu erro

Corresponda a mensagem de erro ou sintoma que você está vendo a uma solução:

O que você vê	Solução
`command not found: claude` ou `'claude' is not recognized`	Corrija seu PATH
`syntax error near unexpected token '<'`	O script de instalação retorna HTML
`curl: (22) The requested URL returned error: 403`	O script de instalação retornou 403
`curl: (23)` ou `curl: (56) Failure writing output to destination`	Verifique a conectividade ou use um instalador alternativo
`Killed` durante a instalação no Linux	Adicione espaço de troca para servidores com pouca memória
`TLS connect error` ou `SSL/TLS secure channel`	Atualize os certificados CA
`Failed to fetch version` ou não consegue alcançar o servidor de download	Verifique as configurações de rede e proxy
`irm is not recognized` ou `&& is not valid`	Use o comando correto para seu shell
`'bash' is not recognized as the name of a cmdlet`	Use o comando do instalador do Windows
`Claude Code on Windows requires either Git for Windows (for bash) or PowerShell`	Instale um shell
`Claude Code does not support 32-bit Windows`	Abra o Windows PowerShell, não a entrada x86
`The process cannot access the file ... because it is being used by another process`	Limpe a pasta de downloads e tente novamente
`Error loading shared library`	Variante binária incorreta para seu sistema
`Illegal instruction`	Incompatibilidade de arquitetura ou conjunto de instruções da CPU
`cannot execute binary file: Exec format error` em WSL	Regressão de binário nativo WSL1
O instalador PowerShell é concluído mas `claude` não é encontrado ou mostra uma versão antiga	Reinicie seu terminal e verifique PATH
`dyld: cannot load`, `dyld: Symbol not found`, ou `Abort trap` no macOS	Incompatibilidade binária
`Invoke-Expression: Missing argument in parameter list`	O script de instalação retorna HTML
`App unavailable in region`	Claude Code não está disponível em seu país. Consulte países suportados.
`unable to get local issuer certificate`	Configure certificados CA corporativos
`OAuth error` ou `403 Forbidden`	Corrija a autenticação
`Could not load the default credentials` ou `Could not load credentials from any providers`	Credenciais do Bedrock, Vertex ou Foundry
`ChainedTokenCredential authentication failed` ou `CredentialUnavailableError`	Credenciais do Bedrock, Vertex ou Foundry
`API Error: 500`, `529 Overloaded`, `429`, ou outros erros 4xx e 5xx não listados acima	Consulte a referência de erros

Se seu problema não estiver listado, trabalhe através das verificações de diagnóstico abaixo para estreitar a causa.

Se você preferir pular o terminal completamente, o Claude Code Desktop app permite que você instale e use Claude Code através de uma interface gráfica. Baixe-o para macOS ou Windows e comece a codificar sem nenhuma configuração de linha de comando.

Execute verificações de diagnóstico

Verifique a conectividade de rede

O instalador baixa de downloads.claude.ai. Verifique se você consegue alcançá-lo:

curl -sI https://downloads.claude.ai/claude-code-releases/latest

Uma linha HTTP/2 200 significa que você alcançou o servidor. Se você vir nenhuma saída, Could not resolve host, ou um tempo limite de conexão, sua rede está bloqueando a conexão. Causas comuns:

Firewalls corporativos ou proxies bloqueando downloads.claude.ai
Restrições de rede regional: tente uma VPN ou rede alternativa
Problemas de TLS/SSL: atualize os certificados CA do seu sistema, ou verifique se HTTPS_PROXY está configurado

Se você estiver atrás de um proxy corporativo, defina HTTPS_PROXY e HTTP_PROXY para o endereço do seu proxy antes de instalar. Peça à sua equipe de TI pela URL do proxy se você não souber, ou verifique as configurações de proxy do seu navegador. Este exemplo define ambas as variáveis de proxy e executa o instalador através do seu proxy:

macOS/Linux
Windows PowerShell

export HTTP_PROXY=http://proxy.example.com:8080
export HTTPS_PROXY=http://proxy.example.com:8080
curl -fsSL https://claude.ai/install.sh | bash

$env:HTTP_PROXY = 'http://proxy.example.com:8080'
$env:HTTPS_PROXY = 'http://proxy.example.com:8080'
irm https://claude.ai/install.ps1 | iex

Verifique seu PATH

Se a instalação foi bem-sucedida mas você recebe um erro command not found ou not recognized ao executar claude, o diretório de instalação não está em seu PATH. Seu shell procura por programas em diretórios listados em PATH, e o instalador coloca claude em ~/.local/bin/claude no macOS/Linux ou %USERPROFILE%\.local\bin\claude.exe no Windows. Verifique se o diretório de instalação está em seu PATH listando suas entradas de PATH e filtrando por local/bin:

macOS/Linux
Windows PowerShell
Windows CMD

echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin"

Se isso imprimir /Users/you/.local/bin ou /home/you/.local/bin, o diretório está em seu PATH e você pode pular para Verifique se há instalações conflitantes. Se não houver saída, adicione-o à sua configuração de shell.Para Zsh, o padrão no macOS:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Para Bash, o padrão na maioria das distribuições Linux:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Alternativamente, feche e reabra seu terminal.Para outros shells como fish ou Nushell, adicione ~/.local/bin ao seu PATH usando a sintaxe de configuração do seu próprio shell, depois reinicie seu terminal.Verifique se a correção funcionou:

claude --version

$env:PATH -split ';' | Select-String '\.local\\bin'

Se não houver saída, adicione o diretório de instalação ao seu User PATH:

$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

Reinicie seu terminal para que a alteração tenha efeito.Verifique se a correção funcionou:

claude --version

echo %PATH% | findstr /i "local\bin"

Se não houver saída, abra Configurações do Sistema, vá para Variáveis de Ambiente e adicione %USERPROFILE%\.local\bin à sua variável User PATH. Reinicie seu terminal.Verifique se a correção funcionou:

claude --version

Verifique se há instalações conflitantes

Múltiplas instalações do Claude Code podem causar incompatibilidades de versão ou comportamento inesperado. Verifique o que está instalado:

macOS/Linux
Windows PowerShell

Liste todos os binários claude encontrados em seu PATH:

which -a claude

Se isso não imprimir nada, nenhum claude está em seu PATH ainda. Volte para Verifique seu PATH.Verifique os três locais de onde um binário claude pode vir. ~/.local/bin/claude é o instalador nativo, ~/.claude/local/ é uma instalação npm local legada criada por versões antigas do Claude Code, e a lista npm global mostra uma instalação -g:

ls -la ~/.local/bin/claude

ls -la ~/.claude/local/

npm -g ls @anthropic-ai/claude-code 2>/dev/null

Liste todos os binários claude encontrados em seu PATH:

where.exe claude

Verifique se o instalador nativo colocou um binário:

Test-Path "$env:USERPROFILE\.local\bin\claude.exe"

Se você encontrar múltiplas instalações, mantenha apenas uma. A instalação nativa em ~/.local/bin/claude no macOS/Linux ou %USERPROFILE%\.local\bin\claude.exe no Windows é recomendada. Remova as extras: Desinstale uma instalação npm global:

npm uninstall -g @anthropic-ai/claude-code

Remova a instalação npm local legada:

rm -rf ~/.claude/local

No Windows, use PowerShell:

Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\local"

Remova uma instalação Homebrew no macOS. Se você instalou o cask claude-code@latest, substitua esse nome:

brew uninstall --cask claude-code

Remova uma instalação WinGet no Windows:

winget uninstall Anthropic.ClaudeCode

Verifique permissões de diretório

O instalador precisa de acesso de escrita a ~/.local/bin/ e ~/.claude/ no macOS e Linux. No Windows, o local de instalação está sob %USERPROFILE%, que é gravável pelo seu usuário por padrão, então esta seção raramente se aplica lá. Verifique se os diretórios são graváveis:

test -w ~/.local/bin && echo "writable" || echo "not writable"
test -w ~/.claude && echo "writable" || echo "not writable"

Se algum diretório não for gravável, crie o diretório de instalação e defina seu usuário como proprietário:

sudo mkdir -p ~/.local/bin
sudo chown -R $(whoami) ~/.local

Verifique se o binário funciona

Se claude --version imprime uma versão mas claude falha ou trava na inicialização, execute estas verificações para estreitar a causa. Se claude --version disser comando não encontrado, vá para Verifique seu PATH primeiro; os comandos abaixo assumem que claude está em seu PATH. Confirme que o binário existe e é executável:

ls -la "$(command -v claude)"

No Windows, use PowerShell:

Get-Command claude | Select-Object Source

No Linux, verifique se há bibliotecas compartilhadas ausentes. Se ldd mostrar bibliotecas ausentes, você pode precisar instalar pacotes do sistema. No Alpine Linux e outras distribuições baseadas em musl, consulte Alpine Linux setup.

ldd "$(command -v claude)" | grep "not found"

Confirme que o binário pode executar:

claude --version

Problemas comuns de instalação

Estes são os problemas de instalação mais frequentemente encontrados e suas soluções.

Install script returns HTML instead of a shell script

Ao executar o comando de instalação, você pode ver um destes erros:

bash: line 1: syntax error near unexpected token `<'
bash: line 1: `<!DOCTYPE html>'

No PowerShell, o mesmo problema aparece como:

Invoke-Expression: Missing argument in parameter list.

Dependendo de como a solicitação foi roteada, você pode ver um 403 sem corpo HTML:

curl: (22) The requested URL returned error: 403

Todos esses significam que a URL de instalação retornou uma página HTML ou um status de erro em vez do script de instalação. Se a página HTML disser “App unavailable in region,” Claude Code não está disponível em seu país. Consulte supported countries. Um 403 simples sem corpo frequentemente tem a mesma causa, mas também pode vir de um proxy corporativo ou firewall bloqueando o download. Se você estiver em um país suportado e ainda vir o 403, trabalhe através de Check network connectivity antes de tentar os instaladores alternativos abaixo, já que esses alcançam os mesmos hosts. Caso contrário, isso pode acontecer devido a problemas de rede, roteamento regional ou uma interrupção temporária do serviço. Soluções:

Use um método de instalação alternativo: No macOS, instale via Homebrew:
```
brew install --cask claude-code
```
No Windows, instale via WinGet:
```
winget install Anthropic.ClaudeCode
```
Tente novamente após alguns minutos: o problema é frequentemente temporário. Aguarde e tente o comando original novamente.

`command not found: claude` after installation

A instalação foi concluída mas claude não funciona. O erro exato varia por plataforma:

Plataforma	Mensagem de erro
macOS	`zsh: command not found: claude`
Linux	`bash: claude: command not found`
Windows CMD	`'claude' is not recognized as an internal or external command`
PowerShell	`claude : The term 'claude' is not recognized as the name of a cmdlet`

Isso significa que o diretório de instalação não está no caminho de pesquisa do seu shell. Consulte Verify your PATH para a correção em cada plataforma.

`curl: (56) Failure writing output to destination`

O comando curl ... | bash baixa o script e o encanua para Bash para execução. Este erro, e o relacionado curl: (23) Failure writing output to destination, significa que Bash não recebeu o script completo. O código de saída 56 indica que o download em si foi interrompido, e o código de saída 23 indica que curl não conseguiu escrever o que recebeu para o pipe, geralmente porque Bash saiu cedo. Soluções:

Verifique a estabilidade da rede: Os binários do Claude Code são hospedados em downloads.claude.ai. Teste se você consegue alcançá-lo:
```
curl -sI https://downloads.claude.ai/claude-code-releases/latest
```
Uma linha HTTP/2 200 significa que você alcançou o servidor e a falha original foi provavelmente intermitente; tente novamente o comando de instalação. Se você vir Could not resolve host ou um tempo limite de conexão, sua rede está bloqueando o download.

Tente um método de instalação alternativo: No macOS:

brew install --cask claude-code

No Windows:

winget install Anthropic.ClaudeCode

TLS or SSL connection errors

Erros como curl: (35) TLS connect error, schannel: next InitializeSecurityContext failed, ou Could not establish trust relationship for the SSL/TLS secure channel do PowerShell indicam falhas de handshake TLS. Soluções:

Atualize seus certificados CA do sistema: No Ubuntu/Debian:
```
sudo apt-get update && sudo apt-get install ca-certificates
```
No macOS, o curl do sistema usa o armazenamento de confiança do Keychain; atualizar o macOS em si atualiza os certificados raiz.

No Windows, ative TLS 1.2 no PowerShell antes de executar o instalador:

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
irm https://claude.ai/install.ps1 | iex

Verifique se há interferência de proxy ou firewall: proxies corporativos que realizam inspeção TLS podem causar esses erros, incluindo unable to get local issuer certificate e SELF_SIGNED_CERT_IN_CHAIN. Para a etapa de instalação, aponte curl para seu pacote CA corporativo com --cacert:
```
curl --cacert /path/to/corporate-ca.pem -fsSL https://claude.ai/install.sh | bash
```
Para o Claude Code em si uma vez instalado, defina NODE_EXTRA_CA_CERTS para que as solicitações de API confiem no mesmo pacote:
```
export NODE_EXTRA_CA_CERTS=/path/to/corporate-ca.pem
```
Peça à sua equipe de TI pelo arquivo de certificado se você não tiver. Você também pode tentar em uma conexão direta para confirmar que o proxy é a causa.
No Windows, ignore verificações de revogação de certificado se você vir CRYPT_E_NO_REVOCATION_CHECK (0x80092012) ou CRYPT_E_REVOCATION_OFFLINE (0x80092013). Estes significam que curl alcançou o servidor mas sua rede bloqueia a pesquisa de revogação de certificado, o que é comum atrás de firewalls corporativos. Adicione --ssl-revoke-best-effort ao comando de instalação:
```
curl --ssl-revoke-best-effort -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
```
Alternativamente, instale com winget install Anthropic.ClaudeCode, que evita curl completamente.

`Failed to fetch version from downloads.claude.ai`

O instalador não conseguiu alcançar o servidor de download. Isso normalmente significa que downloads.claude.ai está bloqueado em sua rede. Soluções:

Teste a conectividade diretamente:

curl -sI https://downloads.claude.ai/claude-code-releases/latest

Se atrás de um proxy, defina HTTPS_PROXY para que o instalador possa rotear através dele. Consulte proxy configuration para detalhes.
```
export HTTPS_PROXY=http://proxy.example.com:8080
curl -fsSL https://claude.ai/install.sh | bash
```
Se em uma rede restrita, tente uma rede diferente ou VPN, ou use um método de instalação alternativo: No macOS:
```
brew install --cask claude-code
```
No Windows:
```
winget install Anthropic.ClaudeCode
```

Wrong install command on Windows

Se você vir 'irm' is not recognized, The token '&&' is not valid, ou 'bash' is not recognized as the name of a cmdlet, você copiou o comando de instalação para um shell ou sistema operacional diferente.

irm não reconhecido: você está em CMD, não PowerShell. Você tem duas opções: Abra PowerShell procurando por “PowerShell” no menu Iniciar e execute o comando de instalação original:
```
irm https://claude.ai/install.ps1 | iex
```
Ou fique em CMD e use o instalador CMD em vez disso:
```
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
```
&& não válido: você está em PowerShell mas executou o comando do instalador CMD. Use o instalador PowerShell:
```
irm https://claude.ai/install.ps1 | iex
```
bash não reconhecido: você executou o instalador macOS/Linux no Windows. Use o instalador PowerShell em vez disso:
```
irm https://claude.ai/install.ps1 | iex
```

`The process cannot access the file` during Windows install

Se o instalador PowerShell falhar com Failed to download binary: The process cannot access the file ... because it is being used by another process, o instalador não conseguiu escrever em %USERPROFILE%\.claude\downloads. Isso geralmente significa que uma tentativa de instalação anterior ainda está em execução, ou o software antivírus está verificando um binário parcialmente baixado nessa pasta. Feche qualquer outra janela do PowerShell executando o instalador e aguarde as verificações de antivírus liberarem o arquivo. Depois delete a pasta de downloads e execute o instalador novamente:

Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\downloads"
irm https://claude.ai/install.ps1 | iex

Install killed on low-memory Linux servers

Se você vir Killed durante a instalação em um VPS ou instância em nuvem:

Setting up Claude Code...
Installing Claude Code native build latest...
bash: line 142: 34803 Killed    "$binary_path" install ${TARGET:+"$TARGET"}

O assassino OOM do Linux encerrou o processo porque o sistema ficou sem memória. Claude Code requer pelo menos 4 GB de RAM disponível. Soluções:

Adicione espaço de swap se seu servidor tiver RAM limitada. Swap usa espaço em disco como memória de overflow, permitindo que a instalação seja concluída mesmo com RAM física baixa. Crie um arquivo de swap de 2 GB e ative-o:
```
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
```
Depois tente a instalação novamente:
```
curl -fsSL https://claude.ai/install.sh | bash
```
Feche outros processos para liberar memória antes de instalar.
Use uma instância maior se possível. Claude Code requer pelo menos 4 GB de RAM.

Install hangs in Docker

Ao instalar Claude Code em um contêiner Docker, instalar como root em / pode causar travamentos. Soluções:

Defina um diretório de trabalho antes de executar o instalador. Quando executado de /, o instalador verifica todo o sistema de arquivos, o que causa uso excessivo de memória. Definir WORKDIR limita a verificação a um pequeno diretório:
```
WORKDIR /tmp
RUN curl -fsSL https://claude.ai/install.sh | bash
```
Aumente os limites de memória do Docker se usar Docker Desktop:
```
docker build --memory=4g .
```

Claude Desktop overrides the `claude` command on Windows

Se você instalou uma versão mais antiga do Claude Desktop, ele pode registrar um Claude.exe no diretório WindowsApps que tem prioridade de PATH sobre Claude Code CLI. Executar claude abre o aplicativo Desktop em vez do CLI. Atualize Claude Desktop para a versão mais recente para corrigir este problema.

Claude Code on Windows requires either Git for Windows (for bash) or PowerShell

Git for Windows é opcional. Claude Code usa a PowerShell tool quando Git Bash está ausente, então este erro significa que nenhum shell foi encontrado. Se PowerShell estiver faltando do seu PATH, sua localização padrão é C:\Windows\System32\WindowsPowerShell\v1.0\. Adicione esse diretório ao seu PATH, ou instale PowerShell 7, que fornece pwsh. Para instalar Git for Windows em vez disso, baixe de git-scm.com/downloads/win. Durante a configuração, selecione “Add to PATH.” Reinicie seu terminal após instalar. Instalá-lo ativa a ferramenta Bash, útil ao trabalhar com scripts e ferramentas baseadas em Bash. Se Git já estiver instalado mas Claude Code não conseguir encontrá-lo, defina o caminho em seu settings.json file:

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

Se seu Git estiver instalado em outro lugar, encontre o caminho executando where.exe git no PowerShell e use o caminho bin\bash.exe desse diretório.

Claude Code does not support 32-bit Windows

O Windows inclui duas entradas do PowerShell no menu Iniciar: Windows PowerShell e Windows PowerShell (x86). A entrada x86 é executada como um processo de 32 bits e dispara este erro mesmo em uma máquina de 64 bits. Para verificar qual caso você está, execute isto na mesma janela que produziu o erro:

[Environment]::Is64BitOperatingSystem

Se isso imprimir True, seu sistema operacional está bem. Feche a janela, abra Windows PowerShell sem o sufixo x86 e execute o comando de instalação novamente. Se isso imprimir False, você está em uma edição de 32 bits do Windows. Claude Code requer um sistema operacional de 64 bits. Consulte os system requirements.

Linux musl or glibc binary mismatch

Se você vir erros sobre bibliotecas compartilhadas ausentes como libstdc++.so.6 ou libgcc_s.so.1 após a instalação, o instalador pode ter baixado a variante binária errada para seu sistema.

Error loading shared library libstdc++.so.6: No such file or directory

Isso pode acontecer em sistemas baseados em glibc que têm pacotes de compilação cruzada musl instalados, fazendo o instalador detectar incorretamente o sistema como musl. Soluções:

Verifique qual libc seu sistema usa:
```
ldd --version 2>&1 | head -1
```
A saída mencionando GNU libc ou GLIBC significa glibc. A saída mencionando musl significa musl.
Se você estiver em glibc mas recebeu o binário musl, remova a instalação e reinstale. Você também pode baixar manualmente o binário correto usando o manifesto em https://downloads.claude.ai/claude-code-releases/{VERSION}/manifest.json. Abra um GitHub issue com a saída de ldd --version e ls /lib/libc.musl*.
Se você estiver realmente em musl, como Alpine Linux, instale os pacotes necessários:
```
apk add libgcc libstdc++ ripgrep
```

`Illegal instruction`

Se executar claude ou o instalador imprimir Illegal instruction, o binário nativo usa instruções de CPU que seu processador não suporta. Existem duas causas distintas. Incompatibilidade de arquitetura. O instalador baixou o binário errado, por exemplo x86 em um servidor ARM. Verifique com uname -m no macOS ou Linux, ou $env:PROCESSOR_ARCHITECTURE no PowerShell. Se o resultado não corresponder ao binário que você recebeu, abra um GitHub issue com a saída. Conjunto de instruções AVX ausente. Se sua arquitetura estiver correta mas você ainda vir Illegal instruction, seu CPU provavelmente não tem AVX ou outra instrução que o binário requer. Isso afeta aproximadamente processadores Intel e AMD anteriores a 2013, e máquinas virtuais onde o hipervisor não passa AVX para o convidado. Em um VPS ou VM, execute grep -m1 -ow avx /proc/cpuinfo; um resultado vazio significa que AVX não está disponível para o convidado. Não há solução alternativa de binário nativo; acompanhe issue #50384 para status e inclua seu modelo de CPU de grep -m1 "model name" /proc/cpuinfo no Linux ou sysctl -n machdep.cpu.brand_string no macOS ao relatar. Métodos de instalação alternativos baixam o mesmo binário nativo e não resolverão nenhuma das causas.

`dyld: cannot load` on macOS

Se você vir dyld: cannot load, dyld: Symbol not found, ou Abort trap: 6 durante a instalação, o binário é incompatível com sua versão ou hardware do macOS.

dyld: cannot load 'claude-2.1.42-darwin-x64' (load command 0x80000034 is unknown)
Abort trap: 6

Um erro Symbol not found que referencia libicucore também indica que sua versão do macOS é mais antiga do que o binário suporta:

dyld: Symbol not found: _ubrk_clone
  Referenced from: claude-darwin-x64 (which was built for Mac OS X 13.0)
  Expected in: /usr/lib/libicucore.A.dylib

Soluções:

Verifique sua versão do macOS: Claude Code requer macOS 13.0 ou posterior. Abra o menu Apple e selecione About This Mac para verificar sua versão.
Atualize o macOS se você estiver em uma versão mais antiga. O binário usa comandos de carregamento e bibliotecas do sistema que versões mais antigas do macOS não suportam. Métodos de instalação alternativos como Homebrew baixam o mesmo binário e não resolverão este erro.

`Exec format error` on WSL1

Se executar claude em WSL imprimir cannot execute binary file: Exec format error, você está em WSL1 e atingindo uma regressão de binário nativo conhecida rastreada em issue #38788. Os cabeçalhos do programa do binário mudaram de uma forma que o carregador do WSL1 não consegue lidar. A correção mais limpa é converter sua distribuição para WSL2 do PowerShell:

wsl --set-version <DistroName> 2

Se você precisar ficar em WSL1, invoque o binário através do vinculador dinâmico. Adicione esta função a ~/.bashrc dentro do WSL, substituindo o caminho se seu diretório inicial for diferente:

claude() {
  /lib64/ld-linux-x86-64.so.2 "$(readlink -f "$HOME/.local/bin/claude")" "$@"
}

Depois execute source ~/.bashrc e tente novamente claude.

npm install errors in WSL

Estes problemas se aplicam se você instalou Claude Code com npm install -g dentro do WSL. Se você usou o native installer, pule esta seção. Problemas de detecção de SO ou plataforma. Se npm relatar uma incompatibilidade de plataforma durante a instalação, WSL provavelmente está pegando o npm do Windows. Execute npm config set os linux primeiro, depois instale com npm install -g @anthropic-ai/claude-code --force. Não use sudo. exec: node: not found ao executar claude. Seu ambiente WSL provavelmente está usando a instalação do Windows do Node.js. Confirme com which npm e which node: caminhos começando com /mnt/c/ são binários do Windows, enquanto caminhos Linux começam com /usr/. Para corrigir isso, instale Node via gerenciador de pacotes da sua distribuição Linux ou via nvm. Conflitos de versão nvm. Se você tiver nvm instalado tanto em WSL quanto em Windows, alternar versões do Node em WSL pode quebrar porque WSL importa o PATH do Windows por padrão e o nvm do Windows tem prioridade. A causa mais comum é que nvm não está carregado em seu shell. Adicione o carregador nvm a ~/.bashrc ou ~/.zshrc:

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"

Ou carregue-o em sua sessão atual:

source ~/.nvm/nvm.sh

Se nvm está carregado mas caminhos do Windows ainda têm prioridade, coloque explicitamente seu caminho do Node Linux:

export PATH="$HOME/.nvm/versions/node/$(node -v)/bin:$PATH"

Evite desabilitar a importação de PATH do Windows via appendWindowsPath = false pois isso quebra a capacidade de chamar executáveis do Windows do WSL. Da mesma forma, evite desinstalar Node.js do Windows se você o usa para desenvolvimento do Windows.

Permission errors during installation

Se o instalador nativo falhar com erros de permissão, o diretório de destino pode não ser gravável. Consulte Check directory permissions. Se você instalou anteriormente com npm e está atingindo erros de permissão específicos do npm, mude para o instalador nativo:

curl -fsSL https://claude.ai/install.sh | bash

Native binary not found after npm install

O pacote npm @anthropic-ai/claude-code puxa o binário nativo através de uma dependência opcional por plataforma como @anthropic-ai/claude-code-darwin-arm64. Se executar claude após a instalação imprimir Could not find native binary package "@anthropic-ai/claude-code-<platform>", verifique as seguintes causas:

Dependências opcionais estão desabilitadas. Remova --omit=optional do seu comando npm install, --no-optional do pnpm, ou --ignore-optional do yarn, e verifique que .npmrc não define optional=false. Depois reinstale. O binário nativo é entregue apenas como uma dependência opcional, então não há fallback JavaScript se for ignorado.
Plataforma não suportada. Binários pré-compilados são publicados para darwin-arm64, darwin-x64, linux-x64, linux-arm64, linux-x64-musl, linux-arm64-musl, win32-x64 e win32-arm64. Claude Code não envia um binário para outras plataformas; consulte os system requirements.
Espelho npm corporativo está faltando os pacotes de plataforma. Certifique-se de que seu registro espelha todos os oito pacotes @anthropic-ai/claude-code-* de plataforma além do pacote meta.

Instalar com --ignore-scripts não dispara este erro. A etapa de pós-instalação que vincula o binário no lugar é ignorada, então Claude Code volta a um wrapper que localiza e gera o binário de plataforma em cada inicialização. Isso funciona mas inicia mais lentamente; reinstale com scripts habilitados para execução direta. Estas seções abordam falhas de login, erros OAuth e problemas de token. Quando o login falha e a causa não é óbvia, uma re-autenticação limpa resolve a maioria dos casos:

Execute /logout para sair completamente
Feche Claude Code
Reinicie com claude e complete o processo de autenticação novamente

Se o navegador não abrir automaticamente durante o login, pressione c para copiar a URL OAuth para sua área de transferência e depois cole-a em um navegador manualmente. Isso também funciona quando a URL se estende por várias linhas em um terminal estreito ou SSH e não pode ser clicada diretamente.

OAuth error: Invalid code

Se você vir OAuth error: Invalid code. Please make sure the full code was copied, o código de login expirou ou foi truncado durante cópia e cola. Soluções:

Pressione Enter para tentar novamente e complete o login rapidamente após o navegador abrir
Digite c para copiar a URL completa se o navegador não abrir automaticamente
Se usar uma sessão remota/SSH, o navegador pode abrir na máquina errada. Copie a URL exibida no terminal e abra-a em seu navegador local em vez disso.

Se você vir API Error: 403 {"error":{"type":"forbidden","message":"Request not allowed"}} após fazer login:

Usuários Claude Pro/Max: verifique se sua assinatura está ativa em claude.ai/settings
Usuários do Anthropic Console: confirme que sua conta tem a função “Claude Code” ou “Developer”. Os administradores atribuem isso no Anthropic Console em Settings → Members.
Atrás de um proxy: proxies corporativos podem interferir com solicitações de API. Consulte network configuration para configuração de proxy.

This organization has been disabled with an active subscription

Se você vir API Error: 400 ... "This organization has been disabled" apesar de ter uma assinatura Claude ativa, uma variável de ambiente ANTHROPIC_API_KEY está substituindo sua assinatura. Isso comumente acontece quando uma chave de API antiga de um empregador anterior ou projeto ainda está definida em seu perfil de shell. Quando ANTHROPIC_API_KEY está presente e você a aprovou, Claude Code usa essa chave em vez das credenciais OAuth da sua assinatura. Em modo não interativo com a flag -p, a chave é sempre usada quando presente. Consulte authentication precedence para a ordem de resolução completa. Para usar sua assinatura em vez disso, desdefina a variável de ambiente e remova-a do seu perfil de shell:

unset ANTHROPIC_API_KEY
claude

Verifique ~/.zshrc, ~/.bashrc ou ~/.profile para linhas export ANTHROPIC_API_KEY=... e remova-as para tornar a alteração permanente. No Windows, verifique seu perfil PowerShell em $PROFILE e suas variáveis de ambiente do usuário para ANTHROPIC_API_KEY. Execute /status dentro do Claude Code para confirmar qual método de autenticação está ativo. Quando Claude Code é executado em WSL2, em uma máquina remota via SSH ou dentro de um container, o navegador geralmente abre em um host diferente e seu redirecionamento não consegue alcançar o servidor de callback local do Claude Code. Depois que você faz login, o navegador mostra um código de login em vez de redirecionar automaticamente. Cole esse código no terminal no prompt Paste code here if prompted para completar o login. Se o navegador não abrir nada do WSL2, defina a variável de ambiente BROWSER para o caminho do seu navegador do Windows:

export BROWSER="/mnt/c/Program Files/Google/Chrome/Application/chrome.exe"
claude

Alternativamente, pressione c no prompt de login interativo para copiar a URL OAuth, ou copie a URL que claude auth login imprime, e abra-a em um navegador em sua máquina local. Se colar o código no prompt interativo não fizer nada, o atalho de cola do seu terminal provavelmente não está alcançando o campo de entrada. Tente o atalho de cola alternativo do seu terminal, frequentemente clique direito ou Shift+Insert no Windows Terminal, ou use claude auth login em vez disso, que lê o código colado da entrada padrão:

claude auth login

Este fallback também se aplica no Windows nativo ou qualquer terminal onde colar no prompt interativo falha.

Not logged in or token expired

Se Claude Code solicitar que você faça login novamente após uma sessão, seu token OAuth pode ter expirado. Execute /login para re-autenticar. Se isso acontecer frequentemente, verifique se seu relógio do sistema está preciso, pois a validação de token depende de timestamps corretos. No macOS, o login também pode falhar quando o Keychain está bloqueado ou sua senha está fora de sincronização com sua senha de conta, o que impede Claude Code de salvar credenciais. Execute claude doctor para verificar o acesso ao Keychain. Para desbloquear o Keychain manualmente, execute security unlock-keychain ~/Library/Keychains/login.keychain-db. Se desbloquear não ajudar, abra Keychain Access, selecione o keychain login e escolha Edit > Change Password for Keychain “login” para ressincronizá-lo com sua senha de conta.

Bedrock, Vertex, or Foundry credentials not loading

Se você configurou Claude Code para usar um provedor de nuvem e vê Could not load credentials from any providers no Bedrock, Could not load the default credentials no Vertex, ou ChainedTokenCredential authentication failed no Foundry, seu CLI do provedor de nuvem provavelmente não está autenticado no shell atual. Para Bedrock, confirme que suas credenciais AWS são válidas:

aws sts get-caller-identity

Para Vertex AI, confirme que ANTHROPIC_VERTEX_PROJECT_ID e CLOUD_ML_REGION estão definidos em seu shell, depois defina credenciais padrão de aplicativo:

gcloud auth application-default login

Para Microsoft Foundry, confirme que ANTHROPIC_FOUNDRY_API_KEY está definido, ou faça login com a CLI do Azure para que a cadeia de credenciais padrão possa encontrar sua conta:

az login

Se as credenciais funcionam em seu terminal mas não na extensão VS Code ou JetBrains, o processo IDE provavelmente não herdou seu ambiente de shell. Defina as variáveis de ambiente do provedor nas configurações do próprio IDE, ou inicie o IDE a partir de um terminal onde elas já estão exportadas. Consulte Amazon Bedrock, Google Vertex AI, ou Microsoft Foundry para configuração completa do provedor.

Still stuck

Se nenhum dos itens acima resolver seu problema:

Verifique o GitHub repository para problemas conhecidos, ou abra um novo com seu sistema operacional, o comando de instalação que você executou e a saída de erro completa
Se claude --version funciona mas algo mais está errado, execute claude doctor para um relatório de diagnóstico automatizado
Se você conseguir iniciar uma sessão, use /feedback dentro do Claude Code para relatar o problema

​Encontre seu erro

​Execute verificações de diagnóstico

​Verifique a conectividade de rede

​Verifique seu PATH

​Verifique se há instalações conflitantes

​Verifique permissões de diretório

​Verifique se o binário funciona

​Problemas comuns de instalação

​Install script returns HTML instead of a shell script

​command not found: claude after installation

​curl: (56) Failure writing output to destination

​TLS or SSL connection errors

​Failed to fetch version from downloads.claude.ai

​Wrong install command on Windows

​The process cannot access the file during Windows install

​Install killed on low-memory Linux servers

​Install hangs in Docker

​Claude Desktop overrides the claude command on Windows

​Claude Code on Windows requires either Git for Windows (for bash) or PowerShell

​Claude Code does not support 32-bit Windows

​Linux musl or glibc binary mismatch

​Illegal instruction

​dyld: cannot load on macOS

​Exec format error on WSL1

​npm install errors in WSL

​Permission errors during installation

​Native binary not found after npm install

​Login e autenticação

​Redefinir seu login

​OAuth error: Invalid code

​403 Forbidden after login

​This organization has been disabled with an active subscription

​OAuth login fails in WSL2, SSH, or containers

​Not logged in or token expired

​Bedrock, Vertex, or Foundry credentials not loading

​Still stuck

Encontre seu erro

Execute verificações de diagnóstico

Verifique a conectividade de rede

Verifique seu PATH

Verifique se há instalações conflitantes

Verifique permissões de diretório

Verifique se o binário funciona

Problemas comuns de instalação

Install script returns HTML instead of a shell script

`command not found: claude` after installation

`curl: (56) Failure writing output to destination`

TLS or SSL connection errors

`Failed to fetch version from downloads.claude.ai`

Wrong install command on Windows

`The process cannot access the file` during Windows install

Install killed on low-memory Linux servers

Install hangs in Docker

Claude Desktop overrides the `claude` command on Windows

Claude Code on Windows requires either Git for Windows (for bash) or PowerShell

Claude Code does not support 32-bit Windows

Linux musl or glibc binary mismatch

`Illegal instruction`

`dyld: cannot load` on macOS

`Exec format error` on WSL1

npm install errors in WSL

Permission errors during installation

Native binary not found after npm install

Login e autenticação

Redefinir seu login

OAuth error: Invalid code

403 Forbidden after login

This organization has been disabled with an active subscription

OAuth login fails in WSL2, SSH, or containers

Not logged in or token expired

Bedrock, Vertex, or Foundry credentials not loading

Still stuck