WSL

WSL2 を使用すると、Codex は Linux 環境内で実行され、 ネイティブの Windows サンドボックス は使用しません。Linux ネイティブの ツールが必要な場合、リポジトリと開発ワークフローがすでに WSL2 内にある場合、または Windows ネイティブの 2 種類のサンドボックスモードのどちらもお使いの環境で動作しない場合は、WSL2 を選択してください。

WSL1 は Codex 0.114 までサポートされていました。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> と表示されていることを確認します。

• 統合ターミナルには、/home/... などの Linux パスが表示され、C:\ は表示されないはずです。

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

  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 内でのコード作業

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

  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"