Como instalar Claude Code no Windows, macOS e Linux (maio 2026)

Claude Code passou de zero a mais de um milhão de buscas por mês em menos de um ano. Se você chegou aqui porque “todo mundo tá falando disso” e quer testar, esse é o seu guia de setup em 5 minutos pra qualquer sistema operacional.

Quatro coisas pra saber antes de começar:

1. Você precisa de um plano pago. Claude Pro ($20/mês), Max, Team, Enterprise ou uma conta Claude Console liberam o Claude Code. O plano gratuito do Claude.ai não inclui.
2. Claude Code vive no seu terminal — aquela janela de texto onde você digita comandos. (A Anthropic também tem um app de desktop se você prefere fugir do terminal de vez.)
3. O instalador nativo é o método oficial em 2026. A Anthropic também adicionou Homebrew, WinGet e repositórios de pacotes Linux assinados no início de 2026. Quem já trabalha com gerenciador de pacotes agora tem opções de primeira linha. A rota legada do npm ainda funciona, mas não é mais recomendada.
4. Aviso sobre o bug de tokens: As versões a partir da v2.1.100 estão inflando o consumo de tokens em cerca de 40%. A última no dia 4 de maio é a v2.1.126 — explico o workaround mais pra frente.

Escolha seu OS — cada rota de instalação é um comando só:

Bora.

Requisitos do sistema

Antes de instalar, confira se você tá num OS suportado:

Se você tá no Windows 11, beleza. Se tá no macOS Monterey (12) ou anterior, atualize primeiro.

Instalar no Windows

Você tem três caminhos no Windows. Escolha conforme você precisa de toolchain estilo Linux (WSL) ou prefere ficar nativo (PowerShell + Git Bash).

Windows nativo: PowerShell (o jeito mais simples)

Abra o PowerShell (não precisa ser Administrador) e rode:

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

Se irm retornar “is not recognized as an internal or external command”, você tá no CMD, não no PowerShell. O prompt mostra PS C:\ no PowerShell vs C:\ no CMD. Pra usar o CMD:

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

Depois de instalar, feche e reabra o terminal pra atualizar o PATH, e verifique:

claude --version
claude doctor

Recomendado: Instale o Git for Windows antes de rodar o claude. A Anthropic recomenda porque o Claude Code usa o Git Bash internamente pras ferramentas de shell. Sem ele, o Claude Code cai pro PowerShell como ferramenta de shell, que tem menos features.

Se o claude doctor reclamar que não acha o Git Bash, aponte o caminho em ~/.claude/settings.json:

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

Windows nativo: WinGet (instalação gerenciada)

A Anthropic publica o Claude Code pelo gerenciador de pacotes oficial da Microsoft:

winget install Anthropic.ClaudeCode

Instalações por WinGet não se atualizam sozinhas — rode winget upgrade Anthropic.ClaudeCode de tempos em tempos.

Instalar no Windows com WSL

WSL 2 (Windows Subsystem for Linux) te dá um ambiente Linux real dentro do Windows. A Anthropic recomenda WSL quando você quer execução de comandos em sandbox ou já trabalha com toolchains Linux.

Passo 1 — Instalar WSL. Abra o PowerShell como Administrador e rode:

wsl --install

Reinicie quando pedir. Depois do reboot, abra o terminal do Ubuntu pelo menu Iniciar.

Passo 2 — Instalar Claude Code dentro do WSL. No prompt do Ubuntu:

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

Passo 3 — Verificar e começar a trabalhar num projeto:

claude --version
claude doctor
cd /mnt/c/Users/SEU_USUARIO/caminho/do/projeto
claude

O caminho /mnt/c/ é como o WSL acessa seus discos do Windows. Seu C: fica em /mnt/c/, D: em /mnt/d/, e por aí vai.

Instalar no macOS ou Linux

Abra o Terminal. Cole isso. Aperte Enter.

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

Pronto, é toda a instalação. O instalador nativo baixa o binário, joga em ~/.local/bin e configura auto-update. Não precisa de Node.js, sem dependências, sem drama de gerenciador de pacotes.

Confirme que funcionou:

claude --version
claude doctor

claude doctor roda diagnósticos: status de auth, PATH, config, servidores MCP. Sempre rode depois de instalar pra pegar problemas cedo.

Agora entra num projeto:

cd /caminho/do/seu/projeto
claude

Pronto. Você tá dentro do Claude Code.

Instalar com Homebrew (macOS)

Se você já gerencia suas ferramentas com Homebrew, a Anthropic publica um cask oficial:

brew install --cask claude-code

Na real existem dois casks:

