// tutorial · instalação

Como instalar o Claude Code (Windows, Mac e Linux)

O Claude Code é a ferramenta da Anthropic que coloca a IA Claude dentro do seu terminal. Você conversa em português, ele lê os arquivos da pasta e propõe mudanças. E pede sua permissão antes de mexer em qualquer coisa. A instalação leva poucos minutos. Este guia mostra o comando oficial de cada sistema e o que fazer se algo der errado.

Antes de começar: o que você precisa

Sistema: macOS 13 ou mais novo, Windows 10 (versão 1809) ou mais novo, ou Ubuntu 20.04+/Debian 10+. 4 GB de RAM bastam.
Conta: o Claude Code exige um plano pago, Claude Pro, Max, Team ou Enterprise, ou uma conta na plataforma Console da Anthropic. O plano gratuito do Claude.ai não inclui o Claude Code. Melhor saber disso antes de instalar.
No Windows: a Anthropic recomenda instalar também o Git for Windows se você for usar o Windows direto (sem WSL).

Um aviso de segurança. Os comandos abaixo baixam um script da internet e executam na sua máquina. Isso é normal em instaladores oficiais, mas crie o hábito: confira se a URL no comando é exatamente a do fabricante (aqui, claude.ai) antes de rodar. Nunca rode um comando desses vindo de fonte que você não confia.

Windows

Abra o PowerShell (aperte a tecla Windows, digite "PowerShell" e dê Enter). Cole o comando e aperte Enter:

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

Se você prefere o Prompt de Comando (CMD), o comando é este:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Se você usa WSL (o Linux dentro do Windows), siga a seção de Linux logo abaixo.

Mac

Abra o Terminal (Command + Espaço, digite "Terminal" e dê Enter). Cole o comando e aperte Enter:

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

Linux (e WSL)

Abra o terminal e rode:

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

Alternativa: instalar via npm

Se você já tem o Node.js na versão 22 ou mais nova, dá pra instalar assim em qualquer sistema:

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

Se você não sabe o que é Node.js, ignore esta alternativa. O comando oficial do seu sistema resolve.

Verifique se funcionou

Feche o terminal, abra de novo e rode:

claude --version

Deve aparecer o número da versão, algo como 2.1.220 (Claude Code). Se aparecer, está instalado. Para um diagnóstico completo da instalação, existe também o comando claude doctor.

Faça login

Rode o comando abaixo dentro de qualquer pasta:

claude

Na primeira vez, ele abre o navegador para você conectar sua conta Claude. Siga as instruções na tela e pronto, a partir daí é só usar.

Problemas comuns

"claude: command not found" (ou "não é reconhecido")

Quase sempre é só o terminal antigo que ainda não conhece o programa novo. Feche todas as janelas do terminal, abra uma nova e tente de novo.

O login não aceita minha conta

Confira o plano. O Claude Code precisa de Claude Pro, Max, Team ou Enterprise, ou de uma conta Console. Com o plano gratuito do Claude.ai, o login não vai funcionar. E não há truque que contorne isso.

Instalei via npm e deu erro

O caminho npm exige Node.js 22 ou mais novo. Se a sua versão é mais antiga, o mais simples é desistir do npm e usar o comando oficial do seu sistema, que não depende de Node.

E as atualizações?

A instalação oficial se atualiza sozinha. Se quiser forçar uma atualização agora, rode claude update.

Próximo passo

Instalou e logou? Então vá para Primeiros passos no Claude Code: sua primeira sessão: lá a gente mostra o que pedir primeiro e como revisar o que ele faz.

// continue daqui

Quer saber por onde começar no seu caso?

Cada pessoa chega num ponto diferente. O nosso diagnóstico gratuito leva 2 minutos e indica o próximo passo pro seu momento. E se você quer aprender com método, as Formações da Xentory estão chegando.

Fazer o diagnóstico gratuito Entrar na lista de espera das Formações