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 Code | Codex CLI | |
|---|---|---|
| Versão do Windows | Windows 10 1809 ou mais recente, Windows Server 2019 ou mais recente | Windows 11 recomendado, Windows 10 recente sem garantia (“best effort”) |
| Processador | x64 ou ARM64, nunca 32 bits | x64 ou ARM64 |
| Conta | Um plano pago do Claude ou uma conta do Console | Um plano do ChatGPT ou uma chave de API da OpenAI |
| Node.js | Só para o método npm, versão 22 ou mais recente | Só para o método npm |
| Git for Windows | Opcional | Não é necessário |
| Sandbox no Windows nativo | Não, só no WSL 2 | Sim, o seu próprio sandbox do Windows |
| Direitos de administrador para instalar | Não | Nã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étodo | Comando |
|---|---|
| PowerShell (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 | winget 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.exeem%USERPROFILE%\.local\bin, as versões em%USERPROFILE%\.local\share\claude. O instalador avisa quando.local\binnã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étodo | Comando |
|---|---|
| Instalador PowerShell | powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex" |
| npm | npm 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 Code | irm https://claude.ai/install.ps1 | iex | curl -fsSL https://claude.ai/install.sh | bash dentro do WSL |
| Instalar o Codex | o instalador PowerShell | curl -fsSL https://chatgpt.com/codex/install.sh | sh dentro do WSL |
| Sandbox do Claude Code | indisponível | disponível, com bubblewrap e socat |
| Sandbox do Codex | o sandbox do Windows | o sandbox do Linux |
| Onde guardar o repositório | em qualquer lugar | em ~/, 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:
- 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 comExec format error. Converta uma distribuição comwsl --set-version <DistroName> 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. - 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 PATH | Adicionar a pasta ao PATH do usuário (comandos abaixo) e abrir um terminal novo |
| Continua não reconhecido depois de adicionar | O terminal, ou o editor que o contém, abriu antes da mudança | Fechar e reabrir o terminal, e o editor se o terminal roda dentro dele |
| Não reconhecido logo depois de uma atualização | Uma atualização interrompida no meio da troca não deixou nenhum claude.exe | Renomear o claude.exe.old.* mais recente de volta para claude.exe (comando abaixo) |
'irm' is not recognized | Você colou a linha do PowerShell no CMD | Abrir o PowerShell, ou usar a linha do CMD |
The token '&&' is not a valid statement separator | Você colou a linha do CMD no Windows PowerShell | Usar a linha do PowerShell |
npm.ps1 cannot be loaded because running scripts is disabled on this system | A política de execução bloqueia o lançador PowerShell do npm | Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser, ou chamar npm.cmd |
| Um erro sobre Windows 32 bits em um PC de 64 bits | Você abriu “Windows PowerShell (x86)” pelo menu Iniciar | Abrir o PowerShell de 64 bits normal |
claude abre o app desktop em vez da CLI | Um app desktop antigo do Claude colocou um Claude.exe em WindowsApps, à frente da CLI no PATH | Atualizar o app desktop do Claude |
requires either Git for Windows (for bash) or PowerShell | O Claude Code não encontrou nenhum dos dois shells | Instalar o Git for Windows, ou verificar se o PowerShell está no PATH |
EBADENGINE durante o npm install | O Node.js é anterior ao 22 | Atualizar 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 Code | Codex CLI | |
|---|---|---|
| Atualizar agora | claude update (nativo), winget upgrade Anthropic.ClaudeCode, ou a instalação npm executada de novo | codex update nas versões que suportam, o instalador PowerShell executado de novo, ou npm install -g @openai/codex |
| Atualizações automáticas | só na instalação nativa, desativadas com DISABLE_AUTOUPDATER=1 | não documentadas |
| Desinstalar | apagar %USERPROFILE%\.local\bin\claude.exe e %USERPROFILE%\.local\share\claude, ou winget uninstall Anthropic.ClaudeCode, ou npm uninstall -g @anthropic-ai/claude-code | apagar 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.
Baixar AgentsRoom
Rode todos os seus agentes de IA, em todos os seus projetos, de uma única janela.
App complementar: acompanhe seus agentes em qualquer lugar
Use Claude, Codex, Antigravity CLI ou outro provedor de IA.
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.

Continue lendo
Modo de voz no Codex, OpenCode, Antigravity e Claude Code: qual CLI tem um?
Verificamos cinco CLIs de agentes de código e dois apps em 13 de outubro de 2026. O Codex CLI e o oh-my-pi mantêm uma conversa falada, o Claude Code e o Antigravity CLI só ditam no prompt, o OpenCode não tem nada integrado. Como iniciar cada um, para onde vai o áudio e quanto a voz custa em tokens.
Leia o artigoO Remote Control do Claude Code usa mais tokens? E o Codex tem um?
Duas perguntas que as pessoas digitam no Google desde que a Anthropic lançou o Remote Control: conduzir uma sessão do Claude Code pelo celular custa mais tokens, e existe um equivalente para o Codex. Respostas curtas: não, um turno é um turno onde quer que você o digite, e sim, mas só metade dele existe. Veja o que o Remote Control realmente é, como medir você mesmo a questão dos tokens em quatro comandos, o que o codex remote-control faz hoje, e como um controle remoto mobile que nunca fala com um provider muda a conta.
Leia o artigoComo remover o Co-Authored-By Claude dos seus commits do git
O Claude Code assina seus commits com um trailer Co-Authored-By e seus pull requests com uma linha Generated with Claude Code. A configuração que os remove, o arquivo onde colocá-la e como limpar os commits que você já enviou.
Leia o artigo