WSL

Quando você usa o WSL2, o Codex é executado no ambiente Linux em vez de usar o sandbox nativo do Windows. Escolha o WSL2 se precisar de ferramentas nativas do Linux, se seus repositórios e seu fluxo de desenvolvimento já estiverem no WSL2 ou se as implementações de sandbox disponíveis no Windows não atenderem às suas necessidades.

O Codex oferecia suporte ao WSL1 até a versão 0.114. A partir do Codex 0.115, o sandbox do Linux passou a usar bubblewrap e, por isso, o Codex deixou de oferecer suporte ao WSL1.

Inicie o VS Code pelo WSL

Para ver o passo a passo, consulte o tutorial oficial do VS Code sobre o WSL.

Pré-requisitos

• Windows com o WSL instalado. Para instalar o WSL, abra o PowerShell como administrador e execute wsl --install (o Ubuntu é uma escolha comum).
• VS Code com a extensão WSL instalada.

Abra o VS Code pelo terminal do WSL

# From your WSL shell
cd ~/code/your-project
code .

Esse comando abre uma janela remota conectada ao WSL, instala o VS Code Server se necessário e garante que os terminais integrados sejam executados no Linux.

Confirme a conexão com o WSL

• Verifique se a barra de status verde mostra WSL: <distro>.

• Os terminais integrados devem exibir caminhos do Linux (como /home/...) em vez de C:\.

• Você também pode verificar a conexão com este comando:

  echo $WSL_DISTRO_NAME

  O comando exibe o nome da sua distribuição.

Use a CLI do Codex com o WSL

Abra o PowerShell ou o Terminal do Windows como administrador e execute estes comandos:

# Install default Linux distribution (like Ubuntu)
wsl --install

# Start a shell inside Windows Subsystem for Linux
wsl

Em seguida, execute estes comandos no shell do WSL:

# Install and run Codex in WSL
curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex

Trabalhe com código no WSL

• Trabalhar em caminhos de unidades do Windows montadas no WSL, como /mnt/c/..., pode ser mais lento do que trabalhar em caminhos nativos do Windows. Mantenha seus repositórios no diretório pessoal do Linux (por exemplo, em ~/code/my-app) para agilizar as operações de leitura e gravação e reduzir a ocorrência de problemas com links simbólicos e permissões:

  mkdir -p ~/code && cd ~/code
  git clone https://github.com/your/repo.git
  cd repo

• Se precisar acessar os arquivos pelo Windows, abra \wsl$\Ubuntu\home<user> no Explorador de Arquivos.

Solução de problemas e perguntas frequentes

which codex || echo "codex not found"