Passo 1: Instalar o Node.js

O Claude Code precisa do Node.js para funcionar.

Método 1: baixar do site oficial (recomendado)

1. Abra seu navegador e acesse https://nodejs.org
2. Clique na versão LTS para baixar (recomendada)
3. Dê dois cliques no arquivo .msi baixado
4. Siga o assistente de instalação mantendo as configurações padrão

Método 2: usar um gerenciador de pacotes

# Chocolatey
choco install nodejs

# Scoop
scoop install nodejs

NOTE

Observações para Windows

• Recomendamos usar o PowerShell em vez do CMD
• Se encontrar problemas de permissão, tente executar como administrador

TIP

Verifique a instalação Depois de instalar, abra um terminal e execute os comandos abaixo:

node --version
npm --version

Se os números de versão aparecerem, a instalação foi concluída com sucesso.

Passo 2: Instalar o Claude Code

Abra o PowerShell ou o CMD e execute o comando abaixo:

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

TIP

Verifique a instalação do Claude Code

claude --version

Se os números de versão aparecerem, a instalação foi concluída com sucesso.

Passo 3: Configurar as variáveis de ambiente

Configure as variáveis de ambiente do Claude Code

Método 1: temporário no PowerShell (sessão atual)

$env:ANTHROPIC_BASE_URL = "https://api.bsf.ai"
$env:ANTHROPIC_AUTH_TOKEN = "your_api_key"

Método 2: permanente no PowerShell (nível de usuário)

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.bsf.ai", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "your_api_key", [System.EnvironmentVariableTarget]::User)

Você precisa reabrir a janela do PowerShell para que as mudanças tenham efeito.

TIP

Verifique as variáveis de ambiente

echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN

Passo 4: Comece a usar

Inicie o Claude Code

claude

Use em um projeto específico

cd C:\path\to\your\project
claude

Perguntas frequentes

Problema: erro de política de execução do PowerShell

Se aparecerem erros de carregamento de script ou de política de execução, execute como administrador:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Problema: comando claude não encontrado

Se aparecer a mensagem de que 'claude' não é reconhecido como um comando:

1. Confirme que o Claude Code foi instalado corretamente
2. Confirme que você reabriu a janela do terminal
3. Verifique se o caminho de instalação global do npm está no PATH: npm config get prefix

Problema: instalação lenta do npm

Você pode usar um mirror para acelerar a instalação:

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com