• claude-code — segue o canal stable (cerca de uma semana atrás do latest, pula releases com regressões grandes). Escolha mais segura.
• claude-code@latest — segue o canal latest (versões novas assim que saem).

# Pro canal bleeding-edge:
brew install --cask claude-code@latest

Importante: instalações por Homebrew não se atualizam sozinhas. Rode brew upgrade claude-code (ou claude-code@latest) pra pegar versões novas e patches de segurança.

Instalar no Linux com gerenciadores de pacotes

A Anthropic publica repositórios assinados de apt, dnf e apk. É a rota mais limpa em Debian/Ubuntu, Fedora/RHEL e Alpine porque os updates fluem pelo seu workflow normal de upgrade do sistema.

Debian / Ubuntu (apt):

sudo install -d -m 0755 /etc/apt/keyrings
sudo curl -fsSL https://downloads.claude.ai/keys/claude-code.asc \
  -o /etc/apt/keyrings/claude-code.asc
echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/stable stable main" \
  | sudo tee /etc/apt/sources.list.d/claude-code.list
sudo apt update
sudo apt install claude-code

Confira o fingerprint da chave GPG antes de confiar nela: gpg --show-keys /etc/apt/keyrings/claude-code.asc deve mostrar 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE.

Fedora / RHEL (dnf):

sudo tee /etc/yum.repos.d/claude-code.repo <<'EOF'
[claude-code]
name=Claude Code
baseurl=https://downloads.claude.ai/claude-code/rpm/stable
enabled=1
gpgcheck=1
gpgkey=https://downloads.claude.ai/keys/claude-code.asc
EOF
sudo dnf install claude-code

Alpine (apk):

wget -O /etc/apk/keys/claude-code.rsa.pub \
  https://downloads.claude.ai/keys/claude-code.rsa.pub
echo "https://downloads.claude.ai/claude-code/apk/stable" >> /etc/apk/repositories
apk add claude-code

Pro canal rolling, troque stable por latest na URL e nome de suite. Atualize depois pelo seu comando normal de gerenciador de pacotes (sudo apt upgrade claude-code, sudo dnf upgrade claude-code, apk upgrade claude-code).

Instalar via npm (a rota legada)

Se você já tem Node.js 18+ instalado e prefere npm:

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

Isso instala o mesmo binário nativo do instalador standalone, através de uma dependência opcional por plataforma. Três motivos por que a maioria já evita:

1. Sem auto-update. Você roda npm update manualmente quando saem versões novas.
2. Requer Node.js 18+. O instalador nativo tem zero dependências.
3. Erros de permissão. Especialmente com sudo npm install -g — não faça isso.

Se você já instalou via npm e quer migrar pro nativo:

curl -fsSL https://claude.ai/install.sh | bash
npm uninstall -g @anthropic-ai/claude-code

Autenticação (a dança do login)

Na primeira vez que você roda o claude, ele abre o navegador pro login OAuth. Faça login com a conta Anthropic que você usa:

• Assinatura pessoal Claude Pro/Max — login do claude.ai
• Claude Team ou Enterprise — login do seu workspace
• Claude Console — se sua org te convidou

Se o navegador não abrir sozinho, aperte c no terminal pra copiar a URL de login, cole no navegador, finalize o login, e cole o código de volta no terminal quando pedir.

Pra trocar de conta depois:

/logout

(Esse comando vai dentro do Claude Code, não no shell.)

Seus primeiros comandos

Depois que o claude te coloca numa sessão interativa, teste:

/help          # Mostrar todos os comandos disponíveis
/status        # Ver auth, assinatura, rate limits
/config        # Ver configuração atual
/logout        # Sair

Do seu shell (fora da sessão interativa):

claude doctor    # Relatório de diagnóstico
claude --version # Versão instalada
claude mcp list  # Listar servidores MCP configurados

Uma primeira tarefa real

Abra um projeto que você já tem. Qualquer coisa — um app Next.js, um script Python, um repo de configs. Inicie o Claude Code:

cd /caminho/do/projeto
claude

Aí digita uma tarefa real em português ou inglês. Tipo:

“Lê o README e me explica como esse projeto tá organizado.”

Ou:

“Adiciona uma função nova que valida endereços de email. Coloca onde melhor encaixar no codebase.”

Ou:

“Encontra todos os comentários TODO e lista com os caminhos dos arquivos.”

O Claude olha seus arquivos, pensa, e propõe mudanças. Ele te pede aprovação pra cada edit antes de fazer. Você mantém o controle.

Problemas típicos do setup (e correções)

“command not found: claude”

O instalador colocou o binário em ~/.local/bin, mas seu shell não conhece esse diretório. Adicione ao PATH:

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

