Codex CLIの使い方は、「インストール」「ChatGPTアカウントでのサインイン」「権限の範囲を決める」の3つを押さえれば、最初の1タスクまで10分ほどでたどり着けます。OpenAIが提供するターミナル常駐型のコーディングエージェントで、エディタを開かずに「このリポジトリのテストを直して」と日本語で頼めるのが特徴です。
一方で、導入でつまずく人の多くはWindowsでの動作環境と権限（どこまで自動で書き換えさせるか）のところで止まります。この記事では、2026年8月10日時点で公式ドキュメントとリポジトリに実際に書かれている内容だけを突き合わせて、導入手順とつまずき対処を整理しました。公式に書かれていない部分は「書かれていない」と明記しています。
Codex CLIとは｜ターミナルで動くOpenAIのコーディングエージェント
Codex CLIは、ターミナル上で動作する軽量なコーディングエージェントです。カレントディレクトリの中身を読み取り、指示に沿ってファイルの編集やコマンドの実行までを代行します。GitHubの公式リポジトリでも「Lightweight coding agent that runs in your terminal」と説明されています。
「Codex」には複数の入り口がある
まぎらわしいのですが、OpenAIの「Codex」は入り口が複数あります。ターミナルで動くCodex CLI、エディタに組み込むIDE拡張、ブラウザ側で動くクラウドタスクです。検索して出てくる記事がどれの話をしているかで手順がまったく変わるため、まず「自分が入れたいのはCLI版か」を確認してください。この記事はCLI版に絞って解説します。
Claude CodeやCursorとの立ち位置の違い
ざっくり言うと、Codex CLIとClaude Codeは「ターミナル型」、Cursorは「エディタ型」です。ターミナル型は既存のエディタを変えずに導入でき、gitやテストコマンドと組み合わせやすいのが利点。エディタ型は補完やインライン編集の体験が滑らかで、コードを目で追いながら進めたい人に向きます。
すでにClaude Codeを使っている方はClaude Codeの使い方｜始め方からつまずき対処・料金の選び方までと読み比べると、両者の考え方の差が分かりやすいはずです。3系統をまとめて比べたい場合はAIコーディング比較｜Claude・Cursor・Copilotの使い分けもあわせてどうぞ。
導入前に確認する動作環境とアカウント（2026年8月時点）
インストールコマンドを打つ前に、環境要件とアカウントの2点だけ確認しておくと、途中でやり直す手間がなくなります。
公式のシステム要件
公式リポジトリのインストールドキュメントには、システム要件が表で明記されています。2026年8月10日時点の記載は次のとおりです。
| 項目 | 公式ドキュメントの記載 |
|---|---|
| OS | macOS 12以降 / Ubuntu 20.04以降・Debian 10以降 / Windows 11はWSL2経由 |
| Git | 任意（推奨）。PR補助機能を使うなら2.23以降 |
| メモリ | 最低4GB、8GB推奨 |
Windowsユーザーが一番混乱するポイント
ここが実務でいちばん引っかかる箇所です。公式のシステム要件表では「Windows 11はWSL2経由」と書かれている一方で、READMEにはWindows向けのPowerShellインストーラも掲載されています。つまり「インストール自体はPowerShellから通る」けれども、「公式が動作を想定している環境はWSL2」という二段構えになっています。
判断の目安はこうです。とりあえず触ってみたい段階ならPowerShell版で問題ありませんが、業務のリポジトリで日常的に使うなら最初からWSL2上に入れておくほうが安全です。パスの区切りやシェルコマンドの前提がLinux寄りのため、後からWSL2へ移すと設定をやり直すことになります。
サインインはChatGPTアカウントかAPIキーか
Codex CLIの認証は2通りです。公式READMEには「Run codex and select Sign in with ChatGPT. We recommend signing into your ChatGPT account to use Codex as part of your Plus, Pro, Business, Edu, or Enterprise plan.」と書かれており、ChatGPTアカウントでのサインインが推奨です。APIキーでのサインインも可能で、その場合はサインアウト画面で「Sign in another way」を選び、OpenAIダッシュボードで取得したキーを入力します。
どちらを選ぶかの目安は、支払いの持ち方です。すでにChatGPTの有料プランを契約しているならアカウント連携が素直で、追加の従量課金を管理しなくて済みます。逆に、複数のプロジェクトで費用を分けて把握したい・チームの経費と個人の契約を混ぜたくない場合は、APIキー方式のほうが会計上は整理しやすくなります。
コスト設計の考え方（編集部の整理）
料金の比較記事では「月◯ドル」と横並びにされがちですが、Codex CLI・Copilot・Cursorは課金の単位そのものが違うため、単純比較は誤解のもとです。2026年8月10日時点で各公式ページに明記されている個人向けの数字だけを並べると、次のようになります。
| ツール | 課金の単位 | 公式に明記されている個人向け価格 |
|---|---|---|
| Codex CLI | ChatGPTアカウントのプランに含める／またはAPIキーの従量課金 | プラン名はPlus・Pro・Business・Edu・Enterprise（公式料金ページで最新額を確認） |
| GitHub Copilot | 月額固定（無料枠は補完回数で制限） | Copilot Pro 月10ドル（GitHub Docs） |
| Cursor | 月額固定＋含まれる利用量 | Pro 月20ドル（Cursor公式） |
ここから読み取れる実務的な結論は、「ChatGPTの有料プランをすでに払っている人にとって、Codex CLIは追加費用ゼロで増える選択肢になりやすい」という点です。逆に、ChatGPTを無料でしか使っていない人が本格運用を狙うなら、Codex CLIを起点にするよりも、回数が公表されているツールから入るほうが月末に止まりにくくなります。無料枠の最新状況はAIコーディングの始め方｜初心者が無料で使えるツール4選に公式出典つきでまとめています。
Codex CLIのインストール手順（3つの方法）
公式が案内している導入方法は、npm・Homebrew・インストーラスクリプトの3系統です。どれを選んでも入るものは同じなので、普段使っているパッケージ管理に合わせて構いません。
方法1：npmで入れる（クロスプラットフォーム）
Node.jsが入っている環境なら、これが最短です。
npm install -g @openai/codex
すでにNode.jsを使っているプロジェクトが多い方は、この方法にしておくとバージョン管理の作法を揃えられます。
方法2：Homebrewで入れる（macOS）
brew install --cask codex
macOSでHomebrewを常用しているなら、更新もbrew upgradeに集約できるためおすすめです。
方法3：公式インストーラスクリプトで入れる
Node.jsもHomebrewも入れたくない場合は、インストーラスクリプトが使えます。
- macOS / Linux：
curl -fsSL https://chatgpt.com/codex/install.sh | sh - Windows：
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
公式ドキュメントでは、アップデートも同じインストーラコマンドを再実行する形が案内されています。なお、GitHubのリリースページからバイナリを直接ダウンロードする方法も用意されています。
初回起動からサインイン、最初の1タスクまで
インストールが終わったら、実際に動かすところまで一気に進めます。
ステップ1：プロジェクトのディレクトリで起動する
公式クイックスタートでは、プロジェクトのディレクトリに移動してからcodexを実行する流れが案内されています。カレントディレクトリの内容が作業対象になるため、いきなりホームディレクトリで起動しないのがコツです。
ステップ2：サインインする
初回起動時に認証方法を選ぶ画面が出るので、「Sign in with ChatGPT」を選びます。ブラウザが立ち上がり、ChatGPTアカウントで承認すればターミナルに戻ってきます。APIキーを使う場合は「Sign in another way」から入力します。
ステップ3：まずは読み取りだけのお題から始める
いきなり「リファクタして」と頼むと差分が大きくなりすぎて確認が追いつきません。公式クイックスタートでも例示されているように、最初はTell me about this projectのような読むだけのタスクから始めるのが安全です。プロジェクト構造の説明が返ってくれば、認証も権限も正しく通っている証拠になります。
ステップ4：/initでAGENTS.mdを作る
セッション内で/initを実行すると、プロジェクトの指示を書いておくためのAGENTS.mdが生成されます。「テストは必ずpytestで走らせる」「このディレクトリは触らない」といったルールをここに書いておくと、毎回同じ説明を繰り返さずに済みます。考え方はCursorのRulesと似ているので、CursorのRules設定の書き方で紹介している「禁止事項を先に書く」型がそのまま流用できます。
ステップ5：/permissionsで自動化の範囲を決める
公式ドキュメントによると、/permissionsは「Codexがいつファイルを編集したりコマンドを実行したりしてよいかを、確認なしで選ぶ」ための設定で、現在のサンドボックス構成も確認できます。ここを詰めずに使い始めると、後述の「勝手に書き換わった」というトラブルにつながります。
覚えておくと便利なセッション内コマンド
| コマンド | 用途 |
|---|---|
/init |
AGENTS.md（プロジェクト向けの指示書）を作成する |
/permissions |
編集・コマンド実行をどこまで自動で許すかを設定し、サンドボックス構成を確認する |
/status |
現在の設定状態を表示する |
/model |
使用モデルと推論の強さ（reasoning effort）を切り替える |
codex resume |
そのリポジトリでの直近のセッションを再開する |
つまずきポイントと対処｜症状別の早見表
導入時に止まる箇所はおおむね決まっています。症状から逆引きできるよう表にまとめました。
| 症状 | まず疑うところ | 対処 |
|---|---|---|
Windowsでcodexコマンドが見つからない |
インストール先のパスと実行シェル | PowerShellを開き直して環境変数を再読み込みする。業務利用ならWSL2上に入れ直す |
| ブラウザ認証から戻ってこない | ログイン中のアカウントとリダイレクト | ブラウザ側で目的のChatGPTアカウントにログインしてから再実行する。複数アカウントを併用しているなら別プロファイルで開く |
| 反応はするが提案が的外れ | 起動ディレクトリとAGENTS.md | 対象リポジトリの直下で起動し直し、/initで前提を書いておく |
| 意図しないファイルが書き換わった | 権限設定 | /permissionsで自動実行の範囲を狭め、作業前にブランチを切っておく |
| 途中で応答が止まる・上限に当たる | プランごとの利用量 | タスクを小さく分割する。プラン別の上限はOpenAIのヘルプセンターで確認する |
| モデルが重い・遅い | 推論の強さ設定 | /modelで軽いモデルや低めのreasoning effortに切り替える |
失敗しやすい進め方の実例
導入直後にやりがちなのが、「作業ブランチを切らずに、いきなり広い範囲の修正を頼む」という進め方です。エージェント型ツールは複数ファイルを一度に触れるのが強みですが、その分、差分レビューの量も一気に増えます。結果として「どこが元のコードだったか分からない」状態になり、AIの提案が良かったのか悪かったのかすら判断できなくなります。
対策はシンプルで、1タスク1ブランチ、1タスクは差分50行程度までと自分でルールを決めることです。AGENTS.mdに「変更は最小限にとどめ、無関係な整形はしない」と書いておくと、指示の再入力も減らせます。
使い分けの目安｜Codex CLIを選ぶ人・選ばなくていい人
ツールは多いほど良いわけではありません。導入前に自分が当てはまるかを確認しておきましょう。
Codex CLIが向いている人
- すでにChatGPTの有料プランを使っている：追加契約なしで選択肢を増やせます
- ターミナル中心で作業している：gitやテスト実行と地続きに使えます
- エディタを変えたくない：VimでもJetBrainsでも、エディタはそのままで併用できます
- WSL2環境がすでにある：Windowsでも公式の想定環境に乗れます
いま無理に入れなくていい人
- ターミナル操作そのものが不慣れ：先にエディタ統合型で慣れるほうが挫折しにくいです
- ChatGPTを無料でしか使っていない：本格運用の前に、無料枠が公表されているツールで感触をつかむほうが計画を立てやすくなります
- すでにClaude CodeやCursorで運用が回っている：同系統のツールを増やすより、AGENTS.md／Rulesの整備に時間を使うほうが成果につながりやすい局面です
まとめ｜導入は10分、差がつくのは権限設計
Codex CLIの導入自体は、npm・Homebrew・インストーラのどれかを選んでコマンドを1行打ち、ChatGPTアカウントでサインインするだけです。所要時間は10分ほど。むしろ差がつくのは、そのあとのAGENTS.mdでの前提の書き方と/permissionsでの自動化範囲の決め方です。
最後に要点を整理します。
- 公式のシステム要件はmacOS 12以降／Ubuntu 20.04以降／Windows 11はWSL2経由。業務利用なら最初からWSL2に入れる
- 認証はChatGPTアカウントが推奨。APIキー方式は費用を分けて管理したいときに選ぶ
- 最初のタスクは読み取り専用のお題にして、認証と権限が通っているかを確かめる
/initでAGENTS.mdを作り、禁止事項を先に書いておく- 1タスク1ブランチ・差分は小さく。レビューできる量に抑えることが結局いちばん速い
なお、インストール方法や要件は更新されることがあります。導入の直前にはOpenAI公式リポジトリとCodex CLI公式ドキュメントで最新の記載を確認してください。
