Instalação do Claude Code — macOS e Windows

No Mac a instalação é direta: você precisa do Node.js (base sobre a qual o Claude Code roda), do Claude Code instalado pelo Terminal e da extensão no VS Code.

Siga os passos na ordem. Do início ao fim, são cerca de 5 a 10 minutos.

Pré-requisitos

Mac com macOS 12 (Monterey) ou mais recente
Conexão estável com a internet
Uma conta na Anthropic (console.anthropic.com), gratuita para criar

Passo 1 de 5

Instalar o Node.js

O Claude Code roda sobre o Node.js. Baixe sempre a versão LTS (a recomendada, indicada à esquerda na página).

O que fazer

Acesse nodejs.org/en/download.

Selecione macOS Installer (.pkg) na coluna LTS.

Abra o arquivo baixado e siga o instalador até o final.

Dica Para confirmar, abra o Terminal e digite node --version. Deve aparecer um número de versão.

Passo 2 de 5

Abrir o Terminal

O Terminal é o aplicativo onde você instala e roda o Claude Code. Ele já vem instalado no Mac.

Como abrir

Pressione ⌘ + Espaço para abrir o Spotlight.

Digite Terminal e pressione Enter.

A janela escura com texto que abre é o Terminal.

Passo 3 de 5

Instalar o Claude Code

Com o Terminal aberto, copie e cole o comando abaixo. Ele baixa e instala o Claude Code. Pode levar cerca de um minuto.

Terminal

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

Atenção Se aparecer erro de permissão ou EACCES, rode com sudo na frente: sudo npm install -g @anthropic-ai/claude-code. O sistema vai pedir a senha de administrador.

Ao terminar, confirme que funcionou:

Terminal

%claude --version

claude 1.x.x

Passo 4 de 5

Instalar a extensão no VS Code

O VS Code é o editor que acompanha o Claude Code no dia a dia. Se ainda não tiver, baixe em code.visualstudio.com e instale a extensão oficial.

Instalar a extensão

Abra o VS Code.

Abra o painel de extensões na barra lateral esquerda, ou pressione ⌘ + Shift + X.

Busque por Claude Code, publicada pela Anthropic.

Clique em Install.

Passo 5 de 5

Fazer login na conta Anthropic

Falta conectar o Claude Code à sua conta. Rode o comando abaixo no Terminal: ele abre o navegador para você autenticar.

Terminal

%claude

Abrindo o navegador para autenticação...

Dica Sem conta ainda? Crie em console.anthropic.com (gratuito). Para usar o Claude Code sem limite de uso, é necessário um plano pago, Pro ou superior.

LZK

Tudo instalado e pronto para operar.

O Claude Code está funcionando no seu Mac. A partir daqui, entramos no uso real da ferramenta.

No Windows a instalação tem uma etapa a mais do que no Mac: o Git precisa vir antes do Node.js. Ele instala junto o Git Bash, o terminal que o Claude Code usa internamente para operar corretamente no sistema.

Siga os passos na ordem. Do início ao fim, são cerca de 10 a 15 minutos.

Pré-requisitos

Windows 10 ou 11, versão 64 bits
Conexão estável com a internet
Uma conta na Anthropic (console.anthropic.com), gratuita para criar

Passo 1 de 6

Instalar o Git

O Git é pré-requisito para o Claude Code funcionar no Windows. Baixe o instalador oficial em git-scm.com.

Durante a instalação

Acesse git-scm.com/download/win. O download inicia sozinho.

Abra o arquivo baixado e avance com Next. As opções padrão já são as corretas.

Na tela "Adjusting your PATH", mantenha a opção do meio: Git from the command line and also from 3rd-party software.

Continue em Next até chegar em Install e confirme.

Passo 2 de 6

Instalar o Node.js

O Claude Code roda sobre o Node.js. Baixe sempre a versão LTS (a recomendada, indicada à esquerda na página).

O que fazer

Acesse nodejs.org/en/download.

Selecione Windows Installer (.msi) na coluna LTS.

Abra o instalador e avance em Next até Install.

Se surgir a opção de instalar ferramentas adicionais, não é necessário marcar.

Passo 3 de 6

Abrir o PowerShell como Administrador

A instalação de pacotes globais exige o terminal em modo administrador. Vamos usar o PowerShell.

Como abrir

Pressione Win e digite PowerShell.

Clique com o botão direito em "Windows PowerShell" no resultado.

Escolha Executar como administrador e confirme no aviso do sistema.

Dica A janela está em modo administrador quando o título exibe "Administrador: Windows PowerShell".

Passo 4 de 6

Instalar o Claude Code

Com o PowerShell aberto em modo administrador, copie e cole o comando abaixo. O download e a instalação podem levar cerca de um minuto.

Windows PowerShell — Administrador

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

Ao terminar, confirme que a instalação funcionou:

Windows PowerShell

PS>claude --version

claude 1.x.x

Atenção Se aparecer que "claude" não é reconhecido, feche o PowerShell e abra novamente como administrador. O Windows às vezes só reconhece o novo comando depois de reiniciar o terminal.

Passo 5 de 6

Instalar a extensão no VS Code

O VS Code é o editor que acompanha o Claude Code no dia a dia. Se ainda não tiver, baixe em code.visualstudio.com e instale a extensão oficial.

Instalar a extensão

Abra o VS Code.

Abra o painel de extensões na barra lateral esquerda, ou pressione Ctrl + Shift + X.

Busque por Claude Code, publicada pela Anthropic.

Clique em Install.

Passo 6 de 6

Fazer login na conta Anthropic

Falta conectar o Claude Code à sua conta. Rode o comando abaixo no PowerShell: ele abre o navegador para você autenticar.

Windows PowerShell

PS>claude

Abrindo o navegador para autenticação...

Dica Sem conta ainda? Crie em console.anthropic.com (gratuito). Para usar o Claude Code sem limite de uso, é necessário um plano pago, Pro ou superior.

LZK

Tudo instalado e pronto para operar.

O Claude Code está funcionando no seu Windows. A partir daqui, entramos no uso real da ferramenta.