Windows導入の早見
WindowsでCodexを使う方法|デスクトップアプリとWSL2の選び方
WindowsでCodexを使う道は、ChatGPTデスクトップアプリ(Windowsで直接動かす)と、WSL2の中のCodex CLIの2つが中心です。入れ方のコマンド、設定画面、プロジェクトの置き場所、VS Codeとのつなぎ方、WSL1が使えなくなった点を、OpenAI公式の文書(2026年11月16日確認)に沿って整理します。
最初に答え
| やりたいこと | 選ぶ道 |
|---|---|
| 画面で操作したい | 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 loginGitHub CLIを入れたあとは、gh auth login でログインします。リポジトリの権限の考え方は複数リポジトリの扱いも参考になります。
アプリの設定画面(Settings)
codex://settings から開く設定には、次の項目があります。
- Agent environment:「Windows native」(Windowsで実行)か「Windows Subsystem for Linux」(WSLの中で実行)。切り替えにはアプリの再起動が必要
- Integrated terminal shell:PowerShell・コマンドプロンプト・Git Bash・WSLから選ぶ。変更は新しい端末のセッションから
- Language:英語か自動検出
- Thread detail:会話にコマンドの出力をどこまで出すか
- Preferred editor:Openボタンの既定のアプリ(Visual Studio・VS Code・エクスプローラーなど)。プロジェクトごとにOpenのメニューで選んだものが優先される
WSL2でCLIを使う
公式の手順です。管理者のPowerShellかWindows Terminalで、まずWSLを入れます。
wsl --install
wslWSLのシェルの中で、CLIを入れて起動します。
curl -fsSL https://chatgpt.com/codex/install.sh | sh
codexVS 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 repoWindowsからWSLのファイルを見るには、エクスプローラーで \\wsl$\Ubuntu\home\<ユーザー名> を開きます。Windowsのアプリでプロジェクトの選択画面にWSLのリポジトリが出ない時も、ファイル選択に \\wsl$ と入力して、ディストリビューションのホームへ進みます。
ただし、アプリで \\wsl$ から開いたプロジェクトは、Gitが検出されない、と公式は説明しています。その場合は、プロジェクトをWindowsのドライブに置き、WSLから /mnt/<ドライブ>/... でアクセスする方法が案内されています。
遅い・動かない時の確認
- 大きなリポジトリが遅いときは、
/mnt/cの下から、WSLのホームの下へ移します - WSLのメモリやCPUの割り当てを増やします
- WSLを更新して再起動します
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 の下はシンボリックリンクや権限の問題が出やすいと公式が説明しています。
関連ページ
出典と確認日
- OpenAI Learn: Windowsのデスクトップアプリ(winget・設定・WSLのプロジェクト)
- OpenAI Learn: WSLでCodexを使う
- OpenAI Learn: Codex CLI(インストールコマンド)
- 確認日: 2026年11月16日
出典は公式の文書です。手順や画面の表示は更新されることがあるため、迷ったら出典を優先してください。
