WSL で Windows 上で CodeX を実行する方法

Ashley Goolam

Ashley Goolam

18 9月 2025

WSL で Windows 上で CodeX を実行する方法

Linuxディストリビューションのデュアルブートやクラウド依存の煩わしさなしに、OpenAIの最新コーディングツールのパワーを活用できたらと願ったことはありませんか?さあ、シートベルトを締めてください。WSL(Windows Subsystem for Linux)を使えば、WindowsでCodexを実行するのがずっと簡単になりました。WSL経由のWindows上のCodexは、Codex CLI、つまりターミナル内で動作するOpenAIの軽量なオープンソースコーディングエージェントを活用したい開発者にとって、まさにゲームチェンジャーです。2025年に発表されたCodex CLIは、GPT-5のようなモデルの知能をローカル環境にもたらし、コードの生成、バグのデバッグ、さらにはコマンドの安全な実行までを支援します。アプリの構築、スクリプトの調整、あるいは単にWSL上のCodexの探索であっても、このセットアップがあれば、Windows環境から離れることなくすべてを実行できます。この対話形式のガイドでは、WSLの初期設定からCodex CLIの起動、そして実際に動作させるまでをすべてご紹介します。読み終える頃には、あなたはCodexと旧友のように会話できるようになり、その素晴らしいWindows上のCodex体験のためにワークフローを最適化していることでしょう。さあ、始めましょう!

💡
美しいAPIドキュメントを生成する優れたAPIテストツールをお探しですか?

開発チームが最高の生産性で共同作業できる統合されたオールインワンプラットフォームをお探しですか?

Apidogはあなたのすべての要求に応え、Postmanをはるかに手頃な価格で置き換えます
button
Apidogユーザーインターフェース

Codex CLIとは何か、そしてなぜWSLで実行するのか?

実際に作業に取り掛かる前に、まずCodexが実際に何であるかについて話しましょう。Codex CLIは、OpenAIのオープンソースのコマンドラインツールで、ターミナルから直接コーディングエージェントとして機能します。自然言語のリクエストを理解し、コードベースを読み込み、編集を提案し、コマンドを実行し、さらにはスクリーンショットのようなマルチモーダルな入力も処理できるように設計されています。高度なモデル(GPT-5を想像してください)によって駆動され、ローカルで実行されるため、共有を選択しない限りコードはプライベートに保たれます。エディタやクラウドサービスを切り替える必要はもうありません。Codexは開発フローにシームレスに統合されます。

では、なぜWindows上のCodexWSLを使用するのでしょうか?2025年9月現在、Codex CLIのWindowsサポートはまだ実験段階であり、ネイティブインストールではサンドボックスやパーミッションの問題でバグが発生する可能性があります。MicrosoftのWindows上のLinuxレイヤーであるWSLは、WSL上のCodexが繁栄できる安定したLinuxライクな環境を提供します。Windowsのパスやシェルの癖を回避できるため、このようなNode.jsベースのツールに最適です。さらに、WSLを使用すると、コーディングにはLinuxのパワー、それ以外のすべてにはWindowsの使い慣れた環境という、両方の良いとこ取りができます。バイブコーディングやエージェント開発に興味があるなら、WSL上のCodexは頭痛の種なしで生産性を向上させるための切符となるでしょう。

Codex CLI

WindowsでのWSLの始め方

それでは、スムーズなWindows上のCodexの航海のための基盤となるWSLのセットアップから始めましょう。WSLを使用すると、仮想マシンを必要とせずに、ターミナルアクセスを含め、Windows内で完全なLinuxディストリビューションを実行できます。2025年9月18日現在、最新バージョンはWSL 2で、パフォーマンス向上のために軽量VMを使用しています。

設定方法は次のとおりです。

Windows機能の有効化: Windowsのスタートメニューを開き、「Windowsの機能の有効化または無効化」を検索します(または単に「機能」と入力します)。表示されるダイアログで、下にスクロールして「仮想マシンプラットフォーム」と「Linux用Windowsサブシステム」のチェックボックスをオンにします。これらはWSL 2のサポートに不可欠です。これらがないと、レガシーモードに留まってしまいます。「OK」をクリックし、Windowsがコンポーネントをインストールするのを待ちます。PCの再起動が必要になる場合があります。

