はじめに
「OpenAIのCodex CLIを使ってみたいけど、Windowsでのインストール方法が分からない…」
「npm installって書いてあるけど、そもそもNode.jsが必要なの？WSLは必須？」
Codex CLIはClaude Code・Gemini CLIと並ぶ主要なターミナル型AIエージェントですが、Windows環境ではインストール方法が複数あり、どれを選べばいいか迷いやすいツールです。 誤って無関係な codex パッケージをインストールしてしまう、PATHが通らず codex コマンドが認識されない、といったつまずきも報告されています。
本記事の手順通りに進めれば、Windows環境で15〜20分程度でCodex CLIが使える状態になります。 Codex CLIの概要や料金体系については別記事で解説済みのため、本記事ではWindowsへの導入・初期設定・動作確認の手順に絞って詳しく解説します。
この記事で分かること
- Codex CLIのWindows向けインストール方法（npm経由を中心に3パターン）
- Node.jsのバージョン要件と確認方法
- ChatGPTアカウント認証・APIキー認証の設定手順
- config.tomlの配置場所と基本設定
- 動作確認の具体的なコマンド例
- よくあるエラーと解決方法（PATH・実行ポリシー・パッケージ誤認識など）
こんな人におすすめ
- Codex CLIをWindows環境で初めてインストールする人
npm install -g @openai/codexを実行したがエラーで止まった人- ChatGPTアカウントとAPIキー、どちらで認証すべきか迷っている人
- WSLを使うべきか、Windowsネイティブで十分か知りたい人
前提条件の確認
セットアップを始める前に、以下を確認してください。
| 項目 | 要件 |
|---|---|
| OS | Windows 10（64bit）以降 / Windows 11 |
| Node.js（npmインストール時のみ） | v22以上（v22未満だとインストール失敗や動作不良の原因になる） |
| ChatGPTアカウント または OpenAI APIキー | いずれか必須（完全無料枠はなし） |
| インターネット接続 | 必須（サインイン・モデル呼び出しにクラウド接続が必要） |
| WSL（Windows Subsystem for Linux） | 必須ではない。2026年5月以降、Windowsネイティブのサンドボックスが標準搭載されたため、WSLなしでも安全に動作する |
Note：以前のバージョン（2026年4月時点のv0.121.0など）ではWindowsネイティブ対応が「安定化した段階」でしたが、2026年5月13日にWindows向けの正式対応が完了し、Linuxの仮想化レイヤーを介さないOSネイティブのサンドボックス（制限付きトークン＋ファイルシステムACLベース）が使えるようになっています。よほどの理由がない限り、WSLを別途用意する必要はありません。
インストール手順
Codex CLIのWindowsへのインストール方法は主に3つあります。本記事ではnpm経由の方法を主軸に、他の2つの方法も併記します。
方法1：npm経由でインストール（主軸・推奨）
Node.jsの開発環境がすでにある人には最もシンプルな方法です。
Step 1: Node.jsのバージョン確認
node -v # v22.0.0 以上が表示されればOKバージョンが表示されない、またはv22未満の場合は、Node.js公式サイトからLTS版（またはCurrent版でv22以上のもの）をインストールしてください。
Step 2: Codex CLIのインストール
npm install -g @openai/codex # Codex CLIをグローバルインストール（スコープ付きパッケージ名に注意）⚠️ 重要な注意：
npm install -g codex（スコープなし）と間違えないでください。スコープなしのcodexパッケージは2012年から存在する無関係な別プロジェクトで、OpenAIとは一切関係がありません。インストールは通っても何も起きないため、必ず@openai/codexとスコープ付きで指定してください。
Step 3: インストール確認
codex --version # インストールされたバージョンを表示（例: codex-cli 0.144.5）方法2：公式インストールスクリプト（Node.js不要）
Node.js環境を用意したくない場合は、公式のインストールスクリプトが便利です。バイナリを直接取得するためNode.js/npmは不要です。
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex" # 公式スクリプトでCLIを直接インストール方法3：winget / Microsoft Store経由
Windows標準のパッケージ管理ツール「winget」からもインストールできます。ChatGPTデスクトップアプリ（Windows版）にCodex CLIが同梱される形で提供されています。
winget install --id 9PLM9XGG6VKS -s msstore # Microsoft Store経由でCodex（CLI同梱）をインストール⚠️ 注意：
winget install Codex -s msstoreのように名前で検索すると、無関係な別アプリがヒットする不具合が報告されています。必ずID（9PLM9XGG6VKS）を指定してインストールしてください。
どの方法を選ぶべきか
■すでにNode.js 22以上の開発環境がある
→ 方法1（npm）でOK。他ツール（Claude Code等）と管理方法を揃えられる
■Node.js環境を持ちたくない・最速で入れたい
→ 方法2（公式インストールスクリプト）がおすすめ
■ChatGPTデスクトップアプリも一緒に使いたい
→ 方法3（winget / Microsoft Store）Windows特有の注意点
⚠️ PowerShellの実行ポリシー
方法2のインストールスクリプトは、実行ポリシーによってブロックされる場合があります。
コマンド内の "-ExecutionPolicy ByPass" が一時的に許可するため、通常はそのままコピペで実行可能です。
⚠️ PATHが通るまでは別ターミナルで確認する
npmインストール後、既に開いていたターミナルのままだとPATHが反映されないことがあります。
新しいPowerShellウィンドウを開いてから "codex --version" を実行してください。
⚠️ WSL経由でも動作するが必須ではない
社内ポリシー等でWSL環境を既に使っている場合は、WSL内でLinux版としてインストールしても問題ありません。
ただしWindowsネイティブ版（本記事の方法）の方が導入の手間は少なくなります。初期設定・認証
Step 4: 初回起動とサインイン
インストールが完了したら、まずはそのまま起動してみます。
codex # 初回起動。ブラウザでのサインイン画面が自動的に開く初回起動時は以下の流れでサインインが進みます。
1. 既定のブラウザが自動的に開く
2. ChatGPTのログイン画面が表示される
3. アカウントでログイン（Plus/Pro/Team/Enterprise/Business/Edu/Freeいずれでも可）
4. 「Codexにアクセスを許可しますか？」の確認画面で許可
5. ターミナルに戻ると認証完了認証方法1：ChatGPTアカウントでのOAuthログイン（推奨）
個人開発者には、ブラウザ経由のOAuth認証が最もシンプルです。ChatGPTのサブスクリプションにそのまま紐づくため、APIキーの管理が不要です。
codex login # ブラウザでのChatGPT OAuthログインを開始認証方法2：OpenAI APIキーでのログイン
従量課金のAPIキーを使いたい場合は、以下のいずれかの方法で設定します。
codex login --with-api-key # プロンプトが表示されたらAPIキーを貼り付け環境変数として設定する方法もあります。
# 一時的に設定（そのPowerShellセッション中のみ有効）
$env:OPENAI_API_KEY = "sk-..." # 環境変数にAPIキーを一時設定
# 永続的に設定（ユーザー環境変数として保存）
[System.Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "sk-...", "User") # 次回以降のターミナルでも自動的に読み込まれる⚠️ 注意： APIキーは従量課金です。使用量に上限がないため、OpenAIダッシュボードで予算上限（Usage Limits）を設定しておくことを強く推奨します。
config.tomlでの設定確認
認証情報の保存先や優先する認証方式は、設定ファイルで制御できます。Windowsでの配置場所は以下の通りです。
%USERPROFILE%\.codex\config.toml# %USERPROFILE%\.codex\config.toml（ユーザーレベル設定）
preferred_auth_method = "chatgpt" # "chatgpt" または "apikey" で優先認証方式を固定
cli_auth_credentials_store = "file" # 認証情報の保存方式（file / keyring / auto）
model = "gpt-5.4" # デフォルトモデル
sandbox_mode = "workspace-write" # サンドボックスモード（Windowsネイティブでも同じ設定名）⚠️ 重要： APIキーそのものを
config.tomlに直接書き込むのは避けてください。環境変数またはcodex login --with-api-key経由での保存が安全です。
動作確認
バージョンとステータスの確認
codex --version # インストールされているバージョンを確認Codex CLI内で以下のコマンドを実行すると、現在の認証状態・モデル・トークン使用量が確認できます。
> /statusテストディレクトリでの動作確認
mkdir C:\test-codex-cli # 動作確認用のディレクトリを作成
cd C:\test-codex-cli
codex # Codex CLIを起動起動後、プロンプトに日本語で指示を入力して応答を確認します。
> こんにちは。自己紹介してください。正常に動作していれば、日本語で応答が返ってきます。
ファイル作成テスト
> hello.pyというファイルを作成して、「Hello, Codex CLI!」と表示するコードを書いてください。期待される動作：
# hello.py
message = "Hello, Codex CLI!" # メッセージを定義
print(message) # コンソールに出力作成後、以下のコマンドで実行確認します。
python hello.py
# Hello, Codex CLI!✅ この出力が確認できれば、Windows環境でのセットアップは完了です。
よくあるトラブルと解決方法
トラブル1：'codex' is not recognized（コマンドが認識されない）
エラーメッセージ：
'codex' is not recognized as an internal or external command解決方法：
# 1. npmのグローバルインストール先を確認
npm config get prefix # 例: C:\Users\YourName\AppData\Roaming\npm
# 2. 上記のパスが環境変数PATHに含まれているか確認
$env:Path -split ';' | Select-String "npm"
# 3. 含まれていない場合はシステム環境変数のPathに追加
# Windowsキー+R → sysdm.cpl → 詳細設定 → 環境変数 → Pathを編集 → npmのパスを追加
# 4. 新しいPowerShellウィンドウを開いて再確認
codex --versionトラブル2：インストールしたのに何も起きない（パッケージの誤認識）
原因： スコープなしの codex（無関係な2012年の別パッケージ）を誤ってインストールしている。
解決方法：
npm uninstall -g codex # 無関係なパッケージをアンインストール
npm install -g @openai/codex # 正しいスコープ付きパッケージを再インストール
codex --version # バージョンが表示されることを確認トラブル3：インストールスクリプトが実行ポリシーでブロックされる
エラーメッセージ：
このシステムではスクリプトの実行が無効になっているため、
...ps1 を読み込むことができません。解決方法：
# 現在のユーザーの実行ポリシーを一時的に緩和
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser # 署名済み・ローカルスクリプトの実行を許可
# その上で再度インストールスクリプトを実行
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"トラブル4：ブラウザ認証が開始されない・完了しない
解決方法：
1. 既定のブラウザ設定を確認
Windows設定 > アプリ > 既定のアプリ > Webブラウザー
2. ターミナルに表示されたURLを手動でブラウザに貼り付けてアクセス
3. 社内プロキシ環境の場合は環境変数でプロキシを明示
$env:HTTPS_PROXY = "http://proxy.company.com:8080"
※2026年7月時点の最新版はWindowsのシステムプロキシ（PAC/WPAD含む）を
自動的に検出するようになっているため、まずはアップデートも検討してくださいトラブル5：winget install で無関係なアプリがヒットする
解決方法：
# 名前検索ではなくIDを直接指定してインストール
winget install --id 9PLM9XGG6VKS -s msstoreトラブル6：Node.jsバージョン不一致エラー（npmインストール時）
エラーメッセージ：
Error: Node.js version 22 or higher is required解決方法：
# 1. 現在のバージョン確認
node -v
# 2. Node.js公式サイトから最新LTS（v22以上）を再インストール
# https://nodejs.org/
# 3. ターミナルを再起動して再確認
node -v
npm install -g @openai/codexまとめ
Codex CLIのWindows環境への導入手順を解説しました。
セットアップの流れ：
✅ 前提条件確認
- Node.js 22以上（npmインストールの場合）
- ChatGPTアカウント または OpenAI APIキー
- WSLは必須ではない（Windowsネイティブサンドボックスで動作）
✅ インストール（3つの方法から選択）
- npm：
npm install -g @openai/codex（スコープを忘れずに） - 公式インストールスクリプト：Node.js不要で最速
- winget / Microsoft Store：IDを指定してインストール
✅ 認証
- ChatGPTアカウントでのOAuthログイン（推奨・キー管理不要）
- OpenAI APIキー（従量課金・予算上限の設定推奨）
✅ 動作確認
codex --versionでバージョン確認- テストディレクトリでファイル作成・実行を確認
つまずきやすいポイント：
- スコープなしの
codexパッケージを誤ってインストールしない - インストール直後は新しいターミナルでPATHを確認する
- winget検索ではなくIDを直接指定する
セットアップが完了したら、Codex CLIならではの強み——サンドボックス実行やCI/CD組み込み、マルチエージェントによる並列処理——を実際に試してみてください。
関連記事：
- OpenAI Codex CLI完全ガイド｜ターミナルで動くOpenAIのAIエージェントの全貌
- Claude Code vs Gemini CLI vs Codex CLI｜できること・できないことを徹底比較
- Claude Code環境構築完全ガイド｜初心者でも30分でセットアップできる詳細手順
タグ: #CodexCLI #OpenAI #環境構築 #セットアップ #Windows #インストール
コメント