Resposta rápida: para instalar o Codex no Windows, abra o PowerShell e rode powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex". Depois feche e reabra o terminal, execute codex, faça login com sua conta ChatGPT ou API key, e confirme a instalação com codex --version.
O Codex é o agente de programação da OpenAI que roda no terminal e trabalha dentro da pasta do seu projeto. Ele consegue ler arquivos, alterar código, executar comandos e ajudar em tarefas como corrigir bugs, criar funcionalidades, revisar mudanças e entender projetos grandes.
Se você chegou aqui porque já viu nosso guia de como instalar Claude Code no Windows, a lógica é parecida: instalar a ferramenta certa, abrir o terminal correto, autenticar e testar com comandos simples antes de delegar tarefas maiores.
- Melhor caminho no Windows: instalar pelo PowerShell com o instalador oficial.
- Alternativa para quem usa Node: instalar via npm com
npm install -g @openai/codex. - Login: Codex aceita login com ChatGPT ou API key, mas alguns recursos dependem do tipo de acesso.
- WSL2: use quando seu projeto precisa de ambiente Linux; para a maioria dos usuários Windows, comece nativo no PowerShell.
O que é o Codex?
Codex é o agente de código da OpenAI. Na prática, ele funciona como um assistente técnico dentro do seu ambiente de desenvolvimento.
Em vez de apenas responder perguntas no chat, o Codex pode trabalhar em uma pasta real do seu computador. Ele lê arquivos do projeto, propõe alterações, executa comandos e ajuda você a revisar o que mudou.
Isso torna o Codex útil para tarefas como:
- entender a estrutura de um projeto;
- criar ou alterar arquivos;
- corrigir bugs;
- escrever testes;
- revisar código antes de fazer commit;
- explicar uma base de código desconhecida;
- automatizar tarefas repetitivas no terminal.
Segundo a documentação oficial da OpenAI, o Codex CLI roda localmente no terminal, pode ler, alterar e executar código no diretório selecionado, e está disponível para macOS, Windows e Linux.
Codex, Codex CLI, app e ChatGPT: qual é a diferença?
Esse ponto confunde muita gente. "Codex" pode aparecer em mais de uma interface.
Leitura rápida: se a sua dúvida é instalar no Windows, o foco deste guia é o Codex CLI, ou seja, o comando codex no terminal.
| Nome | O que é | Quando usar |
|---|---|---|
| Codex | O agente de programação da OpenAI | Quando você quer ajuda para entender, editar ou revisar código |
| Codex CLI | A versão de terminal, acessada pelo comando codex |
Quando quer usar Codex em uma pasta local do projeto |
| Codex app | Aplicativo desktop para trabalhar com projetos, threads, revisões e recursos visuais | Quando quer uma interface mais completa que o terminal puro |
| Codex web | Codex dentro do ChatGPT/web, conectado a repositórios e tarefas em nuvem | Quando quer delegar tarefas sem rodar tudo localmente |
| API key | Forma de autenticação via OpenAI Platform | Quando quer uso programático ou cobrança por uso da API |
Se você é iniciante, pense assim: instalar Codex no Windows normalmente significa instalar a CLI e usar o comando codex no PowerShell.
Pré-requisitos para instalar Codex no Windows
Antes de instalar, confira:
- Windows 11 recomendado ou Windows 10 recente e atualizado.
- PowerShell ou Windows Terminal.
- winget disponível, especialmente se você pretende usar recursos nativos e manter o Windows atualizado.
- Conta ChatGPT com acesso ao Codex ou uma API key da OpenAI Platform.
- Git instalado, se você vai usar Codex em projetos versionados.
- Node.js apenas se você escolher a instalação via npm.
Pela documentação oficial, no Windows o Codex pode rodar de forma nativa com sandbox do Windows ou dentro do WSL2 quando você precisa de ambiente Linux.
Como instalar Codex no Windows pelo PowerShell
Esse é o caminho mais direto para a maioria dos usuários.
Passo 1: abra o PowerShell
Abra o menu iniciar, pesquise por PowerShell ou Windows Terminal e abra uma janela nova.
Para começar, não precisa entrar em uma pasta específica. A instalação configura o comando codex no sistema; depois você usa o Codex dentro da pasta do projeto.
Passo 2: execute o instalador oficial
Cole este comando no PowerShell:
“powershell powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex" “
Esse comando chama o instalador oficial do Codex para Windows.
Se o PowerShell pedir confirmação, leia a mensagem e prossiga apenas se o comando for exatamente o instalador oficial da OpenAI.
Passo 3: feche e reabra o terminal
Depois da instalação, feche o PowerShell completamente e abra uma nova janela.
Isso evita erro de PATH antigo, porque o Windows pode precisar recarregar as variáveis de ambiente.
Passo 4: confirme a instalação
Rode:
“powershell codex --version “
Se aparecer o número da versão, a CLI está instalada.
Depois rode:
“powershell codex “
Na primeira execução, o Codex deve pedir autenticação.
Como instalar Codex pelo npm
Se você já usa Node.js e npm no dia a dia, também pode instalar o Codex assim:
“powershell npm install -g @openai/codex “
Depois confirme:
“powershell codex --version “
Use npm quando você já tem Node configurado, sabe lidar com pacotes globais e prefere atualizar ferramentas pelo ecossistema JavaScript.
Se você só quer instalar e começar no Windows, o instalador via PowerShell costuma ser mais simples.
PowerShell, CMD, npm ou WSL2: qual método usar?
| Método | Melhor para | Comando principal | Observação | |
|---|---|---|---|---|
| PowerShell | A maioria dos usuários Windows | `powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"` | Caminho mais direto no Windows |
| npm | Quem já usa Node.js | npm install -g @openai/codex |
Requer Node/npm funcionando | |
| WSL2 | Projetos que dependem de Linux | instalar dentro do ambiente Linux | Melhor se seu projeto já vive no WSL | |
| Codex app | Quem quer interface visual | instalar o app oficial | Bom para revisar threads, projetos e recursos visuais |
Minha recomendação prática: comece com PowerShell. Use WSL2 só se seu projeto realmente precisa de Linux ou se sua rotina de desenvolvimento já está no WSL.
Como fazer login no Codex
O Codex aceita dois caminhos principais de autenticação:
- Login com ChatGPT.
- Login com API key.
Login com ChatGPT
Ao rodar:
“powershell codex “
o Codex pode abrir uma janela do navegador para você entrar na sua conta ChatGPT.
Esse costuma ser o caminho mais simples para quem já usa ChatGPT Plus, Pro, Business, Edu ou Enterprise.
Login com API key
Também é possível autenticar usando uma API key da OpenAI Platform.
Esse caminho faz sentido para uso programático, automações, scripts e ambientes em que você quer pagar pelo uso da API em vez de usar os créditos/limites do plano ChatGPT.
Pegue sua chave no dashboard da OpenAI Platform e siga o fluxo de login do Codex quando ele pedir a forma de autenticação.
Primeiros comandos depois de instalar
Depois de instalar e autenticar, entre na pasta de um projeto:
“powershell cd C:\caminho\do\seu\projeto “
Depois rode:
“powershell codex “
Você pode pedir tarefas em linguagem natural, por exemplo:
- "Explique a estrutura deste projeto."
- "Encontre possíveis bugs neste arquivo."
- "Crie testes para essa função."
- "Revise as mudanças antes do commit."
- "Leia o README e me diga como rodar o projeto localmente."
Para checar versão:
“powershell codex --version “
Para ver opções de ajuda:
“powershell codex --help “
Codex no Windows precisa de WSL?
Não necessariamente.
Pela documentação da OpenAI, Codex pode rodar nativamente no Windows usando o sandbox do Windows. O WSL2 é útil quando você precisa de um ambiente Linux ou quando seu projeto já depende de ferramentas Linux.
Use Codex nativo no Windows quando:
- seu projeto roda bem no PowerShell;
- você trabalha com arquivos locais no Windows;
- você quer configuração mais simples;
- você não precisa de dependências Linux.
Use WSL2 quando:
- seu projeto já fica em
/home/...; - você usa ferramentas Linux no dia a dia;
- seu stack depende de pacotes que funcionam melhor em Linux;
- o sandbox nativo do Windows não atende sua empresa ou ambiente.
Evite WSL1. A documentação atual aponta WSL2 como o caminho relevante para ambiente Linux no Windows.
Sandbox do Codex no Windows: o que significa?
Quando o Codex roda nativamente no Windows, ele usa sandbox para limitar o que o agente pode acessar ou alterar.
Em linguagem simples: o sandbox ajuda a impedir que uma tarefa de código mexa fora da pasta permitida ou acesse rede sem aprovação.
Na documentação oficial, a OpenAI descreve dois modos nativos no Windows:
- elevated: modo preferido, com configuração mais forte.
- unelevated: fallback quando o modo preferido não está disponível.
Para a maioria dos usuários, você não precisa configurar isso no primeiro dia. Mas é importante entender o conceito: Codex é uma ferramenta poderosa, então permissões e aprovações fazem parte do uso seguro.
Erros comuns ao instalar Codex no Windows
codex não é reconhecido como comando
Provável causa: o terminal ainda não recarregou o PATH.
Como resolver:
- Feche todas as janelas do PowerShell.
- Abra um novo terminal.
- Rode
codex --version. - Se instalou via npm, confirme se o diretório global do npm está no PATH.
O PowerShell bloqueou a instalação
Use o comando completo com ExecutionPolicy ByPass:
“powershell powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex" “
Se estiver em computador corporativo, políticas de segurança podem bloquear scripts externos. Nesse caso, converse com o administrador antes de tentar contornar a regra.
O login não abre no navegador
Tente:
“powershell codex login “
Se você está em ambiente remoto, sem navegador ou com callback local bloqueado, a documentação oficial menciona autenticação por device code em alguns cenários.
Estou no CMD, não no PowerShell
O comando acima foi pensado para PowerShell. Se você abriu o Prompt de Comando antigo, procure por "PowerShell" no menu iniciar ou abra o Windows Terminal.
Instalei via npm, mas o comando não aparece
Confirme se o npm está funcionando:
“powershell npm --version “
Depois confira onde pacotes globais são instalados:
“powershell npm prefix -g “
Se o diretório global do npm não estiver no PATH, o Windows não encontra o comando codex.
O Codex não consegue acessar uma pasta
Se o problema for permissão do sandbox, a documentação oficial mostra o uso de:
“text /sandbox-add-read-dir C:\absolute\directory\path “
Use apenas com diretórios que você realmente quer permitir que o Codex leia durante a sessão.
Codex vs Claude Code no Windows
Codex e Claude Code ocupam um espaço parecido: ambos são agentes de programação que podem trabalhar no terminal.
Mas a decisão prática depende de onde você já está:
| Critério | Codex | Claude Code |
|---|---|---|
| Empresa | OpenAI | Anthropic |
| Comando principal | codex |
claude |
| Login comum | ChatGPT ou API key | Conta Anthropic/plano compatível |
| Windows | Nativo com PowerShell e sandbox do Windows | Nativo com PowerShell/CMD |
| Melhor quando | Você já usa ChatGPT/OpenAI e quer agente local integrado ao ecossistema Codex | Você já usa Claude e quer um agente forte no terminal |
Se quiser comparar melhor ferramentas de programação com IA, veja também o guia Claude Code vs Cursor.
Checklist rápido de instalação
- [ ] Abrir PowerShell.
- [ ] Rodar
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex". - [ ] Fechar e reabrir o terminal.
- [ ] Rodar
codex --version. - [ ] Rodar
codex. - [ ] Fazer login com ChatGPT ou API key.
- [ ] Entrar na pasta de um projeto.
- [ ] Pedir uma tarefa simples antes de delegar algo grande.
Perguntas frequentes
Codex funciona no Windows?
Sim. A documentação oficial da OpenAI informa que o Codex CLI está disponível para macOS, Windows e Linux. No Windows, você pode usar Codex nativamente no PowerShell com sandbox do Windows ou via WSL2 quando precisa de ambiente Linux.
Qual é o comando para instalar Codex no Windows?
O comando de instalação pelo PowerShell é powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex". Depois da instalação, rode codex --version para conferir.
Posso instalar Codex com npm?
Sim. Se você já usa Node.js, pode instalar com npm install -g @openai/codex. Depois confirme com codex --version.
Codex precisa de ChatGPT Plus?
Os planos ChatGPT Plus, Pro, Business, Edu e Enterprise incluem Codex, segundo a documentação oficial. Também é possível usar API key em fluxos locais, mas nesse caso a cobrança segue a conta da OpenAI Platform.
Codex é a mesma coisa que ChatGPT?
Não exatamente. ChatGPT é a interface de conversa. Codex é o agente de programação da OpenAI, feito para trabalhar com código, arquivos, comandos e projetos.
Codex precisa de API key?
Não necessariamente. Você pode usar login com ChatGPT. A API key é uma alternativa útil para uso programático, automações ou cenários em que você quer usar cobrança da OpenAI Platform.
Codex é melhor que Claude Code?
Depende. Codex faz mais sentido se você já usa ChatGPT/OpenAI e quer ficar no ecossistema da OpenAI. Claude Code pode ser melhor se você já trabalha com Claude e prefere o fluxo da Anthropic. O ideal é testar os dois com uma tarefa real no mesmo projeto.