Windows導入の早見

WindowsでCodexを使う方法|デスクトップアプリとWSL2の選び方

WindowsでCodexを使う道は、ChatGPTデスクトップアプリ(Windowsで直接動かす)と、WSL2の中のCodex CLIの2つが中心です。入れ方のコマンド、設定画面、プロジェクトの置き場所、VS Codeとのつなぎ方、WSL1が使えなくなった点を、OpenAI公式の文書(2026年11月16日確認)に沿って整理します。

このサイトはCodexの公式サイトではありません。公式の文書を元に日本語で整理した解説です。画面の表示や手順は更新されるため、出典と照らして確認してください。

最初に答え

やりたいこと選ぶ道
画面で操作したいChatGPTデスクトップアプリ(Windows版)を入れ、Codexを選ぶ
Linuxの道具をそのまま使いたい・リポジトリがWSL2にあるWSL2の中にCodex CLIを入れる
管理されたPCで制限があるサンドボックスの方式をIT部門と確認する。Windowsサンドボックスを参照

公式によると、デスクトップアプリはPowerShellでWindowsのサンドボックスを使って動かすか、WSL2の中で動かせます。どちらの道でも、サンドボックスの保護を効かせるには、入力欄の下の Ask for approval を選んでから送信します。

デスクトップアプリを入れる

Microsoft Storeから入れるか、PowerShellで次のコマンドを実行します。

winget install --id 9PLM9XGG6VKS -s msstore

入れたあとは、アプリの中で Codex を選んで使います。企業での配布や更新の方法は、公式に「Deploy the Windows app」の案内があります。プロジェクトの追加は Add new project か Ctrl+O です。フォルダの決め方は作業フォルダの指定・変更にまとめています。

入れておくと便利な道具

公式が挙げる推奨の道具は、Git(レビューの画面に必要)、Node.js、Python、.NET SDK、GitHub CLIです。winget で入れられます。

winget install --id Git.Git
winget install --id GitHub.cli
gh auth login

GitHub CLIを入れたあとは、gh auth login でログインします。リポジトリの権限の考え方は複数リポジトリの扱いも参考になります。

アプリの設定画面(Settings)

codex://settings から開く設定には、次の項目があります。

WSL2でCLIを使う

公式の手順です。管理者のPowerShellかWindows Terminalで、まずWSLを入れます。

wsl --install
wsl

WSLのシェルの中で、CLIを入れて起動します。

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

VS Codeでは、WSL用の拡張(ms-vscode-remote.remote-wsl)が必要です。WSLのシェルでプロジェクトに移動して code . を実行すると、WSLのリモートウィンドウが開き、統合ターミナルがLinuxで動きます。接続できているかは、ステータスバーの WSL: <ディストリビューション名>、ターミナルの /home/... というLinuxのパス、echo $WSL_DISTRO_NAME で確かめられます。表示されない時は、Ctrl+Shift+P から WSL: Reopen Folder in WSL を選びます。

プロジェクトの置き場所と速さ

WSLでCLIを使う時、公式はリポジトリをLinuxのホームの下に置くよう案内しています。/mnt/c/... のようなWindowsのドライブの下は遅く、シンボリックリンクや権限の問題が出やすいためです。

mkdir -p ~/code && cd ~/code
git clone https://github.com/your/repo.git
cd repo

WindowsからWSLのファイルを見るには、エクスプローラーで \\wsl$\Ubuntu\home\<ユーザー名> を開きます。Windowsのアプリでプロジェクトの選択画面にWSLのリポジトリが出ない時も、ファイル選択に \\wsl$ と入力して、ディストリビューションのホームへ進みます。

ただし、アプリで \\wsl$ から開いたプロジェクトは、Gitが検出されない、と公式は説明しています。その場合は、プロジェクトをWindowsのドライブに置き、WSLから /mnt/<ドライブ>/... でアクセスする方法が案内されています。

遅い・動かない時の確認

wsl --update
wsl --shutdown

設定やログインの情報は、WindowsアプリとWSLで別の場所を使うため、そのままでは共有されません。共有のしかたは.codexフォルダの場所で整理しています。

WSL2を選ぶ目安

公式は、WSL2を使う場面を3つ挙げています。Linux向けの道具をそのまま使いたい時、リポジトリがすでにWSL2の中にある時、Windowsのサンドボックスが目的に合わない時です。WSL2ではCodexがLinuxの中で動くため、Windowsのサンドボックスの方式(mxc・elevated・unelevated)の代わりに、Linuxのサンドボックスが使われます。

WSL1は、Codex 0.114まで対応でした。0.115からLinuxのサンドボックスに bubblewrap を使うようになり、WSL1は対応しなくなりました。古いPCでWSL1のままの時は、WSL2へ切り替えてから使います。

CLIの入れ場所と更新

スタンドアロンのインストールスクリプトでは、環境変数で入れ先を変えられます。公式の環境変数の一覧では、CODEX_INSTALL_DIR が codex コマンドの入れ先で、既定はmacOS・Linuxで ~/.local/bin、Windowsで %LOCALAPPDATA%\Programs\OpenAI\Codex\bin です。CODEX_NON_INTERACTIVE に 1・true・yes を入れると、インストーラーの質問を飛ばせます。これはスクリプトでの導入や更新向けで、初回の設定には向きません。更新は、入れる時と同じコマンドで行うと案内されています。

コマンドラインからアプリを開きたい時は、codex app [PATH] が使えます。公式によると、macOSではそのフォルダをCodexで開き、Windowsではパスが表示されます。

よくある質問

WSL1でも使えますか。

公式によると、WSL1はCodex 0.114まで対応でした。0.115からLinuxのサンドボックスが bubblewrap になったため、WSL1は対応していません。WSL2を使います。

VS Codeが codex を見つけられません。

WSLの中で which codex を実行し、見つからなければCLIの入れ方の手順をWSLの中でやり直します。

プロジェクトはどこに置くのがよいですか。

WSLでCLIを使う時は、Linuxのホームの下(~/code など)が速く、/mnt/c の下はシンボリックリンクや権限の問題が出やすいと公式が説明しています。

関連ページ

出典と確認日

出典は公式の文書です。手順や画面の表示は更新されることがあるため、迷ったら出典を優先してください。

EDITED & REVIEWED

編集・検証情報

編集責任
運営者 ちんあなご編集部
書き方の基準
編集・検証方針
最終確認
(公式の情報と照らした日)
更新履歴
(公開)

公式情報、実際の操作で確かめたこと、運営者の判断を区別して記載しています。サービスの画面、料金、利用上限、提供地域は変わる場合があるため、重要な操作の前に公式資料と現在の画面を確認してください。