Baixe o Codex para Windows

No Windows, instale a Codex CLI em uma nova janela do PowerShell com o instalador oficial de uma linha do chatgpt.com. Para um aplicativo para desktop, instale o aplicativo do ChatGPT para desktop pela Microsoft Store ou execute winget install --id 9PLM9XGG6VKS -s msstore. O aplicativo para desktop executa o Codex nativamente no PowerShell com um sandbox do Windows, ou dentro do WSL2 se você mudar essa opção.

Aplica-se a: Windows 11, Codex CLI, ChatGPT desktop app

Esta página é uma tradução do guia em inglês. Comandos e nomes de arquivos não foram alterados. Se as duas versões divergirem, valem a página em inglês e as fontes oficiais.

Opção 1: Codex CLI com o instalador oficial

Abra uma nova janela do PowerShell e execute:

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

Execute o mesmo comando depois para atualizar. Abra um novo terminal, vá até a pasta do seu projeto e execute codex. Na primeira vez, escolha Sign in with ChatGPT (entrar com o ChatGPT).

Você também pode instalar com o npm (npm install -g @openai/codex) se já usa Node.js no Windows.

Opção 2: O aplicativo do ChatGPT para desktop da Microsoft Store

A OpenAI distribui o aplicativo para desktop do Windows pela Microsoft Store:

winget install --id 9PLM9XGG6VKS -s msstore

Depois abra o aplicativo, faça login, adicione um projeto e escolha Codex.

Windows nativo ou WSL2?

Por padrão, o aplicativo para desktop usa o agente do Codex nativo do Windows. Os comandos são executados no PowerShell, protegidos por um sandbox nativo do Windows quando você seleciona Ask for approval (pedir aprovação) abaixo da caixa de mensagem. Se preferir que o agente rode no Linux, abra Settings (configurações), mude o agente de Windows nativo para WSL e reinicie o aplicativo.

A recomendação da OpenAI para o agente nativo é manter os projetos no sistema de arquivos do Windows e acessá-los pelo WSL via /mnt/<drive>/.... Abrir projetos diretamente de \\wsl$\ é menos confiável. Passo a passo completo: Codex com WSL2.

Ferramentas úteis para instalar antes

O Codex funciona melhor com algumas ferramentas de desenvolvimento já instaladas. A documentação da OpenAI para Windows sugere:

winget install --id Git.Git
winget install --id OpenJS.NodeJS.LTS
winget install --id GitHub.cli

O Git alimenta o painel de revisão. Node.js e Python ajudam o agente a trabalhar de forma eficiente. Depois de instalar o GitHub CLI, execute gh auth login para habilitar os recursos do GitHub.

Executar o Codex no modo de acesso total significa que ele não fica limitado à pasta do seu projeto. A OpenAI alerta que isso pode levar a ações destrutivas e perda de dados. Mantenha o sandbox ativado, a menos que tenha um motivo específico.

Perguntas frequentes

Preciso do WSL para usar o Codex no Windows?

Não. O aplicativo do ChatGPT para desktop e o instalador avulso da CLI suportam o Windows nativo, com os comandos sendo executados no PowerShell. O WSL2 é opcional. Use-o se seus projetos e ferramentas já estiverem no Linux.

O Codex suporta o WSL1?

Não. Segundo a documentação da OpenAI para Windows, o WSL1 foi suportado até o Codex 0.114. A partir da 0.115, o sandbox do Linux passou a usar o bubblewrap, então você precisa do WSL2.

Por que o PowerShell diz que a execução de scripts está desabilitada?

É a política de execução do PowerShell. Veja nossa correção para o erro 'cannot be loaded because running scripts is disabled' antes de alterar qualquer configuração do sistema.

Fontes

Indicamos a fonte oficial de cada instrução desta página. Se algo aqui divergir delas, confie na fonte oficial e avise a gente.