本文へ移動
BenriWorks LabBenriWorks トップ

ガイド更新日

WindowsにCodexを入れて、動作を確かめる

この記事で分かること

Codex 集中講座の第2回。Windowsへの導入、サインイン、起動確認を進めます。デスクトップアプリとCLIの入口を用意し、診断結果やWSL2の選択肢を確かめます。

ノートパソコンの前で初期設定の画面に向かい、こちらを向いている女性
目次 読みたいところから

インストーラーを閉じたあと、何ができれば導入完了なのか。Codexが開き、作業用フォルダを選び、依頼を入力できるところまで確かめます。

画面で使うデスクトップアプリと、ターミナルに文字を打って使うコマンドライン版(CLI)を用意します。設定や診断で迷ったときにも、入口を使い分けられるようにします。

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

Codex は ChatGPT のデスクトップアプリの中にあります。公式ドキュメントの言い方では、新しいチャットを始めるときに ChatGPT のドロップダウンから Codex を選びます。

手順は3つです。

  1. ChatGPT のデスクトップアプリを Windows 向けにダウンロードして入れる
  2. アプリを開き、ChatGPT のアカウントでサインインする
  3. ChatGPT のドロップダウンから Codex を選ぶ

サインインに使うアカウントは、普段 ChatGPT を使っているものと同じで構いません。公式ヘルプによれば、ChatGPT でサインインした Codex は、そのプランの使用量と請求を使います。

コマンドライン版を入れる

コマンドライン版は npm で入ります。Node.js が入っていれば1行です。

npm install -g @openai/codex

入ったかどうかは版を表示して確かめます。2026年11月の再照合で実際に実行した結果です。

$ codex --version
codex-cli 0.167.0

サインインは codex login です。APIキーを使う場合は標準入力から渡す形も用意されていて、codex login --help には次の例が書かれています。

--with-api-key
        Read the API key from stdin (e.g. `printenv OPENAI_API_KEY | codex login --with-api-key`)

APIキーをコマンドの引数に直接書かない形になっているのは、引数がシェルの履歴やプロセス一覧に残るためです。秘密の値は履歴に残る場所に置かない、というのはこの講座を通じての約束事になります。

サインインしていない状態で codex を起動すると、最初にこの選択が出ます。執筆環境(codex-cli 0.154.0)で実際に表示されたものです。

  Welcome to Codex, OpenAI's command-line coding agent

  Sign in with ChatGPT to use Codex as part of your paid plan
  or connect an API key for usage-based billing

> 1. Sign in with ChatGPT
     Usage included with Plus, Pro, Business, and Enterprise plans

  2. Sign in with Device Code
     Sign in from another device with a one-time code

  3. Provide your own API key
     Pay for what you use

  Press enter to continue

2つ目の Device Code は、ブラウザを開けない環境のためのものです。踏み台のサーバーやコンテナの中で作業しているときは、この形になります。

動く状態かどうかを自己診断で確かめる

コマンドライン版には codex doctor という自己診断があります。認証、更新の設定、通信の到達性、ディスクの空き、Git の検出などを順に調べて表示します。

執筆環境(ネットワークが制限された Linux コンテナ、サインインなし)で実行すると、次のように出ました。

Codex Doctor v0.167.0 · linux-x86_64

Notes
   ✗ auth         no Codex credentials were found - Run codex login or provide an API key ...
   ⚠ updates      update configuration is locally consistent
   ⚠ websocket    Responses WebSocket failed; HTTPS fallback may still work - Check proxy, VPN, ...
   ✗ reachability one or more required provider endpoints are unreachable over HTTP - Check proxy, ...
─────────────────────────────────────────────────────────────

Environment
  ✓ disk         sufficient free disk space (28.2 GiB)
  ✓ runtime      npm (package ...)
  ✓ git          git executable found; execution not verified
      repo detected            true

このように、動かない理由が上の「Notes」に並びます。認証がない、通信が届かない、という2つがここでは失敗しています。うまく動かないときに最初に打つのはこのコマンドです。原因の切り分けが、自分の勘より速く終わります。

ネイティブのサンドボックスか WSL2 か

