Como corrigir a instalação do Claude Code no Windows, macOS e Linux

Vibe Coding Rescue · 2026-07-22 · Configuração e contas
Última revisão 2026-07-22Abrange Claude CodeFontes oficiais 2

Se npm install -g @anthropic-ai/claude-code falhar — ou se a instalação terminar, mas o shell não encontrar claude — a correção depende da mensagem exata. Em problemas relacionados ao npm, migrar para o instalador nativo costuma ser o caminho mais rápido.

Comece com o instalador nativo

A Anthropic agora recomenda seu script de instalação nativo. Ele não exige Node.js.

No macOS, Linux ou WSL:


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

No PowerShell do Windows:


irm https://claude.ai/install.ps1 | iex

Se você abriu o Prompt de Comando, use o instalador específico para CMD em vez do comando do PowerShell:


curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Se você vir EBADENGINE

A partir do pacote npm v2.1.198, o Claude Code exige Node.js 22 ou posterior. A Anthropic informa que uma versão antiga do Node pode exibir apenas um aviso EBADENGINE mesmo quando a instalação é concluída, pois o executável instalado é um binário nativo e não depende do Node.js em tempo de execução.

Execute claude --version primeiro. Se ele imprimir uma versão, o Claude Code está instalado. Se não, verifique node -v e atualize para Node.js 22 ou superior, ou mude para o instalador nativo acima.

Se você vir EACCES: permission denied

Sua conta não tem permissão para escrever no diretório global do npm. Não tente contornar isso com sudo npm install -g; a Anthropic aconselha explicitamente contra isso. Use o instalador nativo em vez disso.

Se a instalação nativa encontrar o mesmo erro de permissão, restaure a propriedade de ~/.local para sua conta atual e tente novamente:


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

Se o comando de instalação do Windows falhar

O Claude Code funciona nativamente no Windows 10 versão 1809 ou posterior e no Windows Server 2019 ou posterior. Não é necessário ter acesso de administrador nem usar o WSL.

Se optar pelo WSL, execute o comando curl do macOS/Linux dentro do terminal do WSL. No Windows nativo, o Git for Windows é opcional: quando ele está instalado, o Claude Code pode usar ferramentas Bash; caso contrário, usa ferramentas do PowerShell.

Se o Claude Code foi instalado, mas o comando está ausente

O executável nativo está instalado em ~/.local/bin/claude no macOS e Linux, e em %USERPROFILE%\.local\bin\claude.exe no Windows. Uma mensagem de command not found ou 'não reconhecido' geralmente significa que o diretório não está na variável PATH.

Para o zsh padrão no macOS:


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

No bash do Linux ou WSL, adicione a mesma linha ao ~/.bashrc. No Windows, feche todas as janelas de terminal e abra uma nova. Se claude ainda não for encontrado, adicione %USERPROFILE%\.local\bin ao PATH do usuário e abra outro terminal.

Se você receber 403 ou Failed to fetch version

Esses erros costumam aparecer quando um proxy corporativo ou firewall bloqueia downloads.claude.ai. Um 403 também pode indicar que o Claude não está disponível no país ou na região de onde vem sua conexão; se estiver usando VPN, confira a localização do nó de saída.

Em uma rede corporativa, peça o endereço do proxy à equipe de TI e defina as variáveis de ambiente correspondentes:


export HTTP_PROXY=http://proxy.example.com:8080
export HTTPS_PROXY=http://proxy.example.com:8080

Tentar a instalação por outra conexão, como um hotspot de celular, é uma forma rápida de separar um bloqueio de rede de um problema específico da máquina.

Execute claude doctor para verificar a instalação e a configuração. Se as versões npm e nativa estiverem presentes ao mesmo tempo, compare ls ~/.local/bin/claude com npm ls -g @anthropic-ai/claude-code e mantenha apenas uma instalação. A Anthropic recomenda a versão nativa.

Se a instalação funcionar, mas o login não, verifique a conta também. O Claude Code exige uma conta Pro, Max, Team, Enterprise ou API Console; não está disponível no plano gratuito do Claude.ai. Para um erro que ainda não se resolve, consulte a mensagem exata no guia de solução de problemas da instalação da Anthropic.

Referências oficiais