コンテンツにスキップ

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:\ ではなく、/home/... などの Linux パスが表示されます。
  • 次のコマンドで確認できます。
echo $WSL_DISTRO_NAME

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

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

Windows アプリまたはプロジェクトピッカーに WSL リポジトリが表示されない場合は、ファイルピッカーまたは Explorer に \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 を高速化し、シンボリックリンクや権限に関する問題を減らすため、リポジトリは ~/code/my-app のように Linux のホームディレクトリ配下に置いてください。 
    mkdir -p ~/code && cd ~/code
git clone https://github.com/your/repo.git
cd repo
  • Windows からファイルにアクセスする必要がある場合は、Explorer で \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 のセットアップ手順に従ってください。