Windows には選択肢があります。公式ドキュメントによれば、PowerShell から動かすと Windows のネイティブのサンドボックスが使われ、WSL2 の中で動かすと Linux 側の実装が使われます。

ネイティブのサンドボックスには実装が3つあります。対応する端末では MXC が推奨され、使えないときは elevated、さらに unelevated へ順に退きます。

案内は明快です。既定ではネイティブを使い、Linux 向けの道具が要るとき、作業環境がすでに WSL2 にあるとき、あるいはネイティブの実装がどれも条件に合わないときだけ WSL2 を選びます。

Windowsで Codex を動かす3つの形を並べた図。PowerShellからネイティブのサンドボックス、権限昇格できない場合のフォールバック、WSL2内のLinuxサンドボックスの3つがあり、既定はネイティブと注記されている
既定はネイティブ。WSL2 は Linux 向けの道具が要るときに選ぶ

Windows 上のプロジェクトから始めるなら、最初は WSL2 なしで構いません。この講座も、そちらを前提に進めます。

開発環境そのものを散らかさない

ここで、道具の置き場所についてひとつ決めておきます。

BenriWorks で Android アプリを作っているリポジトリでは、Windows に常設するものを Git と Android Studio と Codex の3つに限り、それ以外の JDK や SDK やキャッシュは1か所の作業フォルダへ集めています。導入スクリプトがバージョンを検証して展開し、Windows の永続的な環境変数には触りません。

なぜそうしているかというと、エージェントに触らせる環境は、壊れたときに作り直せる形にしておきたいからです。手で入れたものがあちこちに散っていると、「動かない」の原因が環境なのかコードなのか分からなくなります。詳しくは「Codex の導入から、Android 測定アプリが実乗車で動くまで」に書きました。

導入できたかの確認

デスクトップアプリで作業用フォルダを選び、依頼を入力する場所を確認します。CLIでは本文の版表示と診断コマンドを実行し、結果を読みます。

エラーがあれば、その文面を残してください。インストール、認証、通信のどこで止まっているかを分けて調べる材料になります。

次の回

道具が動いたら、小さな依頼を1つ出して、返ってきた差分を読みます。「Codexへの最初の依頼は、文言ひとつから」へ進めます。

参照した公式情報

  • OpenAI「Codex CLI」「ChatGPT desktop app」「ChatGPT desktop app for Windows」「Windows sandbox」(learn.chatgpt.com/docs、2026年11月時点。developers.openai.com/codex から移転)
  • OpenAI「Quickstart」「Authentication」(learn.chatgpt.com/docs、2026年11月時点)
  • OpenAI ヘルプセンター「Using Codex with your ChatGPT plan」(2026年9月時点。2026年11月の再照合では開けず)
  • 実際の出力は codex-cli 0.167.0 を執筆環境へ導入して取得(初回のサインイン画面だけは 0.154.0 のもの)

READ NEXT

次はこれを読む

Codex 集中講座の次の回へ

Codexへの最初の依頼は、文言ひとつから

Codex 集中講座の第3回。READMEの見出しを直す練習から、依頼、差分の確認、受け入れまでを体験します。/initで作る規約と、作業を閉じて再開する方法も扱います。

続きを読む →
画面に表示された差分を指さしながら、こちらを向いている男性の開発者

よくある質問

デスクトップアプリとコマンドライン版のどちらを入れればよいですか
まずデスクトップアプリだけで構いません。画面で差分を見られるので、最初の数日はそちらが分かりやすいはずです。設定ファイルを細かく書きたくなったときと、作業を自動化したくなったときに、コマンドライン版を足してください。両方とも同じ設定ファイルと同じ AGENTS.md を読みます。
WSL2 を入れる必要はありますか
公式ドキュメントは、既定では Windows のネイティブのサンドボックスを使い、Linux 向けの道具が要るときや作業環境がすでに WSL2 にあるときだけ WSL2 を選ぶよう案内しています。Windows 上の開発から始めるなら、最初は WSL2 なしで構いません。
うまく動かないときは何を見ればよいですか
コマンドライン版には自己診断の `codex doctor` があります。認証、更新設定、通信の到達性、ディスク空き容量、Git の検出などを順に調べて表示します。動かない原因がこの一覧のどれかであることは多いので、質問する前に一度実行すると切り分けが速くなります。