WSL

Quando utiliza o WSL2, o Codex é executado no ambiente Linux em vez de utilizar a área restrita do Windows nativa. Escolha o WSL2 quando precisar de ferramentas nativas do Linux, quando os seus repositórios e o fluxo de trabalho de desenvolvimento já estiverem no WSL2 ou quando nenhum dos modos de área restrita nativa do Windows funcionar no seu ambiente.

O WSL1 foi suportado até ao Codex 0.114. A partir do Codex 0.115, a área restrita do Linux passou a utilizar bubblewrap, pelo que o WSL1 deixou de ser suportado.

Iniciar o VS Code a partir do WSL

Para obter instruções passo a passo, consulte o tutorial oficial do VS Code sobre WSL.

Pré-requisitos

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

Abrir o VS Code a partir de um terminal WSL

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

Isto abre uma janela remota do WSL, instala o VS Code Server, se necessário, e garante que os terminais integrados são executados no Linux.

Confirmar que está ligado ao WSL

• Procure a barra de estado verde que apresenta WSL: <distro>.
• Os terminais integrados devem apresentar caminhos do Linux (como /home/...) em vez de C:\.
• Pode confirmar com:

  echo $WSL_DISTRO_NAME

Isto apresenta o nome da sua distribuição.

Se não vir "WSL: ..." na barra de estado, prima Ctrl+Shift+P, selecione WSL: Reopen Folder in WSL e mantenha o seu repositório em /home/... (não em C:\) para obter o melhor desempenho.

Se a aplicação do Windows ou o seletor de projetos não apresentar o seu repositório WSL, introduza \\wsl$ no seletor de ficheiros ou no Explorador e, em seguida, navegue até ao diretório inicial da sua distribuição.

Utilizar o Codex CLI com o WSL

Execute estes comandos num PowerShell ou Windows Terminal com privilégios elevados:

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

# Start a shell inside Windows Subsystem for Linux
wsl

Em seguida, execute estes comandos na sua shell do WSL:

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

Trabalhar em código no WSL

• Trabalhar em caminhos montados pelo Windows, como /mnt/c/..., pode ser mais lento do que trabalhar em caminhos nativos do Windows. Mantenha os seus repositórios no diretório inicial do Linux (como ~/code/my-app) para obter operações de E/S mais rápidas e menos problemas com ligações simbólicas e permissões:

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

• Se precisar de aceder aos ficheiros a partir do Windows, estes encontram-se em \\wsl$\Ubuntu\home\<user> no Explorador.

Resolução de problemas e perguntas frequentes

Os repositórios grandes parecem lentos no WSL

• Certifique-se de que não está a trabalhar em /mnt/c. Mova o repositório para o WSL (por exemplo, ~/code/...).
• Aumente a memória e a CPU do WSL, se necessário; atualize o WSL para a versão mais recente:

  wsl --update
  wsl --shutdown

O VS Code no WSL não consegue encontrar o codex

Confirme que o binário existe e está em PATH no WSL:

which codex || echo "codex not found"

Se o binário não for encontrado, siga as instruções de configuração do Codex CLI.