Claude CodeAtualizado em 29 de setembro de 20264 min de leitura

Claude Code no Windows: instalação e configuração passo a passo

O Claude Code roda direto no Windows, sem máquina virtual. Este guia mostra a instalação pelo PowerShell, pelo CMD ou pelo WinGet, a configuração para usar o Claude Opus 5 pagando em reais e a solução dos erros mais comuns.

Os comandos seguem a documentação oficial do Claude Code, conferida na data de atualização deste guia.

O que você precisa

• Windows 10 versão 1809 ou mais recente, ou Windows Server 2019 em diante.
• Windows de 64 bits (x64 ou ARM64). O Claude Code não roda em Windows de 32 bits.
• 4 GB de memória ou mais e conexão com a internet.
• Opcional: Git for Windows. Com ele, o Claude Code roda comandos pelo Git Bash. Sem ele, usa o PowerShell.

Não precisa abrir o terminal como administrador.

PowerShell ou CMD?

O comando de instalação muda conforme o terminal. Veja o começo da linha:

• PS C:\Users\SeuNome>: você está no PowerShell.
• C:\Users\SeuNome>, sem o PS: você está no CMD.

Instale o Claude Code

PowerShell (o jeito recomendado):

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

CMD:

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

WinGet (o gerenciador de pacotes do Windows):

winget install Anthropic.ClaudeCode

Instalado pelo PowerShell ou pelo CMD, o Claude Code se atualiza sozinho. Pelo WinGet, não: rode winget upgrade Anthropic.ClaudeCode de tempos em tempos.

Confira a instalação

Feche o terminal, abra um novo e rode:

claude --version

Se aparecer um número de versão, deu certo. Para um diagnóstico completo da instalação e das configurações, rode claude doctor.

Configure a chave e a URL base

Para usar o Claude Code com a API da open33, ele precisa de duas informações: a URL base e a sua chave.

Só nesta janela do PowerShell:

$env:ANTHROPIC_BASE_URL = "https://api.open33.tech"
$env:ANTHROPIC_API_KEY = "SUA_CHAVE"
claude

Para todas as janelas e projetos (recomendado): coloque as duas variáveis no arquivo de configuração do Claude Code, que fica em %USERPROFILE%\.claude\settings.json. Para criar a pasta e abrir o arquivo no Bloco de Notas:

New-Item -ItemType Directory -Force "$env:USERPROFILE\.claude" | Out-Null
notepad "$env:USERPROFILE\.claude\settings.json"

Cole o conteúdo abaixo, troque SUA_CHAVE pela chave do painel e salve:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.open33.tech",
    "ANTHROPIC_API_KEY": "SUA_CHAVE"
  }
}

Na primeira vez que você abrir o claude com a chave configurada, ele pergunta se deve usar essa chave. Confirme. Depois, o comando /status mostra a URL base e a chave em uso.

Git Bash ou PowerShell?

O Claude Code precisa de um shell para rodar comandos no seu projeto:

• Sem o Git for Windows, ele usa o PowerShell.
• Com o Git for Windows, ele usa o Git Bash, e o PowerShell continua disponível.

Se o Git está instalado mas o Claude Code não encontra o Git Bash, informe o caminho do bash.exe no mesmo settings.json:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.open33.tech",
    "ANTHROPIC_API_KEY": "SUA_CHAVE",
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

Para descobrir onde o Git está instalado, rode where.exe git no PowerShell.

E o WSL?

Se os seus projetos ficam no WSL (o Linux dentro do Windows), instale e use o Claude Code dentro dele. Abra o terminal do WSL e rode o instalador de Linux:

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

No WSL, as variáveis vão no ~/.bashrc, como no Linux. O passo a passo está no guia Claude Code em reais.

Erros comuns no Windows

"'claude' is not recognized" ou "The term 'claude' is not recognized": a pasta de instalação não está no PATH. Confira no PowerShell:

$env:PATH -split ';' | Select-String '\.local\\bin'

Se não aparecer nada, acrescente a pasta ao PATH do seu usuário e abra um terminal novo:

$atual = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$atual;$env:USERPROFILE\.local\bin", 'User')

"The token '&&' is not a valid statement separator": você rodou o comando do CMD no PowerShell. Use o comando do PowerShell.

"'irm' is not recognized": você rodou o comando do PowerShell no CMD. Use o comando do CMD.

"The process cannot access the file" durante a instalação: outra janela do instalador ou o antivírus está usando o arquivo. Feche as outras janelas, espere um pouco e rode:

Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\downloads"
irm https://claude.ai/install.ps1 | iex

claude abre o app Claude Desktop em vez do terminal: uma versão antiga do Claude Desktop registra um atalho com o mesmo nome. Atualize o Claude Desktop.

O Claude Code pede login mesmo com a chave configurada: veja o guia Claude Code pedindo login.

Com tudo funcionando, o guia de comandos do Claude Code mostra o que usar no dia a dia.