Como Instalar Claude Code: Passo a Passo 2026

Como instalar o Claude Code?

Para instalar o Claude Code, abra o terminal do seu computador e rode o comando do instalador oficial indicado na documentação da Anthropic, ou instale pelo npm com o Node.js 18 ou superior. Depois, digite claude dentro de uma pasta de projeto e faça login com uma conta paga do Claude ou com créditos de API.

O processo funciona em Windows, macOS e Linux, e a lógica é a mesma nos três: preparar os pré-requisitos, rodar um único comando de instalação, confirmar que o terminal reconhece a ferramenta e autenticar. Em condições normais, a instalação leva poucos minutos. Se algum passo falhar, a mensagem de erro do terminal quase sempre indica qual pré-requisito está faltando, e a seção de erros comuns deste guia cobre os casos mais frequentes.

O Claude Code é a ferramenta de linha de comando da Anthropic que lê, cria e edita os arquivos de um projeto a partir de instruções em português. Instalar é a parte fácil; a habilidade que realmente faz diferença vem depois, quando você aprende a descrever com clareza o que quer construir.

• Sistema: Windows, macOS ou Linux, com acesso a um terminal.
• Conta: assinatura paga do Claude (como Pro ou Max) ou conta na Console da Anthropic com créditos de API.
• Instalação: instalador oficial de uma linha ou npm, que exige Node.js 18 ou superior.
• No Windows: o Git for Windows precisa estar instalado para a rota nativa; o WSL é uma alternativa.

Pré-requisitos antes de instalar

A maior parte das instalações que travam falha antes mesmo do comando principal, por falta de algum pré-requisito. Conferir cada item antes de começar economiza tempo e evita mensagens de erro difíceis de interpretar para quem está abrindo o terminal pela primeira vez. Reserve alguns minutos para essa conferência: ela é a etapa que mais poupa tempo em todo o processo de instalação.

O ponto que mais gera dúvida é a conta. O Claude Code precisa de uma assinatura paga do Claude ou de créditos de API para processar as instruções. Sem isso, a ferramenta até abre, mas não executa trabalho de verdade. Planos e preços mudam com frequência, então confira as opções atuais diretamente no site da Anthropic.

• Terminal: PowerShell no Windows, Terminal em macOS, ou o terminal da sua distribuição Linux.
• Node.js 18 ou superior, apenas se você for instalar pelo npm; confira com node --version.
• Git for Windows, se você usa Windows e vai instalar de forma nativa.
• Conta Anthropic ativa, com plano pago do Claude ou créditos de API.
• Permissão para instalar programas, especialmente em computadores corporativos com política de TI.

Passo a passo de instalação por sistema operacional

A Anthropic mantém um instalador oficial de uma linha para cada sistema e também a opção de instalar pelo npm. As duas rotas chegam ao mesmo resultado. O instalador oficial dispensa o Node.js e é o caminho mais direto; o npm é útil para quem já trabalha com JavaScript e prefere gerenciar ferramentas por ele.

Como os comandos podem mudar entre versões, copie sempre o comando atual da documentação oficial do Claude Code. Os passos abaixo mostram a sequência que vale para qualquer sistema, com os cuidados específicos de cada um. Se o seu computador for corporativo, verifique antes se você tem permissão para instalar programas e rodar scripts no terminal, porque políticas de TI podem bloquear a instalação sem uma mensagem clara.

• Windows nativo: instale o Git for Windows, abra o PowerShell e rode o comando de instalação para Windows da documentação oficial.
• Windows com WSL: rode wsl --install no PowerShell como administrador, abra o Ubuntu e use o comando para Linux.
• macOS: abra o Terminal e rode o comando de instalação para macOS da documentação oficial.
• Linux: abra o terminal e rode o comando de instalação para Linux, sem usar sudo no instalador.
• Via npm, em qualquer sistema: com Node.js 18+, rode npm install -g @anthropic-ai/claude-code.

Instalador oficial ou npm: qual escolher

Para quem está começando, a diferença entre as duas rotas é pequena, mas vale conhecer os critérios. O instalador oficial reduz o número de pré-requisitos e tende a cuidar sozinho das atualizações. O npm faz sentido para quem já tem Node.js configurado e usa o mesmo gerenciador para outras ferramentas.

