Como instalar o Claude Code e o Codex CLI no Windows

Os comandos exatos de PowerShell, CMD, WinGet e npm para instalar o Claude Code e o Codex CLI no Windows 10 e 11, quando escolher o WSL e como corrigir “claude não é reconhecido” e os outros erros que você vai encontrar.

As duas CLIs hoje se instalam no Windows com uma única linha. Quase todos os problemas aparecem depois dessa linha: um terminal que não encontra o comando, uma política de execução que bloqueia o npm, uma distribuição antiga do WSL 1, um comando colado no shell errado. Este guia traz os comandos exatos de cada método de instalação, e depois os erros e suas correções.

O que se diz das duas CLIs vem da documentação da Anthropic e da OpenAI e dos próprios scripts de instalação, lidos em 16 de novembro de 2026, com o Claude Code 2.1.318 e o Codex CLI 0.169.0. As duas ferramentas mudam rápido: se um comando abaixo falhar, confira a página oficial indicada em cada seção.

A resposta curta. Abra o PowerShell, não o CMD, e execute:

irm https://claude.ai/install.ps1 | iex
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

Depois abra um terminal novo e execute claude --version e codex --version. Se o Windows responder que claude não é reconhecido, a correção do PATH está na tabela de erros, mais abaixo.

O que cada CLI precisa no Windows

Claude CodeCodex CLI
Versão do WindowsWindows 10 1809 ou mais recente, Windows Server 2019 ou mais recenteWindows 11 recomendado, Windows 10 recente sem garantia (“best effort”)
Processadorx64 ou ARM64, nunca 32 bitsx64 ou ARM64
ContaUm plano pago do Claude ou uma conta do ConsoleUm plano do ChatGPT ou uma chave de API da OpenAI
Node.jsSó para o método npm, versão 22 ou mais recenteSó para o método npm
Git for WindowsOpcionalNão é necessário
Sandbox no Windows nativoNão, só no WSL 2Sim, o seu próprio sandbox do Windows
Direitos de administrador para instalarNãoNão

Duas linhas desta tabela surpreendem. O Claude Code não exige mais o Git for Windows: sem ele, usa o PowerShell como ferramenta de shell. E o Codex isola seus comandos em um sandbox no Windows nativo, enquanto o Claude Code só faz isso dentro do WSL 2.

Instalar o Claude Code no Windows

A página de instalação da Anthropic traz quatro métodos. O instalador nativo é o recomendado: não precisa do Node.js e se atualiza sozinho em segundo plano.

MétodoComando
PowerShell (recomendado)irm https://claude.ai/install.ps1 | iex
CMDcurl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
WinGetwinget install Anthropic.ClaudeCode
npm (Node.js 22+)npm install -g @anthropic-ai/claude-code@latest

O que cada método deixa para trás:

  • Instalador nativo: claude.exe em %USERPROFILE%\.local\bin, as versões em %USERPROFILE%\.local\share\claude. O instalador avisa quando .local\bin não está no seu PATH, e não adiciona a pasta por você.
  • WinGet: sem atualizações automáticas. Você atualiza com winget upgrade Anthropic.ClaudeCode, e a Anthropic avisa que uma atualização pode falhar enquanto o Claude Code está rodando, porque o Windows trava o executável.
  • npm: com um Node.js anterior ao 22, a instalação termina com um aviso EBADENGINE.

Para ficar uma versão atrás da mais recente, no canal estável:

& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) stable

Depois confira a instalação. claude --version mostra a versão, e claude doctor faz um diagnóstico somente leitura da instalação e das configurações.

Se você tem o Git for Windows, o Claude Code procura o Git Bash em C:\Program Files\Git, depois em C:\Program Files (x86)\Git, e depois o git do seu PATH. Para forçar outro, defina CLAUDE_CODE_GIT_BASH_PATH no bloco env do seu settings.json. Ele deve apontar para um arquivo chamado bash.exe ou sh.exe, não git-bash.exe.

Instalar o Codex CLI no Windows

A página do Windows da OpenAI é clara: use o Codex nativamente com o sandbox do Windows por padrão, e escolha o WSL quando suas ferramentas já vivem no Linux. Uma fonte ficou para trás: a página de instalação do repositório no GitHub ainda diz “Windows 11 via WSL2”. A documentação oficial mudou, e o instalador também.

MétodoComando
Instalador PowerShellpowershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
npmnpm install -g @openai/codex

