Instalar o Claude Code

Problema: Queres instalar o Claude Code mas não sabes por onde começar. Aqui está o caminho mais curto do zero a um terminal de IA a funcionar.

Como Instalar o Claude Code: Início Rápido

A Anthropic disponibiliza agora instaladores nativos como método recomendado. Sem Node.js necessário:

Windows PowerShell (Recomendado):

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

macOS / Linux:

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

Homebrew (macOS/Linux):

brew install --cask claude-code

Corre claude --version para confirmar. Sucesso é assim: um número de versão aparece sem erros.

Passo a Passo: Instalar o Claude Code em Qualquer Plataforma

Antes de instalar o Claude Code, verifica que tens:

1. Acesso ao terminal (Command Prompt, PowerShell ou Bash)
2. Uma API key da Anthropic em console.anthropic.com
3. Node.js 18+ (apenas se planeias instalar via npm)

Instalar o Claude Code no Windows

O Windows suporta vários caminhos de instalação. Escolhe o que encaixa no teu fluxo de trabalho:

Opção 1: Nativo Windows (Recomendado)

# PowerShell (Corre como Administrador)
irm https://claude.ai/install.ps1 | iex
claude --version

Opção 2: Git Bash

Instala o Git para Windows, depois:

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

Opção 3: WSL (Ubuntu)

# Instala o WSL se necessário (PowerShell como Administrador)
wsl --install -d Ubuntu
 
# Dentro do terminal Ubuntu
curl -fsSL https://claude.ai/install.sh | bash
claude --version

Utilizadores Windows: o instalador nativo já não precisa de Node.js. No WSL, corre o Claude Code a partir do teu terminal Linux.

Instalar o Claude Code no macOS

Opção 1: Homebrew (Recomendado)

brew install --cask claude-code
claude --version

Opção 2: Instalador Nativo

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

Opção 3: npm (se preferes Node.js)

npm install -g @anthropic-ai/claude-code
 
# Se vês "command not found", corrige o PATH:
echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
claude --version

Instalar o Claude Code no Linux

Opção 1: Instalador Nativo (Recomendado)

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

Opção 2: Homebrew

brew install --cask claude-code
claude --version

Opção 3: npm (requer Node.js 18+)

# Cria diretório npm do utilizador (evita necessidade de sudo)
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
 
# Instala o Claude Code
npm install -g @anthropic-ai/claude-code
claude --version

Configurar a API Key

Depois de a instalação ter sucesso, configura a autenticação:

claude
# Cola a tua API key quando pedido

Obtém a tua API key: abre console.anthropic.com, cria uma conta, vai a API Keys e gera uma nova chave que começa com sk-.

Verificar a Instalação

Testa a tua configuração do Claude Code:

claude --version    # Mostra o número de versão
claude doctor       # Corre diagnósticos

Teste rápido de funcionalidade:

mkdir test-project && cd test-project
echo "console.log('Hello!');" > test.js
claude

No prompt do Claude: "Read test.js and explain it"

Sucesso: o Claude lê o ficheiro e explica o JavaScript.

Erros Comuns ao Instalar o Claude Code

Erro: "Command Not Found"

Causa: configuração do PATH está em falta após a instalação

Solução:

which claude    # Verifica se está instalado
npm list -g @anthropic-ai/claude-code
 
# Adiciona ao PATH manualmente
echo 'export PATH="$PATH:/usr/local/lib/node_modules/@anthropic-ai/claude-code/bin"' >> ~/.bashrc
source ~/.bashrc

Erro: "EBADPLATFORM"

Causa: o npm install correu numa configuração de plataforma não suportada

Solução: usa o instalador nativo em vez do npm:

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

Erro: "EACCES Permission Denied"

Causa: o npm quer sudo (não é um hábito seguro)

Solução: configura um diretório npm ao nível do utilizador (ver a secção Linux acima). Funciona em todas as plataformas.

Reset Nuclear (Resolve 95% dos Problemas)

Quando nada mais funciona, faz reset de tudo:

npm uninstall -g @anthropic-ai/claude-code
rm -rf ~/.claude ~/.npm/_cacache
npm cache clean --force
npm install -g @anthropic-ai/claude-code
claude --version

O Que Fazer Depois de Instalar o Claude Code

Quando claude --version responde corretamente:

1. Cria o teu primeiro projeto: Guia do Primeiro Projeto
2. Aprende a interface: O que é o Claude Code
3. Configura as definições: Configuração Básica
4. Resolve problemas comuns: Guia de Troubleshooting
5. Vê exemplos reais: Exemplos e Templates

Dica pro: corre claude doctor sempre que algo parecer errado. Deteta automaticamente a maioria dos problemas de configuração e sugere correções.