Se uma rota falhar no seu computador, a outra costuma funcionar. Evite apenas instalar pelas duas ao mesmo tempo, porque o terminal pode passar a encontrar versões diferentes do comando claude e gerar confusão. Se isso acontecer, remova uma das instalações e mantenha apenas a rota que você pretende usar daqui para frente. Rodar claude --version depois ajuda a confirmar qual versão o terminal está encontrando.

• Pré-requisitos — instalador oficial: não exige Node.js; npm: exige Node.js 18 ou superior.
• Atualizações — instalador oficial: tende a se atualizar sozinho; npm: atualização manual pelo próprio npm.
• Para quem é melhor — instalador oficial: iniciantes; npm: quem já trabalha com JavaScript.
• Erro típico — instalador oficial: pasta de instalação fora do PATH; npm: erro de permissão em pacotes globais.

Login e primeiro teste depois de instalar

Com a instalação concluída, feche e reabra o terminal e rode claude --version. Se aparecer um número de versão, a ferramenta está pronta. Em seguida, crie uma pasta vazia para um projeto de teste, entre nela pelo terminal e digite claude. Na primeira execução, a ferramenta pede para você autenticar, normalmente abrindo o navegador.

Para o primeiro teste, peça algo simples e verificável, como a criação de um arquivo README explicando a pasta. Antes de alterar arquivos ou rodar comandos, o Claude Code pede a sua confirmação. Aprovar passo a passo nas primeiras sessões é a melhor forma de entender o que ele faz e de ganhar confiança para pedidos maiores.

• 1. Rode claude --version para confirmar a instalação.
• 2. Crie uma pasta de teste e entre nela com cd.
• 3. Digite claude e conclua o login com a sua conta Anthropic.
• 4. Peça uma tarefa simples e acompanhe cada confirmação antes de aprovar.

Erros comuns de instalação e como resolver

O erro mais frequente depois da instalação é o terminal responder que o comando claude não existe. Na maioria das vezes, basta fechar e reabrir o terminal, porque a instalação atualizou o PATH e a janela antiga não percebeu. Se persistir, a pasta onde o Claude Code foi instalado precisa ser adicionada ao PATH do seu usuário.

Pela rota npm, o problema típico em macOS e Linux é o erro de permissão EACCES. Evite resolver com sudo, porque isso cria outros problemas depois. O caminho limpo é configurar o npm para instalar pacotes globais na sua pasta de usuário ou trocar para o instalador oficial. Em qualquer caso, depois de corrigir, feche e reabra o terminal e confira o resultado com claude --version antes de seguir para o login.

• Comando não encontrado: reabra o terminal e, se necessário, adicione a pasta de instalação ao PATH.
• EACCES no npm: não use sudo; ajuste a pasta global do npm ou use o instalador oficial.
• Node.js antigo: atualize para a versão 18 ou superior antes de instalar pelo npm.
• Falha ao executar comandos no Windows: confira se o Git for Windows está instalado.
• Bloqueio corporativo: antivírus ou política de TI podem impedir a instalação; peça liberação.

O que fazer depois de instalar

Instalar o Claude Code é o começo, não o fim. O próximo passo é aprender a trabalhar com ele em projetos reais: dividir pedidos grandes em etapas, revisar o que foi criado e testar antes de publicar. Projetos pequenos, como uma página simples ou um script que organiza arquivos, são ótimos para praticar.

Com a prática, o Claude Code passa a construir coisas mais complexas, como agentes de WhatsApp, painéis internos e automações publicadas em serviços de nuvem. É esse tipo de entrega que muita gente transforma em serviço para pequenas empresas. O caminho até lá passa por prática constante e por entender o problema de quem vai usar o que você constrói, porque a ferramenta executa bem o que é pedido com clareza.

• Comece com projetos pequenos e verificáveis antes de partir para automações maiores.
• Escreva pedidos com objetivo, contexto e critério de pronto.
• Revise as alterações propostas antes de aprovar, principalmente as que apagam arquivos.
• Guarde o histórico dos projetos em um repositório Git para poder voltar atrás.