Como instalar o Claude Code no Windows, Mac e Linux?

O que você precisa antes de instalar?

Instalar o Claude Code leva dois minutos. A frustração do primeiro dia quase nunca é instalação difícil: é instalação que deu certo pela metade, e ninguém conferiu. Comece checando se a sua máquina está na lista da documentação oficial, em setembro de 2026:

Duas peças ajudam desde o primeiro dia. O git, que é a rede de segurança: sem ele você não desfaz com facilidade o que o agente fez. E um editor de código, para ler com conforto o que mudou. O Node só entra se você escolher instalar pelo npm.

Como instalar o Claude Code no Windows, com ou sem WSL?

O Claude Code roda nativo no Windows. Você não precisa de WSL e não precisa abrir o terminal como administrador. Abra o PowerShell (Win + X e escolha Windows PowerShell ou Terminal) e rode:

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

Se você estiver no CMD, o comando muda. Para saber onde está, olhe o começo da linha: o PowerShell mostra PS C:\Users\SeuNome, o CMD mostra o mesmo sem o PS.

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

O Git for Windows é opcional e recomendado. Com ele, o Claude Code roda comandos pelo Git Bash; sem ele, usa o PowerShell. Quem prefere gerenciador de pacotes tem o winget install Anthropic.ClaudeCode, que não se atualiza sozinho (use winget upgrade Anthropic.ClaudeCode de tempos em tempos).

O WSL vale quando seus projetos usam ferramentas de Linux, ou quando você quer o isolamento de comandos (sandbox), que no Windows só funciona dentro do WSL 2. Nesse caso, abra o terminal da distribuição Linux e siga a instrução de Linux abaixo: você instala e roda o claude dentro do WSL, não no PowerShell.

Como instalar no macOS?

Abra o Terminal (Command mais espaço, escreva Terminal) e rode o instalador nativo:

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

Ele baixa um binário pronto, sem depender de Node, e se atualiza sozinho em segundo plano. Se você prefere o Homebrew, o comando é brew install --cask claude-code. Esse cask segue o canal estável, em geral uma semana atrás, e não se atualiza sozinho: rode brew upgrade claude-code quando quiser a versão nova.

Como instalar no Linux?

O comando é o mesmo do macOS, e vale também dentro do WSL:

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

A Anthropic também publica repositórios assinados para apt (Debian e Ubuntu), dnf (Fedora e RHEL) e apk (Alpine). Eles atualizam junto com o resto do sistema, e o passo a passo, com a verificação da chave, está na página de setup da documentação. No Alpine, instale antes bash, curl, libgcc, libstdc++ e ripgrep, que não vêm por padrão.

Dá para instalar pelo npm, se você já vive no Node?

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

Desde a versão 2.1.198, o pacote pede Node 22 ou mais novo. O npm instala o mesmo binário nativo do instalador, então o claude não usa o seu Node para rodar. Nunca use sudo npm install -g: dá problema de permissão e é um risco de segurança. Para atualizar, npm install -g @anthropic-ai/claude-code@latest.

Como saber se instalou?

Entre instalei e está funcionando existe um comando. Rode:

claude --version

Se voltou um número seguido de (Claude Code), está pronto. Para um diagnóstico mais completo, sem abrir sessão, existe o claude doctor. Se voltou command not found, ou 'claude' is not recognized no Windows, quase nunca a instalação falhou. O terminal procura programas numa lista curta de pastas, e o claude foi parar numa pasta fora dela.

1. Feche o terminal e abra de novo, porque a lista é lida quando a janela abre. Isso resolve a maioria dos casos.
2. Se continuar, procure no fim da saída do instalador a parte Setup notes: ela traz a linha exata que conserta. Costuma passar batido.
3. No macOS com Zsh, a correção é acrescentar $HOME/.local/bin ao PATH, como abaixo. No Linux com Bash, troque ~/.zshrc por ~/.bashrc.

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Como autenticar: assinatura ou API?

Rode claude. Na primeira vez, ele abre o navegador para você entrar na conta, e o terminal mostra Login successful no fim. Se o navegador não abrir, aperte c para copiar o endereço. No WSL é comum o navegador mostrar um código em vez de voltar sozinho: cole esse código no terminal.

Existem duas portas. A assinatura do Claude (Pro ou Max) põe o uso do dia a dia dentro da mensalidade. A conta de API, no Console, é cobrada por token consumido: ótima para automação e para time, traiçoeira para quem está aprendendo, porque o gasto cresce exatamente quando você está mais empolgado. Se você está começando, entre pela assinatura. Os valores estão no guia de preço do Claude Code.

Se a variável de ambiente ANTHROPIC_API_KEY estiver definida na sua máquina, o Claude Code pede para usar essa chave em vez da assinatura, e o uso vira cobrança de API. Para trocar de conta depois, use /login. O /status mostra qual conta está ativa.

Em que pasta abrir a primeira sessão?

O que trava as pessoas não é a instalação, é a primeira sessão aberta na pasta errada. A pasta em que você roda o comando é o mundo do agente: ele lê, busca e edita ali dentro. Então entre no projeto primeiro:

cd ~/projetos/meu-app
git status
claude

Se o git status reclamar que não é um repositório, rode git init antes: com histórico, ver e desfazer o que ele mudou fica trivial. Nunca abra na sua pasta pessoal. E faça um primeiro pedido que você confere em trinta segundos, como leia o README e me diga o que falta para rodar. O que esperar dessa conversa está em Claude Code para iniciantes.

Continue lendo

• Claude Code para iniciantes: como sair do terminal vazio para a primeira sessão?O que é o Claude Code, o mínimo de terminal para começar, onde abrir a primeira sessão e o que pedir primeiro. Para quem nunca abriu um terminal.
• Claude Code é pago? Preço, planos e limites em setembro de 2026Quanto custa o Claude Code em setembro de 2026: Pro, Max, Team, Enterprise e API, os limites de uso e a conta de tokens que decide o seu gasto.
• Comandos do Claude Code: quais usar e em que momento?Os comandos de barra e atalhos do Claude Code organizados pelo momento de uso: começar, contexto, modelo e esforço, retomar e custo. Atualizado em 2026.