WSL

WSL2 を使うと、Codex はネイティブの Windows サンドボックスを使わず、Linux 環境内で動作します。Linux ネイティブのツールが必要な場合、すでに WSL2 にリポジトリを置いて開発している場合、または利用可能な Windows サンドボックスの実装が要件を満たさない場合は、WSL2 を選んでください。

Codex 0.114 までは WSL1 をサポートしていました。Codex 0.115 で Linux サンドボックスが bubblewrap に移行したため、以降のバージョンでは WSL1 をサポートしていません。

WSL からの VS Code の起動

詳しい手順は、VS Code 公式の WSL チュートリアルを参照してください。

前提条件

• WSL をインストールした Windows。WSL をインストールするには、PowerShell を管理者として開き、wsl --install を実行します（ディストリビューションには Ubuntu がよく使われます）。
• WSL 拡張機能をインストールした VS Code

WSL ターミナルからの VS Code の起動手順

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

これで WSL にリモート接続したウィンドウが開き、必要に応じて VS Code Server がインストールされます。このウィンドウの統合ターミナルは Linux 上で動作します。

WSL への接続確認

• 緑色のステータスバーに WSL: <distro> と表示されていることを確認します。

• 統合ターミナルには、Linux のパス（/home/... など）が表示されます。C:\ が表示されている場合は、Windows 側のパスです。

• 次のコマンドでも確認できます。

  echo $WSL_DISTRO_NAME

  使用中のディストリビューション名が表示されます。

WSL での Codex CLI の使用

PowerShell または Windows ターミナルを管理者として開き、次のコマンドを実行します。

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

# Start a shell inside Windows Subsystem for Linux
wsl

続いて、WSL のシェルで次のコマンドを実行します。

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

WSL 内でのコードの編集

• /mnt/c/... のように Windows のドライブをマウントしたパスで作業すると、Windows ネイティブのパスで作業する場合より遅くなることがあります。リポジトリを Linux のホームディレクトリ配下（~/code/my-app など）に置くと、I/O が速くなり、シンボリックリンクや権限に関する問題も起きにくくなります。

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

• Windows からファイルにアクセスするには、エクスプローラーで \wsl$\Ubuntu\home<user> を開きます。

トラブルシューティングとよくある質問

which codex || echo "codex not found"