2026年最新 Codex インストール＆使い方ガイド：GPT-5.5-Codex 完全版

2026年、OpenAI は Codex を「昔のコード補完モデル」からフルスタックのプログラミング Agent プラットフォームへ再定義しました。Codex CLI はローカルターミナルで動き、リポジトリを読み、ファイルを書き換え、コマンドを実行します。GPT-5.5-Codex はソフトウェア工学向けの特化モデルです。本稿は日本語版のインストール＋運用の決定版——3つのインストール方法、ChatGPT ログイン、config.toml、承認サンドボックス、/model 切替、最初の検証タスクまでを網羅します。Claude Code / Cursor との関係で迷っている方には、下記の比較表と選定マトリクスも用意しました。

1. 2026年になぜ Codex CLI を単独インストールするのか

ChatGPT の Web 版でもコードは書けます。しかしエンジニアリングチームの本当の課題は、チャットの提案がそのまま監査可能な git diff にならないこと、テストループが安定しないこと、CI に接続できないことです。Codex CLI が解くのは実行境界——GPT-5.5 系を指定ディレクトリに置き、サンドボックスと承認ポリシーの下でファイルを書き換え、shell を回すことです。

2021年の「Codex 補完 API」とは別物で、2026年の Codex はRust 製のオープンソースターミナル Agent（openai/codex）です。ChatGPT サブスクと連携し、IDE 拡張・デスクトップ App・Codex Cloud の非同期タスクへ広がります。分水嶺は「OpenAI と Anthropic どちらが強いか」ではなく、ターミナル Agent にタスクを委任する覚悟があるかです。

2. Codex の4つの入口を整理する

本ガイドは Codex CLI が中心ですが、プラットフォーム全体は4面あり、設定は ~/.codex/ を共有します：

推奨ルートは CLI 先行：CLI を入れたあと IDE 拡張や App は同じアカウントで設定を再利用できます。

3. 核心比較：Codex vs Claude Code vs Cursor

料金の話をわかりやすく：3社とも入門はだいたい月20ドル（約3,000円）ですが、買っているものは違います——

• Codex・Claude Code：スマホのギガ残量のようなもの。数時間ごとに枠がリセットされ、AI に一気に大量のファイルを直させるとすぐ減ります。
• Cursor：ジムの月会費のようなもの。月額固定で、毎日 IDE に張り付いてコーディングする人ほどコスパが読みやすいです。

下表の緑の列は「どう課金され、月末の請求が読めるか」——ツール選びでいちばん見るべき軸です。能力は左の列、お金の話は緑の列を重点的に。

IDE 比較の詳細は Claude Code vs Cursor 2026；Anthropic と OpenAI の Agent 路線は Claude Code 時代のナラティブ を参照。

4. シーン別の選び方

5. おすすめ構成（2026 エンジニアリングスタック）

• 個人開発者— Codex CLI（GPT-5.5-Codex）+ 既存 IDE で小変更；大タスクは週末に codex で委任。
• フルスタック + iOS— 業務コードは Codex/Cursor でローカル；Xcode ビルドと署名は Cloud Mac または GitHub Runner 実行ノードへ。
• チーム CI— codex exec または Codex Cloud で patch → Actions でビルド・テスト → 人が PR レビュー。Runner は1 Job 1 Workspaceで隔離。
• 知識集約リポジトリ— Codex MCP で Issue 追跡 + 任意 CodeGraph；ルールは .codex/config.toml と AGENTS.md に記述。

6. インストール前の準備

• アカウント— ChatGPT Plus / Pro / Business / Edu / Enterprise（Codex 含む）、または利用可能な OpenAI API Key。
• OS— macOS・Linux が第一級；Windows は PowerShell ネイティブまたは WSL2。
• Git リポジトリ— 空フォルダではなく実プロジェクトのルートで検証推奨。
• Node.js 18+— npm install -g @openai/codex を使う場合のみ。

uname -a
git --version
node -v   # npm 経由の場合
which codex # 未インストールなら出力なし

7. 3つのインストール方法（2026 公式ルート）

# 非対話（CI イメージ）では先に
export CODEX_NON_INTERACTIVE=1

curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex --version

npm install -g @openai/codex@latest
codex --version
# EACCES の場合：npm config set prefix ~/.npm-global、~/.npm-global/bin を PATH に

8. ログインと認証

初回 codex 実行で対話 TUI が開き、次を選択します：

• Sign in with ChatGPT（推奨）— ブラウザ OAuth、枠は ChatGPT プランに計上。
• API Key— 自動化と token 精算向け；Key を git にコミットしない。

設定と資格情報は ~/.codex/ に保存。共有マシンではファイル権限に注意し、CI ではシークレット管理から API Key を注入します。

9. GPT-5.5-Codex：モデル切替と config.toml

GPT-5.5 は汎用フラッグシップ；GPT-5.5-Codex はコードタスク向け（リポジトリ読取、patch 適用、ツールチェーン推論）。日常のソフトウェア開発は Codex 変体をデフォルトに、汎用 Q&A は gpt-5.5 に戻せます。

セッション内切替：TUI で /model → gpt-5.5-codex と reasoning レベルを選択。

永続デフォルト：ユーザー設定 ~/.codex/config.toml（プロジェクト単位は .codex/config.toml、プロジェクトを信頼した場合）：

# デフォルトプログラミングモデル
model = "gpt-5.5-codex"

