Instalador Nativo do Claude Code

Problema: o antigo caminho de instalação via npm precisava do Node.js 18+, causava problemas de PATH e quebrava em algumas plataformas. O instalador nativo resolve tudo isso com um único comando que funciona em todo lugar.

Início Rápido: Instalação com Um Comando

Windows PowerShell:

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

macOS / Linux / WSL:

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

Homebrew (macOS/Linux):

brew install --cask claude-code

É só isso. Sem Node.js. Sem npm. Sem configuração de PATH. Execute claude --version para confirmar.

Por Que o Instalador Nativo É Melhor

A Anthropic agora distribui o instalador nativo como o método de instalação recomendado para todos os utilizadores do Claude Code. Veja a comparação:

O instalador nativo cuida de tudo por você: descarrega o binário certo para o teu sistema, configura o PATH e mantém o Claude Code atualizado em segundo plano.

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

O comando PowerShell irm https://claude.ai/install.ps1 | iex faz três coisas:

1. irm (Invoke-RestMethod) descarrega o script de instalação da Anthropic
2. | redireciona o conteúdo do script para o próximo comando
3. iex (Invoke-Expression) executa o script descarregado

Execute como Administrador para uma instalação mais limpa:

# Abra o PowerShell como Administrador, depois:
irm https://claude.ai/install.ps1 | iex
 
# Verificar instalação
claude --version

Alternativa para utilizadores do CMD:

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

Opção WinGet:

winget install Anthropic.ClaudeCode

Atenção: o WinGet não faz atualizações automáticas. O instalador nativo é a melhor escolha.

macOS e Linux: curl https://claude.ai/install.sh | bash

O instalador bash funciona da mesma forma no macOS, Linux e WSL:

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

As opções -fsSL significam:

• f: Falha silenciosa em erros HTTP
• s: Modo silencioso (sem barra de progresso)
• S: Mostra erros se ocorrerem
• L: Segue redirecionamentos

Verificar e iniciar:

claude --version
cd your-project
claude

Resolução de Problemas

"irm is not recognized" (Windows)

Você está no CMD, não no PowerShell. Abre o PowerShell e executa o comando lá.

Erro de "Execution policy" (Windows)

O PowerShell pode bloquear scripts por padrão:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
irm https://claude.ai/install.ps1 | iex

"command not found" após a instalação

Fecha e reabre o terminal para recarregar o PATH, depois tenta claude --version novamente.

Já tem a versão npm instalada?

Desinstala primeiro a versão npm:

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

Depois executa o instalador nativo.

O Que Acontece Após a Instalação

Quando o Claude Code estiver instalado:

1. Executa claude em qualquer diretório de projeto
2. Completa a autenticação única com a tua conta Anthropic
3. Começa a programar com IA

Novo no Claude Code? Segue o tutorial do primeiro projeto para ver em ação. Queres mais opções de instalação? Consulta o guia de instalação completo.

O instalador nativo foi anunciado em outubro de 2025 como o método recomendado pela Anthropic. Mais simples, mais estável, e mantém-te atualizado automaticamente. Sem Node.js necessário.