O instalador PowerShell é o mais simples. Lendo o script, dá para ver o que ele faz: instala o Codex em %LOCALAPPDATA%\Programs\OpenAI\Codex\bin, adiciona essa pasta ao PATH do seu usuário e à sessão atual, e pede que você abra uma nova janela do PowerShell. Executar o mesmo comando de novo atualiza o Codex. Com o npm, você atualiza executando de novo o comando de instalação.

Depois faça login. Execute codex e escolha Sign in with ChatGPT, ou execute codex login. Em uma máquina sem navegador, codex login --device-auth dá um código para digitar em outro dispositivo. codex login status mostra com qual conta você está conectado.

O sandbox do Windows

O Codex tem três implementações de sandbox no Windows:

  • mxc: a recomendada, sem configuração de administrador. Exige o Windows 11 24H2 (build 26100.9278) ou 25H2 (build 26200.9278).
  • elevated: a alternativa preferida. Exige uma configuração única aprovada por um administrador.
  • unelevated: isolamento de rede mais fraco, e nenhum caminho somente leitura.

A escolha é feita no config.toml:

[features]
prefer_mxc = true

[windows]
sandbox = "elevated" # or "unelevated"

Se o sandbox falhar com o erro 1385, o Windows recusou o tipo de logon da conta do sandbox. Nesse caso, a OpenAI pede o CODEX_HOME/.sandbox/sandbox.log. Nunca compartilhe o conteúdo de .sandbox-secrets/.

Windows nativo ou WSL?

Nativo (PowerShell, CMD)WSL 2
Instalar o Claude Codeirm https://claude.ai/install.ps1 | iexcurl -fsSL https://claude.ai/install.sh | bash dentro do WSL
Instalar o Codexo instalador PowerShellcurl -fsSL https://chatgpt.com/codex/install.sh | sh dentro do WSL
Sandbox do Claude Codeindisponíveldisponível, com bubblewrap e socat
Sandbox do Codexo sandbox do Windowso sandbox do Linux
Onde guardar o repositórioem qualquer lugarem ~/, não em /mnt/c/

Escolha o WSL 2 quando seu projeto compila e roda no Linux de qualquer forma, ou quando você quer que o Claude Code isole em um sandbox os comandos que executa. Fique no nativo quando seu projeto é um projeto Windows: .NET, scripts PowerShell, caminhos do Windows por toda parte.

Três regras se você seguir pelo WSL:

  1. WSL 2, nunca WSL 1. O Codex deixou de suportar o WSL 1 na versão 0.115. O sandbox do Claude Code recusa o WSL 1 com Sandboxing requires WSL2, e instalações no WSL 1 podem falhar com Exec format error. Converta uma distribuição com wsl --set-version <DistroName> 2.
  2. Instale e execute dentro do WSL. Execute o comando Linux no terminal do WSL, não no do PowerShell. Rodar o Node.js do Windows a partir do WSL é o que causa exec: node: not found: instale o Node.js na própria distribuição, com o gerenciador de pacotes dela ou com o nvm.
  3. Mantenha o código no sistema de arquivos do Linux. Os dois fornecedores dizem para manter o repositório fora de /mnt/c/, e a Anthropic observa que as buscas do Claude Code ali são menos completas. Clone o repositório na sua pasta pessoal do Linux.

“claude não é reconhecido” e os outros erros

O que você vêPor quêCorreção
'claude' is not recognized as an internal or external command (CMD), The term 'claude' is not recognized (PowerShell)%USERPROFILE%\.local\bin não está no seu PATHAdicionar a pasta ao PATH do usuário (comandos abaixo) e abrir um terminal novo
Continua não reconhecido depois de adicionarO terminal, ou o editor que o contém, abriu antes da mudançaFechar e reabrir o terminal, e o editor se o terminal roda dentro dele
Não reconhecido logo depois de uma atualizaçãoUma atualização interrompida no meio da troca não deixou nenhum claude.exeRenomear o claude.exe.old.* mais recente de volta para claude.exe (comando abaixo)
'irm' is not recognizedVocê colou a linha do PowerShell no CMDAbrir o PowerShell, ou usar a linha do CMD
The token '&&' is not a valid statement separatorVocê colou a linha do CMD no Windows PowerShellUsar a linha do PowerShell
npm.ps1 cannot be loaded because running scripts is disabled on this systemA política de execução bloqueia o lançador PowerShell do npmSet-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser, ou chamar npm.cmd
Um erro sobre Windows 32 bits em um PC de 64 bitsVocê abriu “Windows PowerShell (x86)” pelo menu IniciarAbrir o PowerShell de 64 bits normal
claude abre o app desktop em vez da CLIUm app desktop antigo do Claude colocou um Claude.exe em WindowsApps, à frente da CLI no PATHAtualizar o app desktop do Claude
requires either Git for Windows (for bash) or PowerShellO Claude Code não encontrou nenhum dos dois shellsInstalar o Git for Windows, ou verificar se o PowerShell está no PATH
EBADENGINE durante o npm installO Node.js é anterior ao 22Atualizar o Node.js, ou usar o instalador nativo

