Codex CLIの始め方｜WindowsのWSL設定とMacの導入手順

Codex CLIは、WindowsならWSLでUbuntuを入れてNode.jsを用意し、MacならNode.jsだけを用意したうえで、npm i -g @openai/codex で入れて使います。インストール後は作業用フォルダで codex を起動し、ChatGPTアカウントでサインインすれば、ファイルのリネームやWebサイトの生成を言葉で指示できます。

2025年8月14日のProcevoの講座では、講師のKEITOが、OpenAIのCodex CLI（https://github.com/openai/codex）をWindowsとMacに入れる手順と、画像の一括リネーム、カフェのWebサイト作りまでを実演しました。

Codex CLIのセットアップ手順の図。WindowsはWSL・Ubuntu・Node.jsを経てnpmでインストール、MacはNode.jsからnpmでインストールし、どちらも作業フォルダでcodexを起動してサインインする

Codex CLIとは何ができるツール？

Codex CLIは、PC上のディレクトリを対象に、読み取り・作成・変更・削除といった操作を対話で進められるツールです。チャット画面だけで完結するのではなく、手元のプロジェクトフォルダを直接扱える点が特徴です。公式ドキュメントでは、プロジェクトディレクトリで codex を起動し、ChatGPTアカウントでサインインする流れが案内されています（Codex CLI（https://developers.openai.com/codex/cli）、ChatGPTプランでの利用（https://help.openai.com/en/articles/11369540-using-codex-with-your-chatgpt-plan））。

一方で、削除や上書きも指示次第で実行できるため、講座では「消してはいけないファイルも操作対象になり得る」というリスクを先に確認しました。各操作の前に確認が入る設定を使い、作業対象フォルダをあらかじめ絞る、といった運用が推奨されています。

Codex CLIを安全に使うための図。削除や上書きもできるので、確認が入る設定とテスト用の空フォルダで作業の範囲を絞る

Codex CLIで画像の一括リネームはできる？

セットアップの前に、講師のKEITOは動作イメージとして、フォルダ内の多数の画像ファイルに連番のファイル名を付ける例を示しました。従来は手入力や専用ツールが必要だった作業を、「このフォルダの画像に1から番号を振って」と伝えるだけで進められる、という導入です。以降のインストール作業のゴール感をそろえるためのデモでした。

WindowsとMacでセットアップ手順はどう違う？

講座資料はWindows向けが中心です。Windowsでは、Codex CLIをそのままPowerShell上だけで完結させるのではなく、WSL（Windows Subsystem for Linux）（https://learn.microsoft.com/windows/wsl/）上のUbuntu環境と、その上のNode.jsを経由する流れでした。MacにはWSL相当の追加手順がなく、Node.jsの準備から始められます。

参考情報のスライド。WSLとUbuntuの解説記事のURLと、Macは1行ずつ実行してからCodex CLIを入れるという案内

WSLの有効化のスライド。管理者のコマンドプロンプトで wsl --install -d Ubuntu-22.04 を実行し、再起動後にUbuntuを初期設定する

Windows側の要点は次のとおりです。

管理者権限のPowerShell（またはコマンドプロンプト）を開く — スタートメニューから「Windows PowerShell」を検索し、「管理者として実行」
WSLとUbuntuを入れる — 例: wsl --install -d Ubuntu-22.04
インストール後に再起動し、Ubuntuを起動して初期ユーザー設定を行う
Ubuntu上でNode.jsを入れ、続けてCodex CLIを入れる

Macではターミナルを開き、Node.jsのインストールから同じ後続手順に合流します。

WindowsはWSLとUbuntuを経てNode.jsへ進み、MacはNode.jsの準備から始める比較。

WSLのインストールでよくあるエラーは？

実習では次のようなつまずきが多く出ました。

よくあるエラーの解決策のスライド。管理者権限、PC再起動、Linux用Windowsサブシステムの有効化、PowerShellのアップデート

