Módulo 2.1 — Instalando no Windows

📦 Pré-requisitos do Windows

Antes de instalar o Claude Code, o Windows precisa de algumas ferramentas base. O mais importante é ter o Node.js versão 18 ou superior instalado, pois o Claude Code é distribuído como pacote npm.

📋 O que você precisa

• Node.js 18+ — runtime JavaScript necessário para executar o Claude Code
• npm — gerenciador de pacotes incluído automaticamente com Node.js
• PowerShell ou cmd — terminal para executar comandos de instalação
• Windows 10 ou 11 — versões antigas podem ter problemas de compatibilidade

💡 Dica: Usar PowerShell

Prefira usar o PowerShell ao invés do cmd. O PowerShell tem melhor suporte a Unicode (emojis no output do Claude Code) e o comando setx para variáveis permanentes funciona melhor nele.

🟢 Instalando Node.js no Windows

Existem duas formas modernas de instalar o Node.js no Windows: via winget (recomendado no Windows 11) ou baixando o instalador em nodejs.org. Ambas configuram o PATH automaticamente.

Instalar via winget (Windows 11 / Windows 10 atualizado)

Abra o PowerShell como administrador e execute:

# Instalar Node.js LTS via winget
winget install OpenJS.NodeJS.LTS

# Verificar instalação
node -v
npm -v

Instalar via instalador gráfico (nodejs.org)

Baixe o instalador LTS em nodejs.org/en/download e execute. Marque a opção "Add to PATH" durante a instalação.

Após instalar, feche e reabra o PowerShell para que o PATH seja atualizado.

Verificar instalação

node -v
# Esperado: v20.x.x (ou superior a 18)

npm -v
# Esperado: 10.x.x

⚠️ Atenção: PATH no Windows

Se o comando node não for reconhecido após a instalação, o PATH não foi configurado. Vá em Painel de Controle → Sistema → Variáveis de Ambiente e confirme que o diretório do Node.js está na variável Path. Sempre feche e reabra o terminal após modificar variáveis.

⬇️ Instalando o Claude Code

Com Node.js instalado, instalar o Claude Code é um único comando. O flag -g instala globalmente, tornando o comando claude disponível em qualquer pasta do sistema.

Instalação completa — PowerShell

# Instalar Claude Code globalmente
npm install -g @anthropic-ai/claude-code

# Verificar instalação
claude --version

# Teste rápido (sem autenticação configurada ainda)
claude -p "Olá, Claude!"

✓ O que FAZER

✓ Rodar o PowerShell como administrador na primeira instalação
✓ Usar o flag -g para instalação global
✓ Verificar com claude --version após instalar

✗ O que NÃO fazer

✗ Instalar sem o flag -g (ficará apenas local)
✗ Ignorar erros de permissão (EACCES) sem investigar
✗ Instalar com Node.js versão inferior a 18

🌐 Variáveis de Ambiente no Windows

O Claude Code precisa de variáveis de ambiente para saber qual API usar e como autenticar. No Windows, use setx para configuração permanente — ao contrário do set que é temporário e some ao fechar o terminal.

✓ Permanente com setx

# Configurar variáveis permanentes
# (feche e reabra o terminal depois!)
setx ANTHROPIC_BASE_URL "https://openrouter.ai/api"
setx ANTHROPIC_AUTH_TOKEN "sk-or-sua-chave-aqui"

# Para API Anthropic direta:
setx ANTHROPIC_AUTH_TOKEN "sk-ant-sua-chave"

✗ Temporário com set (evitar)

# EVITAR — some ao fechar terminal
set ANTHROPIC_AUTH_TOKEN=sk-ant-chave

# Problema: na próxima sessão
# o Claude Code não terá a chave!

Script completo de configuração — PowerShell

# === CONFIGURAÇÃO COMPLETA DO CLAUDE CODE NO WINDOWS ===

# 1. Instalar Node.js (se não tiver)
winget install OpenJS.NodeJS.LTS

# 2. Fechar e reabrir o PowerShell, depois continuar:

# 3. Verificar Node.js
node -v
npm -v

