DownloadCodex 非公式ガイド
日本語

Windows の WSL2 で Codex を使う

WSL2 で Codex を使う方法は 2 つあります。ChatGPT デスクトップアプリで Settings を開き、エージェントを Windows native から WSL に切り替えてアプリを再起動する方法と、Linux 用インストーラーで WSL2 ディストリビューション内に Codex CLI をインストールする方法です。Codex 0.115 以降は WSL1 に対応していないため、先にディストリビューションを WSL2 に変換してください。

対象： Windows 11, WSL2, ChatGPT デスクトップアプリ, Codex CLI

このページは英語版ガイドの翻訳です。コマンドとファイル名は変更していません。両者の内容が食い違う場合は、英語版のページと公式ソースが優先されます。

始める前に：WSL2 であることを確認する

PowerShell から次のコマンドを実行します。

wsl -l -v

VERSION 列が 2 になっている必要があります。1 になっている場合は、wsl --set-version <DistroName> 2 でディストリビューションを変換してください。OpenAI のドキュメントによると、WSL1 は Codex 0.114 までしか対応していませんでした。WSL1 のエラーもご覧ください。

方法 A：デスクトップアプリのエージェントを WSL で実行する

  1. ChatGPT デスクトップアプリで Settings（設定）を開きます。
  2. エージェントを Windows native から WSL に切り替えます。
  3. アプリを再起動します。 再起動するまで変更は反映されません。プロジェクトはそのまま残ります。

統合ターミナルは別に設定します。エージェントを WSL で実行しながらターミナルでは PowerShell を使うことも、両方で WSL を使うこともできます。

方法 B：WSL2 内で Codex CLI を使う

WSL2 のシェルを開き、Linux 用インストーラーを使います。

curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex

Windows と WSL の間で設定、サインイン、履歴を共有する

Windows アプリは Codex のホームを %USERPROFILE%\.codex に置いています。WSL 内の CLI はデフォルトで ~/.codex を使うため、両者の間では設定、キャッシュされた認証情報、セッションが共有されません。共有するには、WSL から Windows 側のディレクトリを参照するように設定します。

export CODEX_HOME=/mnt/c/Users/<windows-user>/.codex

この設定を恒久的にするには、この行を ~/.bashrc または ~/.zshrc に追加してください。

プロジェクトの置き場所

Windows ネイティブのエージェントを使い続ける場合、OpenAI はプロジェクトを Windows のドライブに保存し、WSL からは /mnt/<drive>/... 経由でアクセスすることを推奨しています。\\wsl$\ からプロジェクトを開くこともできますが、Git が検出されない場合があります。解決方法をご覧ください。

よくある質問

Windows で Codex を使うには WSL が必須ですか？

いいえ。デスクトップアプリのデフォルトは Windows サンドボックス付きのネイティブ Windows で、CLI にも専用の PowerShell インストーラーがあります。WSL2 は、ツールチェーンがすでに Linux 上にある場合にだけ使ってください。

WSL の CLI がデスクトップアプリのログイン状態を引き継がないのはなぜですか？

WSL 内の CLI はデフォルトで Linux のホームディレクトリを使い、Windows アプリは %USERPROFILE%\.codex を使います。共有するには、CODEX_HOME で WSL から Windows 側のディレクトリを参照するように設定してください。

情報源

このページのすべての手順について、公式ソースへのリンクを掲載しています。内容が公式ソースと食い違う場合は公式ソースを優先し、お知らせください。

次に読む