Windowsの機能の有効化または無効化の一覧。Linux用Windowsサブシステムと仮想マシンプラットフォームに印がついている

インストール作業に管理者権限が必要 — 通常権限のままではWSLの導入が進まない
WSLインストール後は再起動が必要 — 資料でも再起動が推奨されており、再起動前に先へ進むと状態が中途半端になる
「Linux用Windowsサブシステム」が無効 — 「Windowsの機能の有効化または無効化」から該当項目（必要に応じて仮想マシンプラットフォームも）にチェックを入れる
PowerShellが古い — アップデートしてから再試行する

パスワード入力時に文字が見えないのは、ターミナルの一般的な仕様であり、入力自体は受け付けられている、という説明もありました。パイプ記号（|）の打ち間違いでNode.js用のセットアップコマンドが失敗するケースも、受講者の画面共有で確認されています。

Node.jsはWSLやMacにどう入れる？

Ubuntu上では、講座時点の資料として次のようなコマンドが示されました（バージョン番号は資料記載の例です。現行の推奨版はNode.js公式（https://nodejs.org/）やNodeSourceの案内に合わせてください）。

Node.jsをWSLにインストールするスライド。NodeSourceのセットアップ、apt-getでのインストール、node -vでの確認

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -

sudo apt-get install -y nodejs build-essential

node -v（v22.x などが表示されればOK）

Macでは公式インストーラやパッケージマネージャでNode.jsを入れたあと、同じように node -v で確認します。WSL上とWindows本体側でNodeが入っている場所が違うと、「前に入れたはずなのに見つからない」という混乱が起きやすい点にも触れられました。

Codex CLIのインストールとサインインはどうする？

講座では、次のnpmコマンドでグローバルインストールしました。

npm i -g @openai/codex

Codex CLIを起動したときの画面。/init や /status などのコマンドと、Ask Codex to do anything の入力欄

2026年11月時点の公式案内でも、npm install -g @openai/codex は引き続き有効です。加えて、Node.js不要のスタンドアロンインストーラも用意されています。macOS/Linux用はシェルスクリプト、Windows用はPowerShellスクリプトで、Homebrew（brew install --cask codex）でも入れられます（npmパッケージ @openai/codex（https://www.npmjs.com/package/@openai/codex）、GitHub openai/codex（https://github.com/openai/codex））。

インストール後は、作業したいフォルダへ移動してから codex を起動します。初回はChatGPTへのサインインを選びます。利用枠はプランにより異なります。PlusではCodex利用が拡大される、といった位置づけがChatGPTの料金ページ（https://openai.com/chatgpt/pricing/）に記載されています（2026年11月時点。金額・内訳は公式の最新表示を確認してください）。APIキーでの利用も可能ですが、追加の設定が必要です。

講座では、作業対象を限定するため cd でテスト用フォルダへ入り、その状態でCodexを起動する方法が紹介されました。フォルダごとドラッグ＆ドロップしてパスを渡す、といった操作もMacターミナル向けに説明されています。

npmコマンドでCodex CLIを入れ、作業フォルダで起動し、ChatGPTへサインインする順番。

Codex CLIでカフェのWebサイトは作れる？

セットアップが終わったあとの実習として、「おしゃれなカフェのウェブサイトを作って」とCodexに依頼する例がありました。HTMLの作成確認に応じると、テストフォルダ配下にサイト用ファイルが生成されます。続けてスタイルシートの作成を承認し、ブラウザで開くと、メニューや店舗案内などの構成を持つページが表示されます。

Codex CLIでカフェのWebサイトを作る5つの手順の図。依頼、HTMLとスタイルシートの承認、ブラウザでの確認、ChatGPTでの画像づくり、画像の配置と整理の依頼

さらに、ChatGPT側でカフェ向けの画像を生成し、ダウンロードした画像をフォルダへ移したうえで、「メインビジュアルと店舗案内に配置し、imagesフォルダを作って整理して」とCodexへ渡す流れも示されました。デザインの完成度は指示の具体性に左右されますが、静的サイトの骨組みを短時間で出すデモとしては十分な結果でした。