Windows機能の有効化

WSLステータスの確認: 新しいコマンドプロンプトまたはPowerShellを開きます(スタートメニューで「cmd」または「powershell」を検索します)。wsl --statusと入力してEnterキーを押します。すべてが順調であれば、「Default Version: 2」のような表示が見えるはずです。バージョン1と表示されたりエラーが出たりしても、心配しないでください。次のステップに進みます。

WSLの更新: ターミナルで、wsl --updateを実行します。これにより、WSL 2の最新カーネルと修正が取得されます。数分かかるかもしれませんが、完了したら、再度wsl --statusを実行して確認します。ほら!WSLの準備が整いました。プロのヒント:Windows 11を使用している場合、組み込みのGUIアプリサポートによりさらにスムーズですが、Windows 10でも問題なく動作します。

WSLステータスの確認とWSLの更新

WSLが正常に動作していれば、Linuxディストリビューションをインストールし、WSL上のCodexへの橋渡しをする準備が整います。

WSLにLinuxディストリビューションをインストールする

WSLが有効になったので、今度はLinuxのフレーバーを導入します。これは、WSL上のCodexが動作するOSをインストールするようなものだと考えてください。Microsoft Storeを使えば非常に簡単で、USBスティックは必要ありません。

このガイドでは、安定性と広範なパッケージエコシステムから開発者に人気の高いUbuntuを使用します。しかし、セキュリティテストにはKaliを、ミニマリズムにはDebianを選ぶのも自由です。

WSLにLinuxディストリビューションをインストールする

Microsoft Storeにアクセス: Microsoft Storeアプリを開きます(スタートメニューで検索)。検索バーに「Ubuntu」または「Kali Linux」のようなお好みのディストリビューションを入力します。オプションが表示されるので、最新のUbuntu(信頼性のために22.04 LTSなど)を入手してください。

Microsoft StoreにアクセスしてUbuntuをインストールする

インストールと起動: 「インストール」をクリックし、ダウンロードが完了するまで待ちます(約500MBです)。完了したら、「開く」をクリックするか、スタートメニューから起動します。ターミナルウィンドウがポップアップし、Ubuntuが初期化されます。ファイルシステムのセットアップに数分かかる場合があります。

インストールと起動

ユーザーのセットアップ: Ubuntuユーザーのユーザー名とパスワードを作成するよう求められます。シンプルかつ安全なものにしてください(入力中はパスワードは表示されません)。これは、Codex CLIを含むコマンドを実行するためのあなたのLinux IDとなります。

Ubuntuのユーザー名とパスワードを設定する

動作確認: Ubuntuターミナルでlsと入力してファイルの一覧を表示してみてください(ホームディレクトリが表示されるはずです)。動作すれば、おめでとうございます。LinuxディストリビューションがWSLにインストールされました!uname -aを実行して、WSL 2で実行されていることを確認してください。これで、Node.jsとWSL上のCodexの準備がすべて整いました。

「WSLが見つかりません」のような問題が発生した場合は、機能が有効になっていることを再確認し、再起動してください。高度な調整を行うには、Ubuntu内で/etc/wsl.confを編集してデフォルトを設定します。

WSLにNode.jsをインストールする

Codex CLIはnpmパッケージなので、WSL環境にNode.js(npmをバンドルしています)をインストールする必要があります。Ubuntuでは簡単ですが、落とし穴を避けるためにステップバイステップで進めましょう。

パッケージの更新: まず、リポジトリを更新します: sudo apt update && sudo apt upgrade -y。プロンプトが表示されたらパスワードを入力します。これによりUbuntuは最新の状態に保たれます。

curlのインストール: WSL上のCodexはNVM(Node Version Manager)経由でNodeに依存しており、NVMにはcurlが必要です。sudo apt install curl -yを実行します。

NVMのインストール: NVMを使えばNodeのバージョン管理が簡単になります。これを貼り付けてください: curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash。(注:必要に応じてnvmのGitHubで最新バージョンを確認してください。)これによりインストーラーがダウンロードされ、実行されます。

