Tutorial da Série Claude Code 5: Como Instalar o Claude Code?

Como Instalar o Claude Code

A instalação do Claude Code não tem um "próximo" em uma interface gráfica; tudo é feito na linha de comando. Se você costuma usar npm, todo o processo não leva mais de dois minutos.

Pré-requisitos

Antes de começar, certifique-se de ter o seguinte:

Node.js 18 ou superior
Verifique com: node -v no terminal. Se a versão for inferior a 18, atualize usando nvm, fnm ou diretamente em nodejs.org.
Uma conta Anthropic
Registre-se em https://console.anthropic.com. A conta fornecerá uma chave de API necessária após a instalação. O registro é gratuito e os custos reais são baseados no uso.
Rede com acesso ao endpoint da API Anthropic
O domínio padrão é api.anthropic.com. Se o ambiente precisar de proxy, defina HTTP_PROXY ou HTTPS_PROXY no terminal.

Método de Instalação 1: Instalação Global via npm

Esta é a maneira mais comum: instala uma vez e usa em qualquer lugar.

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

Após a conclusão, execute claude --version. Se aparecer um número de versão, a instalação foi bem-sucedida. Com a instalação global, o comando claude pode ser chamado diretamente de qualquer diretório.

Se ocorrer um erro de permissão (comum no diretório /usr/local/lib no macOS), existem duas opções:

Use sudo para instalar (prático, mas com controvérsias de segurança).
Configure o npm para usar o diretório do usuário, evitando sudo:
bash mkdir -p ~/.npm-global npm config set prefix '~/.npm-global'
Depois, adicione ~/.npm-global/bin ao PATH e reinicie o terminal.

Método de Instalação 2: Usar npx (sob demanda)

Se você não quer instalar nada globalmente ou apenas quer testar temporariamente, usar npx é mais direto.

npx @anthropic-ai/claude-code

O npx baixa temporariamente o pacote mais recente e o executa, sem deixar comandos globais. Cada uso verifica atualizações, então fica sempre na versão mais recente. A desvantagem é ser um pouco mais lento (precisa baixar toda vez) e não é adequado para scripts automatizados com chamadas frequentes.

Cenários ideais: primeira experiência, uso temporário em máquinas de terceiros, ou uso ocasional.

Verificar se a Inicialização Funciona

Após a instalação, não se apresse em autenticar. Execute um comando simples para ver se a ferramenta inicia:

claude --help

Se aparecer a mensagem de ajuda, o binário está funcionando. O próximo passo é conectar sua conta, o que será abordado posteriormente.

O corpo dos dois métodos de instalação é o mesmo; a autenticação e o uso subsequentes são idênticos. Escolha o que achar mais conveniente.

Perguntas Frequentes

Versão do Node muito baixa
Abaixo de 18 causará erro direto, não apenas um aviso. Atualizar o Node é a solução mais direta.
Tempo limite de rede
Tanto ao baixar pacotes npm quanto ao conectar à API, pode haver bloqueio por proxy ou firewall. Primeiro, verifique se curl https://api.anthropic.com funciona antes de prosseguir.
Usando cmd nativo no Windows
Embora teoricamente possível, é recomendado usar Git Bash, WSL2 ou Windows Terminal para evitar problemas estranhos de escape de caminhos.