A correção do PATH, no PowerShell, para o usuário atual, sem direitos de administrador:

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

Para ver onde o Windows procura antes de mudar qualquer coisa:

Test-Path "$env:USERPROFILE\.local\bin\claude.exe"
where.exe claude

A renomeação depois de uma atualização quebrada:

Get-ChildItem "$env:USERPROFILE\.local\bin\claude.exe.old.*" | Sort-Object Name | Select-Object -Last 1 | Rename-Item -NewName claude.exe

Sobre a política de execução: o Windows PowerShell 5.1, o que vem com o Windows, usa Restricted por padrão nos computadores cliente, e é por isso que um notebook novo bloqueia o npm.ps1. O escopo CurrentUser não exige direitos de administrador. O instalador nativo do Claude e o do Codex não são afetados: irm | iex e -ExecutionPolicy ByPass nunca carregam um arquivo de script do disco.

Atualizar e desinstalar

Claude CodeCodex CLI
Atualizar agoraclaude update (nativo), winget upgrade Anthropic.ClaudeCode, ou a instalação npm executada de novocodex update nas versões que suportam, o instalador PowerShell executado de novo, ou npm install -g @openai/codex
Atualizações automáticassó na instalação nativa, desativadas com DISABLE_AUTOUPDATER=1não documentadas
Desinstalarapagar %USERPROFILE%\.local\bin\claude.exe e %USERPROFILE%\.local\share\claude, ou winget uninstall Anthropic.ClaudeCode, ou npm uninstall -g @anthropic-ai/claude-codeapagar a pasta de instalação, ou npm uninstall -g @openai/codex
Configurações que ficam no disco%USERPROFILE%\.claude e %USERPROFILE%\.claude.json%USERPROFILE%\.codex

O que aprendemos rodando CLIs de agentes no Windows

O AgentsRoom executa o Claude Code, o Codex e as outras CLIs de agentes lado a lado, e a versão para Windows nos ensinou onde essas instalações quebram quando saem do terminal. Quatro coisas valem a pena saber, mesmo que você nunca use o nosso app.

Um programa aberto pelo menu Iniciar mantém o PATH com que foi iniciado. Você instala o Claude Code, adiciona .local\bin ao PATH, e um app desktop que já estava aberto continua sem encontrar claude. Reiniciar o terminal não basta para os apps que executam CLIs por você. O AgentsRoom relê o PATH do usuário e da máquina no registro quando procura uma CLI, para que uma instalação que acabou de dar certo não apareça como ausente.

O npm não instala um .exe. npm install -g @openai/codex grava três arquivos em %APPDATA%\npm: codex, codex.cmd e codex.ps1. Um programa que executa codex diretamente recebe spawn codex ENOENT, porque o Windows só acrescenta .exe a um nome sem extensão. O seu terminal esconde isso, já que o PowerShell e o CMD leem o PATHEXT. É mais um motivo para preferir os instaladores nativos, que instalam de fato um executável.

Os lançadores do npm precisam do Node.js na hora de rodar. Se você instala o Node.js e depois uma CLI na mesma sessão, o lançador .cmd é encontrado mas falha com “node is not recognized” em qualquer programa aberto antes de o Node.js estar no PATH. O mesmo sintoma aparece com um gerenciador de versões do Node cujos lançadores apontam para uma versão que não está ativa.

Criar um processo custa muito mais no Windows. Medimos de 20 a 80 ms para criar um processo no Windows, contra 1 a 3 ms no macOS, e cada verificação de arquivo custa mais porque o antivírus a inspeciona. Nossa primeira detecção de CLIs testava cada pasta, cada nome e cada extensão, e travava o app por até um segundo no Windows. Ler cada pasta uma única vez resolveu o problema.