Troque .bashrc por .zshrc se você tá no zsh (default do macOS desde Catalina).

“The token ‘&&’ is not a valid statement separator”

Você colou um comando estilo CMD no PowerShell. Mude pro CMD ou use a versão PowerShell:

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

“Permission denied” durante npm install

Você tentou sudo npm install -g e quebrou as permissões. Não use sudo com npm. Em vez disso:

• Use o instalador nativo (sem precisar de sudo): curl -fsSL https://claude.ai/install.sh | bash
• Use nvm (Node Version Manager) pra instalar Node na sua home

WSL não chega na internet

Teste com curl https://claude.ai. Se falhar, seu firewall do Windows ou VPN tá bloqueando o WSL. A maioria das VPNs tem opção “exclude local traffic” — ative.

Rate limit logo depois de instalar

Tá no Pro e batendo o limite em menos de uma hora? É um problema real que a Anthropic reconheceu em 31 de março de 2026. Confira sua versão do Claude Code:

claude --version

A última build no dia 4 de maio é a v2.1.126 (lançada em 1 de maio), que adicionou o comando útil claude project purge [path] e corrigiu um bug do percentual /context do Opus 4.7 — mas o problema de inflação de tokens introduzido na v2.1.100 ainda não tem patch público. Workaround segundo relatos da comunidade: baixar pra v2.1.34, ou reinstalar via npm em vez do binário nativo.

Você pode fixar uma versão específica pelo instalador nativo:

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

Ou fixe um piso mínimo em ~/.claude/settings.json pra updates futuros não te jogarem sem querer numa versão ruim:

{
  "autoUpdatesChannel": "stable",
  "minimumVersion": "2.1.34"
}

Estender Claude Code com MCP

Quando o básico tá rodando, o poder de verdade tá em conectar o Claude Code a outras ferramentas via MCP (Model Context Protocol). MCP transforma o Claude Code de “assistente de programação” em “assistente com acesso direto às suas bases de dados, APIs e ferramentas de equipe”.

Listar servidores MCP atuais:

claude mcp list

Adicionar um novo (exemplo — conectar uma base de dados):

claude mcp add my-db --command "docker run --rm my-db-mcp:latest"

Cada projeto pode ter seu próprio arquivo .claude/.mcp.json listando os servidores MCP que aquele projeto usa. Codebases compartilhados podem commitar esse arquivo pra todo o time ter o mesmo setup de ferramentas.

Referência rápida por OS

O que isso significa pra você

Se você nunca usou terminal: Fique no macOS ou WSL no Windows. O terminal faz parte da identidade do Claude Code — você não consegue usar de verdade sem pelo menos conforto básico com terminal. Passa um tempo aprendendo cd, ls, pwd e o básico de git se ainda não pegou.

Se você é dev avaliando Claude Code: Instala em 5 minutos, aponta pra um side project, dá uma tarefa real. Cursor é mais estilo IDE, Copilot é mais estilo autocomplete — Claude Code é genuinamente diferente, e você precisa sentir pra entender.

Se você tá configurando isso pra seu time: Crie um diretório .claude/ nos repos compartilhados com configuração MCP do time. Commita. Membros novos rodam o instalador, autenticam, e herdam o setup de ferramentas do time automaticamente.

Se você já instalou Claude Code: O ecossistema de plugins e MCP é onde você sobe de “usuário” pra “power user”. Confira nosso curso IA pra Programadores e Engenharia de Prompts pra dominar o lado prompt da equação.

Resumindo

Instalar Claude Code leva entre 30 segundos e 5 minutos dependendo do OS. O instalador nativo (default desde abril de 2026) é confiável, rápido e sem dependências.

A curva de aprendizado real não é a instalação — é descobrir como usar Claude Code de forma produtiva depois de instalado. Comece com tarefas pequenas, cresça pra workflows maiores, adicione ferramentas MCP quando achar necessidades reais. Não tente configurar tudo no dia um.

E orçamenta a assinatura. O plano gratuito não te leva onde você precisa. Pro a $20/mês é o ponto de entrada real.

Próximo passo: Nosso curso IA pra Programadores cobre o workflow completo de programação assistida por IA. Se você quer mergulhar fundo em prompting, Engenharia de Prompts e Prompts Avançados são os complementos perfeitos.

Fontes (verificadas em 4 de maio de 2026):

• Claude Code Setup — Documentação oficial (verificado ao vivo pra sintaxe de comandos)
• Claude Code Changelog — Oficial
• Release do Claude Code v2.1.126 — 1 de maio de 2026
• Install Claude Code — Anthropic