DownloadCodex Guia não oficial
Português (Brasil)

Use o Codex com WSL2 no Windows

Você pode usar o Codex com WSL2 de duas formas. No aplicativo do ChatGPT para desktop, abra Settings, mude o agente de Windows nativo para WSL e reinicie o aplicativo. Ou instale a Codex CLI dentro da sua distribuição WSL2 com o instalador para Linux. O WSL1 não é suportado a partir do Codex 0.115, então converta sua distribuição para WSL2 antes.

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

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.

Antes de começar: confirme que é WSL2

No PowerShell:

wsl -l -v

A coluna VERSION deve mostrar 2. Se mostrar 1, converta a distribuição com wsl --set-version <DistroName> 2. A documentação da OpenAI diz que o WSL1 foi suportado apenas até o Codex 0.114. Veja o erro do WSL1.

Opção A: aplicativo para desktop com o agente no WSL

  1. Abra Settings (configurações) no aplicativo do ChatGPT para desktop.
  2. Mude o agente de Windows native (Windows nativo) para WSL.
  3. Reinicie o aplicativo. A mudança só tem efeito depois disso. Seus projetos continuam onde estão.

O terminal integrado é configurado separadamente. Você pode executar o agente no WSL e continuar usando o PowerShell no terminal, ou usar o WSL para os dois.

Opção B: Codex CLI dentro do WSL2

Abra o shell do seu WSL2 e use o instalador para Linux:

curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex

Compartilhe configuração, login e histórico entre Windows e WSL

O aplicativo do Windows mantém a pasta inicial do Codex em %USERPROFILE%\.codex. Uma CLI dentro do WSL usa ~/.codex por padrão, então os dois não compartilham configurações, autenticação em cache nem sessões. Para compartilhá-los, aponte o WSL para o diretório do Windows:

export CODEX_HOME=/mnt/c/Users/<windows-user>/.codex

Adicione essa linha ao ~/.bashrc ou ao ~/.zshrc para torná-la permanente.

Onde guardar seus projetos

Se você continuar usando o agente Windows-native (nativo do Windows), a OpenAI recomenda guardar os projetos na unidade do Windows e acessá-los pelo WSL via /mnt/<drive>/.... Abrir projetos a partir de \\wsl$\ funciona, mas o Git pode não ser detectado. Veja a correção.

Perguntas frequentes

O WSL é obrigatório para o Codex no Windows?

Não. O Windows nativo é o padrão do aplicativo para desktop, com um sandbox do Windows, e a CLI tem seu próprio instalador para PowerShell. Use o WSL2 só se suas ferramentas já estiverem no Linux.

Por que a CLI no WSL não lembra o login do aplicativo para desktop?

A CLI dentro do WSL usa por padrão seu diretório home do Linux, enquanto o aplicativo do Windows usa %USERPROFILE%\.codex. Aponte o WSL para o diretório do Windows com CODEX_HOME para compartilhar os dois.

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.

Leia a seguir