No app, o assistente de instalação instala uma CLI que falta com o próprio instalador do fornecedor para o seu sistema (irm https://claude.ai/install.ps1 | iex para o Claude Code, o script da OpenAI para o Codex), recorre ao npm quando o script falha, e roda tudo em um terminal que você pode acompanhar. Quando uma CLI não inicia, o CLI Doctor lê o erro e o comando exato, e depois diz o que quebrou. Quando as duas CLIs respondem a --version, o guia de primeiros passos assume a partir daí, e o anúncio da versão para Windows explica o que o app faz no Windows.

Perguntas frequentes

Como instalo o Claude Code no Windows?

Abra o PowerShell e execute irm https://claude.ai/install.ps1 | iex. No CMD, use em vez disso a linha install.cmd da página de instalação da Anthropic, e com o WinGet execute winget install Anthropic.ClaudeCode. O binário fica em %USERPROFILE%\.local\bin, que o instalador não adiciona ao seu PATH: adicione você mesmo se claude não for reconhecido, depois abra um terminal novo e execute claude --version.

Preciso do WSL para usar o Claude Code ou o Codex no Windows?

Não. Os dois rodam nativamente no PowerShell ou no CMD no Windows 10 e 11. O WSL 2 vale a pena quando seu projeto já vive no Linux, ou quando você quer o sandbox do Claude Code, que não roda no Windows nativo. Use o WSL 2, não o WSL 1: o Codex deixou de suportar o WSL 1 na versão 0.115.

Por que o Windows diz que 'claude' não é reconhecido logo depois da instalação?

O instalador nativo coloca o claude.exe em %USERPROFILE%\.local\bin e mostra um aviso se essa pasta não estiver no seu PATH, mas não altera o PATH por conta própria. Adicione a pasta ao PATH do seu usuário, depois feche e reabra o terminal, e também o editor se o terminal roda dentro dele. Um terminal que já estava aberto mantém o PATH antigo.

O Claude Code precisa do Git for Windows?

Não mais. A página de instalação da Anthropic apresenta o Git for Windows como opcional: sem ele, o Claude Code usa o PowerShell como ferramenta de shell. Com ele, o Claude Code encontra o Git Bash em C:\Program Files\Git, e você pode indicar outro bash.exe com a configuração CLAUDE_CODE_GIT_BASH_PATH.

Dá para instalar o Codex CLI no Windows sem Node.js?

Sim. O instalador PowerShell da OpenAI baixa um Codex independente, coloca em %LOCALAPPDATA%\Programs\OpenAI\Codex\bin e adiciona essa pasta ao PATH do seu usuário. Só o método npm, npm install -g @openai/codex, precisa do Node.js.

PowerShell ou CMD para instalar?

PowerShell. Os dois comandos oficiais de uma linha são comandos do PowerShell, e os erros mais comuns vêm de colar uma linha do PowerShell no CMD ou o contrário: 'irm' is not recognized (ou “'irm' não é reconhecido” em um Windows em português) significa que você está no CMD, e '&&' is not a valid statement separator significa que você está no PowerShell. Use o PowerShell de 64 bits, não a entrada “Windows PowerShell (x86)” do menu Iniciar.

Engenheiro de DevOpsRedatorDesenvolvedor FrontendRepresentante ComercialDesenvolvedor BackendCoach e FormadorArquiteto de SoftwareConsultor JurídicoEngenheiro de QAFinanças e AdministraçãoDesenvolvedor Full-StackDesigner CriativoDesenvolvedor MobileInvestigadorEngenheiro de SegurançaRH e Recrutamento
Gerente de ProjetosTradutorEspecialista em GitAnalista de DadosEspecialista em SEOContabilistaEspecialista em LocalizaçãoComunicação e RPGerador de IdeiasOperações e LogísticaEspecialista em MarketingApoio ao ClienteAssistente do projetoCompradorCommunity ManagerAssistente Pessoal

Baixar AgentsRoom

Rode todos os seus agentes de IA, em todos os seus projetos, de uma única janela.

Baixar AgentsRoomGrátis

App complementar: acompanhe seus agentes em qualquer lugar

Use Claude, Codex, Antigravity CLI ou outro provedor de IA.

Instalar a extensão
Chrome Web Store

Envie bugs e pedidos direto para o seu backlog público.

Agentes que você lê como uma conversa

Cada agente tem uma função, um rosto e um fio que você lê como um app de mensagens.

Visão de conversa

Visão de conversa do AgentsRoom: o trabalho de um agente de programação com IA em formato de chat
Multi-projetos
Multi-provedor
Multi-agentes
Status ao vivo
Diff e commit
App mobile
Preview ao vivo
Equipes de agentes
Testes no navegador
Dev guiada por backlog
Biblioteca de prompts
Biblioteca de skills
Ver todas as funcionalidades

Continue lendo