Como instalar o Claude Code: passo a passo para começar do zero

Decidiu que vai usar o Claude Code e quer só colocar pra funcionar? Bora, esse post é isso do zero até o primeiro login rodando

O Claude Code é o assistente de código da Anthropic que vive direto no seu terminal, sem IDE no meio do caminho

Aqui tu vai ver os pré-requisitos, o comando certo pra cada sistema, o primeiro uso e os erros mais comuns que travam gente na hora de instalar

Pré-requisitos: o que você precisa antes de instalar

Antes de sair rodando comando, se liga no que a máquina precisa ter

Os requisitos oficiais de sistema são:

• macOS 10.15 ou superior
• Linux: Ubuntu 20.04+ ou Debian 10+
• Windows 10 ou superior, com WSL 1, WSL 2 ou Git para Windows
• 4GB+ de RAM
• Conexão com a internet pra fazer a autenticação

E o Node.js? Ele só entra em cena se tu for pela via npm, porque o instalador nativo (que é o recomendado) não depende do Node pra funcionar

Se for pelo npm, se liga: a partir da versão v2.1.198 o pacote exige Node.js 22 ou superior

Nada de PC da Nasa aqui, é bem tranquilo 😀

Agora o pré-requisito que mais pega gente de surpresa: instalar é de graça, mas usar o Claude Code exige um plano pago da Claude

Vale plano Pro, Max, Team ou Enterprise, ou então uma chave de API do Console

O plano gratuito do Claude.ai NÃO libera acesso ao Claude Code, então não adianta tentar entrar com a conta free

Guarda isso na cabeça, porque instalar vai funcionar liso, o gargalo aparece só na hora de autenticar

Passo a passo para instalar o Claude Code

Agora a parte prática, beleza? Bora ver na prática 😀

1. Instale pelo instalador nativo (método recomendado)

A própria Anthropic recomenda o instalador nativo

Ele roda como um binário nativo, não depende do Node.js pra funcionar e se atualiza sozinho em segundo plano, então tu não precisa ficar rodando update na mão

No macOS, Linux ou WSL, cola isso no terminal:

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

No Windows via PowerShell, o comando é esse:

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

O erro comum deste passo: rodar o comando do PowerShell dentro do WSL (ou o contrário). Confere em qual ambiente tu está antes de colar, porque o script é diferente pra cada um

2. Ou instale pela via npm (alternativa)

Se tu prefere ir pelo caminho do Node, dá pra instalar o pacote oficial pelo npm:

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

O erro comum deste passo: usar sudo

NÃO rode sudo npm install -g, isso é a principal causa de erros de permissão (EACCES) e ainda é risco de segurança

Outro ponto: a partir da versão v2.1.198, o pacote npm exige Node.js 22 ou superior

Se teu Node for mais antigo vai aparecer o aviso EBADENGINE, mas calma, o install conclui e o claude roda mesmo assim, porque ele baixa um binário nativo por baixo

3. Rode pela primeira vez e autentique

Instalado, é só digitar no terminal:

claude

Ele abre o navegador pra você fazer login

Tu entra com a tua assinatura paga da Claude (Pro, Max, Team ou Enterprise) pela conta Claude.ai, ou com as credenciais do Claude Console

Depois de autenticar, o token fica guardado localmente na pasta ~/.claude/, então tu não precisa logar toda hora

O erro comum deste passo: tentar entrar com a conta gratuita

Como já falei lá em cima, sem plano pago ou chave de API o login não completa o acesso

Problemas comuns na instalação e como resolver

Três tropeços aparecem sempre, e todos têm solução rápida

Erro de permissão (EACCES) no npm

A causa quase sempre é a mesma: alguém rodou npm install -g com sudo

A prevenção é justamente não usar sudo no install global

Se já bateu de frente com esse erro, o caminho mais limpo é migrar pro instalador nativo, que nem depende dessa permissão global

Aviso EBADENGINE por Node antigo

Esse aqui assusta mas não é bug

Quando teu Node é mais velho que o exigido pelo pacote npm (a partir da v2.1.198 ele quer o Node 22+), aparece o EBADENGINE

Mesmo assim o install conclui e o claude funciona, porque ele baixa o binário nativo por conta própria

Migrar do npm pro binário nativo

Instalou pelo npm e quer o instalador nativo com auto-atualização? Dá pra migrar sem reinstalar tudo do zero

De dentro do próprio Claude Code, roda:

/migrate-installer

Ele troca a instalação npm pelo binário nativo por dentro do produto, sem drama

Se quiser um segundo ângulo do processo, o guia completo para iniciantes cobre a instalação com mais calma

Conclusão

Instalar o Claude Code é a parte fácil: um comando por sistema e tu já tem o binário rodando

O gargalo real não é técnico, é ter o plano pago ou a chave de API em mãos, porque sem isso o login trava na autenticação

Resolvido isso, o próximo passo é só digitar claude no terminal e começar a usar

E quando pegar o jeito, vale conhecer o modo de planejar antes de executar pra ele pensar na mudança antes de mexer no teu código

até o próximo post! 😀