Como instalar o Claude Code: guia passo-a-passo para iniciantes

O que precisa antes de instalar

Antes de instalar o Claude Code, confirme que tem tudo o que é necessário. A lista é curta, mas cada ponto é importante:

• Node.js versão 18 ou superior. O Node.js é um ambiente de execução JavaScript que o Claude Code precisa para funcionar. Verifique se já o tem com o comando node --version no terminal. Se aparecer um número abaixo de 18, ou se o comando não for reconhecido, vá a nodejs.org e instale a versão LTS. É gratuito e o instalador faz tudo automaticamente.
• npm disponível. O npm é o gestor de pacotes do Node.js e vem incluído na instalação. Verifique com npm --version. Se aparecer um número, está tudo bem.
• Uma conta Anthropic com plano ativo. Precisa de uma conta em anthropic.com com um plano Claude (Pro ou Max) ou com créditos de API carregados. Sem isso, pode instalar o Claude Code, mas não consegue usá-lo. Se não sabe qual opção escolher, leia o nosso artigo Quanto custa o Claude Code antes de continuar.

Com estes três pontos confirmados, está pronto para instalar.

Instalar o Claude Code via npm

Com o Node.js instalado, abra o terminal. No Windows pode usar o PowerShell ou o Prompt de Comandos. No Mac ou Linux, use a aplicação Terminal.

Escreva o seguinte comando e prima Enter:

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

A flag -g significa instalação global. Isso quer dizer que o Claude Code fica disponível em todo o sistema e pode iniciá-lo a partir de qualquer pasta, sem ter de navegar para um diretório específico primeiro. A instalação demora menos de um minuto na maioria das ligações à internet.

Para confirmar que a instalação correu bem, escreva:

claude --version

Se aparecer um número de versão no ecrã, está instalado com sucesso. Pode prosseguir para a autenticação. Se aparecer uma mensagem de erro, consulte a secção de problemas comuns no final deste artigo.

Outras formas de instalar

O npm é o método mais universal e recomendado, mas existem alternativas caso prefira:

• Instalador oficial da Anthropic: A Anthropic disponibiliza um instalador direto na sua documentação oficial em anthropic.com. É uma boa opção se preferir não usar a linha de comandos para este passo inicial. O instalador deteta o seu sistema operativo e configura tudo automaticamente.
• Atualizar em vez de reinstalar: Quando saírem novas versões do Claude Code, não precisa de reinstalar. Basta correr npm update -g @anthropic-ai/claude-code e tem a versão mais recente em segundos.

Qualquer que seja o método escolhido, o resultado é o mesmo: o comando claude fica disponível no seu terminal.

Primeiro arranque e autenticação

Na primeira vez que correr o Claude Code, ele vai pedir que faça login na sua conta Anthropic. O processo é simples e acontece apenas uma vez:

1. Navegue até à pasta onde quer trabalhar. Por exemplo: cd documentos/meu-projeto
2. Escreva claude no terminal e prima Enter.
3. O Claude Code gera um link de autenticação. Copie-o ou deixe-o abrir automaticamente no browser.
4. Faça login com os dados da sua conta Anthropic. Após a confirmação, volte ao terminal.
5. O Claude Code mostra uma mensagem de boas-vindas e está pronto a usar.

A partir daqui, pode começar a dar instruções em linguagem natural. Escreva, por exemplo, "explica o que este ficheiro faz" ou "cria um script que lista todos os ficheiros desta pasta com mais de 1MB" e veja o que acontece.

Alguns comandos úteis para começar: /help mostra o que está disponível, /clear limpa o histórico da conversa e /compact liberta memória em sessões longas sem perder o contexto essencial.

Resolver problemas comuns

Se alguma coisa não correr como esperado, esta tabela cobre os casos mais frequentes:

Se ficar preso num passo específico, a página do Claude Code no Doutor AI tem recursos de apoio adicionais e links para a documentação oficial.