# 承認：on-request = 権限超過時に確認（推奨）
approval_policy = "on-request"

# サンドボックス：read-only から始め、慣れたら workspace-write
sandbox_mode = "read-only"

# 推論の強さ（タスクに応じて調整）
model_reasoning_effort = "medium"

優先順位（後が前を上書き）：組み込みデフォルト → ~/.codex/config.toml → プロジェクト .codex/config.toml → Profile（codex --profile ci）→ CLI 引数。詳細は 公式 Config basics。

10. 日常運用：TUI、承認、MCP、スクリプト化

対話モード

cd your-repo
codex
# または一行タスク
codex "npm test を実行し失敗ケースを修正。package-lock は触らない"

承認モード（安全の赤線）

rm、本番設定変更、秘密ファイルアクセスでは必ず人手で承認。企業環境では requirements.toml で never や danger-full-access サンドボックスを禁止する場合があります。

MCP 拡張

Codex は Model Context Protocol に対応。config.toml で MCP Server を宣言すれば GitHub や DB など外部コンテキストを読めます。Claude Code の MCP 設定と考え方は似ています——MCP セットアップガイドで PAT 最小権限の原則を確認してください。

exec スクリプト化と Cloud

• codex exec "..." — ヘッドレス実行。cron / CI プリチェック向け。
• Subagents — 大タスクを並列サブ Agent に分割（TUI 内）。
• ローカル Code Review — コミット前に独立 Agent で diff をレビュー。
• Codex Cloud — ターミナルからクラウドタスクを起動し、patch を取得してローカル適用。

11. よくある誤解

1. Codex を ChatGPT Web と同じと思う — CLI を入れず diff をレビューしないとエンジニアリングループが回らない。
2. 最初から sandbox_mode = danger-full-access — クリックは減るが誤削除は取り返しがつかない。read-only から段階的に。
3. サブディレクトリで codex を起動 — Agent は cwd しか見えない。Monorepo は正しいパッケージルートで。
4. Windows のパス差を無視 — PowerShell ネイティブと WSL のリポジトリパスは別物。どちらかに統一。
5. モデルだけ比較して入口を無視 — GPT-5.5-Codex は強力だが Tab 補完が主戦場なら Cursor + Codex 拡張の方が現実的。

12. 7ステップ実践リスト

1. CLI インストール — 公式 install.sh または npm i -g @openai/codex、codex --version 確認。
2. ログイン — ChatGPT OAuth または API Key、~/.codex/ 生成を確認。
3. config.toml 記述 — model = "gpt-5.5-codex"、approval_policy = "on-request"、sandbox_mode = "read-only"。
4. リポジトリ選択 — 慣れた中規模プロジェクトへ cd、git status がクリーンまたは機能ブランチ上。
5. スモークタスク — codex "src のディレクトリ構造を説明してツリー図を出して" でファイル読取を確認。
6. クローズドループタスク — codex "テストコマンド [あなたの test cmd] を実行し失敗を修正" で shell 実行を確認。
7. チームスタック接続 — 24/7 ビルドが必要なら Runner を Cloud Mac に；グラフが必要なら MCP。

13. FAQ

Codex、Claude Code、Cursor のうち一番安いのは？

表向きはいずれも $20/月 からで、絶対的な「最安」はありません。ChatGPT 利用中なら Codex は実質おまけ；Claude Pro なら Claude Code も同様。ゼロから月額固定なら Cursor が読みやすい。一度に大量ファイルを直す重度利用は $100〜$200 帯が必要になることがあります——比較表参照。

Codex は別途課金が必要？

通常は不要。ChatGPT Plus（$20/月）に Codex が含まれます。API Key の従量課金も可能ですが、クラウドコードレビューなど会員機能は使えません。枠の詳細は OpenAI の説明を参照。

GPT-5.5 と GPT-5.5-Codex の違いは？

GPT-5.5 は汎用；GPT-5.5-Codex はソフトウェア工学向けチューニングで、コード読取・patch・ツール連携に強い。コーディングのデフォルトは Codex 変体。

Codex と Claude Code は同時に入れられる？

はい。設定は ~/.codex/ と ~/.claude.json で別管理。同じリポジトリでシーン分け可能——ただしフォーマットを二重に直されないようスタイル規約を統一してください。

インストール後 command not found？

スクリプト後に shell を再起動するか、インストールパスを PATH に追加。Homebrew は /opt/homebrew/bin；npm は ~/.npm-global/bin を確認。

Codex のアップグレード方法は？

npm install -g @openai/codex@latest または公式 install スクリプトを再実行；Homebrew は brew upgrade codex。

14. まとめ

2026年の Codex インストールガイドの本質は、OpenAI のプログラミング Agent をファイルシステムとターミナルに接続することです。 3コマンドで CLI を入れ、ChatGPT でログインし、config.toml で gpt-5.5-codex をデフォルトに、on-request 承認で安全線を引けば——再現可能でスクリプト化でき Cloud にも載るコーディングワークフローが手に入ります。Claude Code と争うのは「ターミナル Agent の入口」、Cursor と争うのは「誰がコーディングの主導権を握るか」。多くのチームは最終的に2つか3つを併用し、単一ブランドに賭けません。

本物の macOS ビルドが必要な読者へ：Agent がどれだけ速くても、Xcode と Runner は Apple ハードウェア上に要ります。Cloud Mac は Codex でローカル改コード、リモートでコンパイルという「書く」と「検証する」の分離に向いています。