Instalando o Claude Code

Chegou a hora de trazer o Claude pra dentro do seu computador. No post passado você entendeu o que o Claude Code faz: lê, edita seus arquivos e roda comandos por você. Agora a gente instala. É um comando só. Respira fundo e vem comigo.

Antes de tudo: confira o Node.js

O Claude Code precisa do Node.js pra funcionar — aquele programa que você instalou lá no post #18. O Node traz junto o npm, que é o instalador de ferramentas que vamos usar agora. Vamos confirmar que ele está vivo antes de seguir.

Abra o terminal (no Mac, o Terminal; no Windows, o Prompt de Comando ou o Git Bash) e rode:

node --version

Esse comando pergunta a versão do Node instalada. Se aparecer um número (algo como v20.11.0), ótimo. Confirme também o npm:

npm --version

Se os dois mostrarem números, você está pronto. Se algum disser "comando não encontrado", volte ao post #18 e instale o Node antes de continuar — sem ele, o resto não funciona.

A ideia: instalar uma ferramenta "global"

Vamos rodar um comando que baixa o Claude Code da internet e o instala no seu computador. A parte mágica é uma palavrinha: global.

Pensa assim: instalar algo "normal" é como deixar uma ferramenta dentro de uma gaveta específica — só serve naquele cômodo. Instalar "global" é como pendurar a ferramenta no corredor: você alcança ela de qualquer cômodo da casa.

Como o Claude Code é algo que você vai querer usar em qualquer pasta de projeto, a gente instala global. No comando, isso é representado por -g.

Passo a passo: o comando de instalação

O comando é o mesmo no Mac, no Windows e no Linux. Digite (ou copie e cole) no terminal e dê Enter:

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

Quebrando em pedaços pra não ficar mágico:

• npm é o instalador que veio com o Node.
• install é a ordem: "instale isto".
• -g é o "global" que a gente falou: disponível em qualquer pasta.
• @anthropic-ai/claude-code é o nome exato do pacote que será baixado.

Vai aparecer um monte de texto correndo na tela. Isso é normal — é o npm baixando e arrumando as peças. Espere parar. Quando o terminal voltar a aceitar o que você digita, terminou.

Um detalhe pra Mac e Linux

Se no Mac ou Linux aparecer um erro de permissão (palavras como "permission denied" ou "EACCES"), o sistema está protegendo uma pasta. Não saia digitando comandos de internet às cegas. O caminho mais seguro pra iniciantes é instalar o Node via um gerenciador de versões (como o nvm), que evita esse problema. Se cair nisso, vale uma busca tranquila ou perguntar ao próprio Claude no app de conversa, descrevendo o erro exato que apareceu.

Conferindo que instalou

Terminada a instalação, confirme que o Claude Code respondeu presente. Rode:

claude --version

Se aparecer um número de versão, está instalado. Pra um diagnóstico mais completo, existe um comando que checa se está tudo nos conformes:

claude doctor

O doctor ("médico", em inglês) faz um check-up da instalação e avisa se algo está faltando. É seu melhor amigo quando algo parece estranho.

Se algo der errado

• "claude: command not found" (comando não encontrado): o tropeço mais comum. Quase sempre é só fechar TODAS as janelas do terminal e abrir uma nova. Ferramentas recém-instaladas só aparecem em terminais abertos depois da instalação. Teste o claude --version de novo na janela nova.
• Erro de permissão no Mac/Linux (EACCES): veja o aviso lá de cima. Não use comandos com "sudo" copiados de qualquer lugar sem entender — isso pode bagunçar seu sistema. Prefira o caminho do gerenciador de versões.
• No Windows, "npm não é reconhecido": isso indica que o Node não foi instalado corretamente. Reinstale pelo post #18, reinicie o computador e tente de novo.

E o aplicativo Claude Desktop?

Talvez você já tenha visto que existe também o Claude Desktop, um app pra instalar no computador, com janela e botões. Ele é ótimo pra conversar. Mas o foco desta série, daqui pra frente, é o terminal — porque é ali que o Claude consegue agir nos seus arquivos e construir junto com você. Então a estrela é o que você acabou de instalar.

No próximo post...

Com o Claude Code instalado, vamos fazer seu primeiro login e abrir sua primeira sessão dentro de uma pasta de projeto. Você vai mandar a primeira frase pra ele e ver, na prática, essa tal de IA que mexe no projeto com você.