# 4. Instalar Claude Code
npm install -g @anthropic-ai/claude-code

# 5. Configurar variáveis permanentes
# Para OpenRouter (recomendado para início):
setx ANTHROPIC_BASE_URL "https://openrouter.ai/api"
setx ANTHROPIC_AUTH_TOKEN "sk-or-v1-SUA-CHAVE-OPENROUTER"

# OU para Anthropic direto:
setx ANTHROPIC_AUTH_TOKEN "sk-ant-api03-SUA-CHAVE"

# 6. Fechar e reabrir PowerShell novamente

# 7. Verificar tudo
claude --version
claude -p "Diga olá em uma linha"

⚠️ Importante: Reabrir Terminal após setx

O comando setx salva as variáveis no registro do Windows, mas a sessão atual do terminal não é atualizada automaticamente. Você DEVE fechar o PowerShell/cmd e abrir uma nova janela para que as variáveis fiquem disponíveis.

🔑 Primeiro Login no Windows

Com as variáveis configuradas, o Claude Code pode autenticar automaticamente. Sem variáveis, ele tentará abrir o browser para login OAuth no Anthropic Console.

Opção A: Via variável de ambiente (recomendada)

Configure ANTHROPIC_AUTH_TOKEN com setx conforme o tópico anterior. O Claude Code usará a chave automaticamente.

# Após configurar o setx e reabrir o terminal:
claude -p "Teste de autenticação"
# Deve responder sem pedir login

Opção B: Login interativo via browser

Execute claude sem variáveis configuradas. O Claude Code abrirá o browser automaticamente para autenticação no Anthropic Console.

# Sem variáveis configuradas, execute:
claude
# O browser abrirá automaticamente
# Faça login com sua conta Anthropic
# O token é salvo localmente

💡 Dica: Qual método escolher?

Para uso pessoal simples: login via browser é mais fácil. Para automações ou múltiplos projetos: use variáveis de ambiente via setx. Para usar OpenRouter ou Ollama: variáveis de ambiente são obrigatórias.

✅ Verificando e Próximos Passos

Com tudo instalado, é hora de verificar que o Claude Code funciona corretamente. Teste os comandos básicos e descubra as funcionalidades principais antes de usar em projetos reais.

Checklist de verificação — PowerShell

# 1. Verificar versão instalada
claude --version
# Saída esperada: claude vX.X.X

# 2. Testar chamada simples
claude -p "Qual é 2 + 2? Responda só o número."
# Saída esperada: 4

# 3. Verificar variáveis configuradas
echo $env:ANTHROPIC_AUTH_TOKEN
# Deve mostrar sua chave (não vazia)

# 4. Testar modo interativo
claude
# Deve abrir o prompt interativo do Claude Code
# Digite: /help para ver comandos disponíveis
# Ctrl+C para sair

🚀 Dica Avançada: WSL para usuários Windows

O Windows Subsystem for Linux (WSL) permite rodar um ambiente Linux completo dentro do Windows. Muitos desenvolvedores preferem usar o Claude Code dentro do WSL para ter o mesmo ambiente que servidores de produção.

# Instalar WSL (PowerShell como Admin):
wsl --install

# Após reiniciar, abrir WSL Ubuntu e seguir
# o guia de instalação Linux (Módulo 2.2)

O WSL é especialmente útil para projetos que precisam de ferramentas Unix como grep, sed, awk, e para ter paridade com ambientes de produção Linux.

🎯 Resumo do Módulo 2.1

✓

Node.js instalado — via winget ou instalador gráfico, versão LTS 18+

✓

Claude Code instalado globalmente — comando claude disponível em todo o sistema

✓

Variáveis configuradas com setx — ANTHROPIC_AUTH_TOKEN e ANTHROPIC_BASE_URL permanentes

✓

Autenticação funcionando — via API key ou login browser no Anthropic Console

✓

Testes verificados — claude --version e claude -p funcionando corretamente

Próximo Módulo:

2.2 — 🐧 Instalando no Linux — guia para Ubuntu, Debian, Fedora e Arch com nvm

← Voltar para Trilha 2 Próximo: Linux →