O Claude Code roda no terminal do seu computador — aquela janela de texto onde você digita comandos. Você também vai precisar de um plano pago do Claude (Pro ou Max); o plano gratuito não inclui o Claude Code.

A boa notícia: com o instalador oficial, você não precisa instalar o Node.js. É um comando só.

Uma coisa para fazer primeiro se você usa Windows: o Claude Code precisa de uma ferramenta gratuita chamada Git for Windows para funcionar (ele usa em segundo plano — você não vai precisar aprender ou usar o Git, viu?). Se você usa Windows e ainda não tem, instale antes de continuar:

Não tem certeza se tem o Git? Instale de qualquer jeito — reinstalar não causa problema. Usuários de Mac podem pular isso; nada extra é necessário.

Abra o terminal no seu computador. O jeito de fazer isso depende do seu sistema:

Uma janela com uma linha em branco onde você pode digitar vai aparecer. É aqui que todos os comandos abaixo vão entrar.

Copie o comando para o seu sistema, cole no terminal e aperte Enter.

Mac:

Windows 11 (e Windows 10 usando Terminal/PowerShell):

Windows 10 (se você abriu o Prompt de Comando com cmd no Passo 1):

Você vai ver um monte de texto passando enquanto ele roda. Quando terminar, vai aparecer uma mensagem confirmando que o Claude Code foi instalado com sucesso. Se aparecer um erro em vez disso, veja a seção de Troubleshooting no final.

Esse passo é fácil de pular, mas importa. Feche sua janela do terminal completamente e abra uma nova (usando o mesmo método do Passo 1).

O instalador adiciona o Claude Code ao seu sistema, mas seu terminal só nota a mudança quando você inicia uma janela nova. Pular isso é o motivo mais comum para o próximo passo parecer que "não funcionou".

Na sua nova janela do terminal, digite:

Na primeira vez que você rodar, ele vai perguntar como você quer fazer o login. Escolha fazer login com sua conta Claude (não com uma chave de API). Uma janela do navegador vai abrir onde você faz o login na sua conta Claude. Depois de logar, você pode voltar para o terminal — sua assinatura Pro ou Max agora funciona no Claude Code.

É isso. Agora você pode digitar suas perguntas ou pedidos diretamente no terminal.

Os passos de instalação são os mesmos em todos os sistemas, mas se algo der errado, a solução pode variar dependendo do que você está usando. Aqui estão os problemas mais comuns.

Isso quase sempre significa que você pulou o Passo 3. Feche o terminal completamente, abra uma janela novinha e digite claude de novo. O terminal só pega comandos recém-instalados quando você inicia uma sessão nova.

Se o comando irm der um erro como "não é reconhecido como um comando interno ou externo", você está no Prompt de Comando (CMD) em vez do PowerShell. Você pode saber em qual deles está olhando o início da linha: o PowerShell mostra PS C:\... enquanto o Prompt de Comando mostra apenas C:\....

Use a versão do comando para Prompt de Comando em vez disso:

Isso pode acontecer em sistemas Windows 10 mais antigos. No PowerShell, rode a linha abaixo primeiro, depois rode o comando do instalador de novo:

Isso significa que o Git for Windows não está instalado (ou o Claude Code não consegue encontrá-lo). Volte para a seção "Antes de começar" acima e instale o Git for Windows, depois feche seu terminal, abra um novo e rode claude de novo.

Como o instalador oficial coloca o Claude Code em uma pasta sua (dentro do seu próprio diretório principal), os erros de permissão que métodos de instalação mais antigos causavam não acontecem aqui. Se o seu Mac mostrar um pop-up de segurança na primeira vez que você rodar claude dizendo que não conseguiu verificar o app, abra Ajustes do Sistema → Privacidade e Segurança, role para baixo até a mensagem sobre claude e clique em Permitir Mesmo Assim. Aí rode claude de novo no terminal.

Depois de instalar, você pode rodar este comando para que o Claude Code se verifique e aponte o que está errado:

Ele olha sua instalação e configurações comuns e geralmente te diz exatamente o que arrumar.