Windowsで止まったときはどう切り分ける？

後半の質疑ではWSL導入後のUbuntu起動方法、Node.jsインストール時の一時ディレクトリ関連エラー、仮想マシンプラットフォームのチェック項目が見当たらない、といった相談が続きました。対処の共通点は次です。

「Windowsの機能の有効化または無効化」でLinux用サブシステム（と必要なら仮想マシンプラットフォーム）を有効化し、再起動する
資料のコマンドを手打ちせず、信頼できる出典からコピーする（パイプやハイフンの欠落に注意）
エラー文をそのまま共有し、どの段階（WSL / Ubuntu初期設定 / Node.js / Codex）で止まっているかを切り分ける

Mac側は手順が短い一方、Windows側は再起動と機能有効化の確認がボトルネックになりやすい、というのが講座全体の印象です。

Windowsで止まったときの切り分けの図。WSL、Ubuntuの初期設定、Node.js、Codexの4か所で、それぞれ確かめる点を並べている

Codexを使ってAI機能付きのサービスを作る回はCodex App Serverの使い方と料金｜ChatGPTのプランで動く社内AIアプリの作り方、手元のファイルを扱うAIを安全に使うための考え方はClaude Codeのセキュリティ設定｜自動承認と権限設計で起きた7つの事故と防ぎ方で扱っています。

まとめ

Codex CLIは、ターミナルからローカルフォルダを自然言語で操作できるOpenAIのコーディングエージェントである
WindowsはWSL＋Ubuntu＋Node.js、MacはNode.jsから入り、npm i -g @openai/codex（または公式のスタンドアロンインストーラ）で入れられる
起動後はChatGPTアカウントでサインインし、作業フォルダを絞ったうえで使う
ファイル削除なども指示次第で可能なため、確認プロンプトと対象フォルダの限定が重要
活用例として、静的なカフェサイトの生成と画像の差し込みまでを一連で体験できる

よくある質問

Codex CLIとChatGPTのチャット画面はどう違う？

ChatGPTのチャットは主に会話と生成物の受け渡しが中心です。Codex CLIは手元のディレクトリを直接読み書きできるため、リネームやファイル追加、サイト一式の生成といったローカル作業向きです。

WindowsはPowerShellだけで使える？

講座時点の説明では、Codex CLIはWindowsネイティブのPowerShellだけでは完結しにくく、WSL上のLinux環境経由が前提でした。現行の公式にもWindows向けスタンドアロンインストーラがありますが、実習で安定して進んだのはWSLルートです。

MacにもWSLは必要？

不要です。Macは最初からUnix系のターミナルが使えるため、Node.js（またはスタンドアロンインストーラ）の準備からCodexのインストールへ進めます。

Codex CLIの料金はいくら？

Codex自体の利用はChatGPTのプランに紐づきます。PlusなどではCodexの利用枠が広がる、と公式料金ページに記載があります（2026年11月時点）。月額の正確な金額は地域表示を含めopenai.com/chatgpt/pricing（https://openai.com/chatgpt/pricing/）で確認してください。APIキー利用時はAPI側の従量課金になります。

インストール後に codex が見つからないときは？

新しいターミナルを開き直す、PATHが通っているかを確認する、npmのグローバル領域の権限エラーが出ていないかを見る、といった順で切り分けます。

間違ってファイルを消さないか心配なときは？

確認付きのモードで進め、最初はテスト用の空フォルダだけを対象にするのが安全です。本番データや重要な書類の親フォルダでいきなり起動しないことが推奨されます。

Node.jsのバージョンは何を選べばよい？

講座資料では22.x系の例が示されました。現行の推奨版はNode.js公式とCodex側の要件（npmパッケージはNode 16以上など）を照合してください。

Codex CLIのセットアップ方法｜WindowsのWSLとMacの手順と活用例

今後のセミナー予定