WSL

WSL2 を使用すると、Codex はネイティブの Windows サンドボックスではなく Linux 環境内で実行されます。Linux ネイティブのツールが必要な場合、リポジトリと開発ワークフローがすでに WSL2 上にある場合、またはどちらのネイティブ Windows サンドボックスモードも環境で動作しない場合は、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> と表示される緑色のステータスバーを確認します。
統合ターミナルには、C:\ ではなく Linux のパス（/home/... など）が表示されます。
次のコマンドで確認できます。

  echo $WSL_DISTRO_NAME

ディストリビューション名が出力されます。

ステータスバーに「WSL: ...」が表示されない場合は、Ctrl+Shift+P を押して WSL: Reopen Folder in WSL を選択し、最高のパフォーマンスを得るためにリポジトリを /home/...（ C:\ ではありません）配下に置いてください。

Windows アプリまたはプロジェクトピッカーに WSL リポジトリが表示されない場合は、ファイルピッカーまたはエクスプローラーに \\wsl$ と入力し、ディストリビューションのホームディレクトリへ移動します。

WSL で Codex CLI を使用する

昇格された PowerShell または Windows Terminal から、次のコマンドを実行します。

# 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 ネイティブパスでの作業より遅くなる場合があります。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> 配下にあります。

トラブルシューティングと FAQ

WSL で大規模なリポジトリの動作が遅い

/mnt/c 配下で作業していないことを確認します。リポジトリを WSL（~/code/... など）に移動してください。
必要に応じて WSL のメモリと CPU を増やし、WSL を最新バージョンに更新します。

  wsl --update
  wsl --shutdown

WSL の VS Code で codex が見つからない

バイナリが存在し、WSL 内の PATH に含まれていることを確認します。

which codex || echo "codex not found"

バイナリが見つからない場合は、Codex CLI のセットアップ手順に従ってください。

最近の検索

おすすめの検索

ドキュメントナビゲーション