Guia de instalação
Instalação do Claude Code
macOS
Windows
Progresso
0 de 5

No Mac a instalação é direta: você precisa do Node.js (a 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
1
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
1
Acesse nodejs.org/en/download.
2
Selecione macOS Installer (.pkg) na coluna LTS.
3
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.
2
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
1
Pressione ⌘ + Espaço para abrir o Spotlight.
2
Digite Terminal e pressione Enter.
3
A janela escura com texto que abre é o Terminal.
3
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
4
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
1
Abra o VS Code.
2
Abra o painel de extensões na barra lateral esquerda, ou pressione ⌘ + Shift + X.
3
Busque por Claude Code, publicada pela Anthropic.
4
Clique em Install.
5
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.
✓
Pronto! Viu como é fácil?

O Claude Code está funcionando no seu Mac. A partir daqui, é só começar a usar.

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 funcionar direito 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
1
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
1
Acesse git-scm.com/download/win. O download inicia sozinho.
2
Abra o arquivo baixado e avance com Next. As opções padrão já são as corretas.
3
Na tela "Adjusting your PATH", mantenha a opção do meio: Git from the command line and also from 3rd-party software.
4
Continue em Next até chegar em Install e confirme.
2
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
1
Acesse nodejs.org/en/download.
2
Selecione Windows Installer (.msi) na coluna LTS.
3
Abra o instalador e avance em Next até Install.
4
Se surgir a opção de instalar ferramentas adicionais, não é necessário marcar.
3
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
1
Pressione Win e digite PowerShell.
2
Clique com o botão direito em "Windows PowerShell" no resultado.
3
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".
4
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.
5
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
1
Abra o VS Code.
2
Abra o painel de extensões na barra lateral esquerda, ou pressione Ctrl + Shift + X.
3
Busque por Claude Code, publicada pela Anthropic.
4
Clique em Install.
6
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.
✓
Pronto! Viu como é fácil?

O Claude Code está funcionando no seu Windows. A partir daqui, é só começar a usar.

Guia de instalação do Claude Code