# Como instalar o Claude Code: guia passo-a-passo para iniciantes > Instale o Claude Code em menos de cinco minutos com este guia completo, do Node.js até à primeira sessão no terminal. - Fonte: https://doutorai.pt/blog/como-instalar-claude-code - Autor: Miguel Diamond (https://doutorai.pt/autor/miguel) - Categoria: Claude Code - Publicado: 29 jun 2026 - Site: Doutor AI - a maior biblioteca portuguesa de ferramentas de IA para pequenos negócios (https://doutorai.pt) ## Resposta rápida Instalar o Claude Code é simples e demora menos de cinco minutos. O método mais direto é através do npm, com o comando npm install -g @anthropic-ai/claude-code. Antes de começar, precisa de ter o Node.js instalado no computador e uma conta Anthropic com um plano ativo ou créditos de API disponíveis. - Instala via npm com um único comando no terminal - Requer Node.js versão 18 ou superior instalado primeiro - Funciona em Windows, Mac e Linux sem configuração adicional - Na primeira utilização autentica com a sua conta Anthropic no browser ## 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](https://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](https://doutorai.pt/blog/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: - Navegue até à pasta onde quer trabalhar. Por exemplo: cd documentos/meu-projeto - Escreva claude no terminal e prima Enter. - O Claude Code gera um link de autenticação. Copie-o ou deixe-o abrir automaticamente no browser. - Faça login com os dados da sua conta Anthropic. Após a confirmação, volte ao terminal. - 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: ProblemaSolução provável "command not found: claude" após instalaçãoFeche e reabra o terminal, depois tente de novo. Se persistir, reinstale com npm install -g @anthropic-ai/claude-code Erro de permissões no Mac ou LinuxCorra sudo npm install -g @anthropic-ai/claude-code e introduza a palavra-passe do sistema quando pedida Node.js não encontrado ou versão abaixo de 18Instale ou atualize o Node.js em nodejs.org. Escolha sempre a versão LTS Login não funciona ou retorna erroConfirme que tem um plano ativo ou créditos disponíveis em anthropic.com antes de tentar novamente Instalação muito lenta ou a parar a meioVerifique a ligação à internet e tente novamente. Em redes lentas, pode adicionar --prefer-offline se já teve uma instalação anterior Se ficar preso num passo específico, a [página do Claude Code no Doutor AI](https://doutorai.pt/claude-code) tem recursos de apoio adicionais e links para a documentação oficial. ## Perguntas frequentes ### Qual é a versão mínima do Node.js para instalar o Claude Code? Recomenda-se a versão 18 ou superior do Node.js. Pode verificar qual tem instalada com o comando node --version no terminal. Se precisar de atualizar, vá a nodejs.org e instale a versão LTS, que é gratuita. ### Posso instalar o Claude Code sem conta Anthropic? Pode instalar o software, mas não consegue utilizá-lo sem autenticação. O Claude Code precisa de uma conta Anthropic ativa com um plano ou créditos de API para funcionar. ### O que fazer se aparecer um erro de permissões ao instalar? Em Mac ou Linux, experimente correr o comando com sudo: sudo npm install -g @anthropic-ai/claude-code. No Windows, abra o PowerShell como administrador antes de correr o comando de instalação. ### Como atualizo o Claude Code para a versão mais recente? Corra npm update -g @anthropic-ai/claude-code no terminal. Este comando atualiza para a versão mais recente disponível sem precisar de reinstalar do zero. ### O Claude Code funciona sem ligação à internet? Não. O Claude Code precisa de ligação à internet para comunicar com os servidores da Anthropic onde o modelo de IA corre. Os seus ficheiros locais são acedidos diretamente, mas o processamento acontece na cloud. --- Conteúdo de Doutor AI (https://doutorai.pt). Ao citar, indique a fonte: https://doutorai.pt/blog/como-instalar-claude-code