NVMの有効化: Ubuntuターミナルを閉じて再度開くか、source ~/.bashrcを実行してNVMをロードします。command -v nvmで検証し、成功すれば「nvm」と出力されるはずです。

Node.jsのインストール: NVMを使用してLTSバージョンを取得します: nvm install --lts。これによりNodeとnpmがインストールされます。最新バージョン(Codex CLIにはNode 22+が推奨されます)の場合は、nvm install nodeを実行します。必要に応じてnvm use nodeでバージョンを切り替えます。

インストールの確認: node --version(インストールしたv20+などが表示されるはずです)とnpm --versionを実行します。両方とも動作すれば、NodeはWSLで準備完了です!このセットアップにより、WindowsのNodeの競合なしに、Windows上のCodexがネイティブのように感じられます。

Nodeとnpmのインストールを確認する

トラブルシューティングですか?NVMが見つからない場合は、インストーラーによって追加されたエクスポート行が.bashrcにあるか確認してください。

WSLでのCodex CLIのインストールと使用

待ちに待った瞬間です。WSLCodexを動かしましょう。Nodeがセットアップされていれば、Codex CLIのインストールはワンライナーですが、楽しみのためにデモプロジェクトを作成しましょう。

デモフォルダの作成: Ubuntuのホームディレクトリ(/home/yourusername)で、mkdir codex-cli-demoを実行します(名前は何でも構いません)。次に、cd codex-cli-demoでそのフォルダに入ります。これにより、WSL上のCodexのテストが整理されます。

グローバルインストール: npm install -g @openai/codexを実行します。これによりnpmから最新版が取得されます。依存関係のダウンロードに数分かかる場合があります(2025年9月現在、バージョン0.25.0+が安定しています)。

Codexの実行: ターミナルでcodexと入力するだけです。Codex CLIがインタラクティブUIを起動します。初回セットアップ時には認証を促されます。

WindowsのWSLでCodexを実行する

認証: オプションがいくつかあります。ChatGPTアカウントでサインインするか(Plus/Proユーザーに推奨)、APIキーを使用します。このデモではChatGPTを使用します。リンクが提供されます。WSLでは、特に設定しない限りブラウザは自動的に開きます(提供されたリンクを使用します)。まずWSLユーティリティをインストールします。PowerShell(Windows側)で、まだ行っていない場合はwsl --install -d Ubuntuを実行し、次にUbuntuでsudo apt install wslu -yを実行します。これで、codexを実行すると、リンクがWindowsブラウザで開きます。ChatGPTにログインします(GPT-5アクセスには有料プランが必要です。無料ティアは制限されています)。承認すれば完了です!

Codex CLIを認証する

基本的な使用法: 実行されたら、「Hello World用のシンプルなPythonスクリプトを作成して」のようにCodexとチャットします。ディレクトリを読み込み、コードを生成し、承認されれば実行もします。アイデアを得るには--suggestのようなモードを、手放しで実行するには--full-autoを使用します(注意して使用してください)。codex --versionで確認します。

APIキー認証の場合: .bashrcexport OPENAI_API_KEY=yourkeyをエクスポートし、codexを実行します。有料プランではプレミアムモデル(gpt-5)がアンロックされるため、必要に応じてopenai.comでアップグレードしてください。

OpenAIプランをアップグレードする

WSL上のCodexに関するヒントとトラブルシューティング

WSL上のCodexはほとんどスムーズに動作しますが、いくつかプロのアドバイスがあります。

GitHubリポジトリ(github.com/openai/codex)で~/.codex/config.toml内の設定を確認し、モデルや動作を調整してください。

結論: WSLでWindows上のCodexを選ぶ理由

WSL上のCodexを受け入れることは、妥協することなくWindowsでAIコーディングの魔法を解き放つことを意味します。ローカルで、プライベートで、パワフルであり、macOSへの羨望に疲れたWindows開発者にとって完璧です。WSLを使えば、Linuxツールに対しても将来にわたって対応できます。飛び込んで、実験し、Codexがあなたのターミナルをコーディングの強力なツールに変えるのを見てください!

button
Apidogをダウンロード

ApidogでAPIデザイン中心のアプローチを取る

APIの開発と利用をよりシンプルなことにする方法を発見できる