OpenAI Codex（旧称 Codex CLI）の使い方を1記事で網羅した日本語リファレンス。インストールから全コマンド、プロンプトエンジニアリング、Claude Code との比較、料金、トラブルシュートまで、エンジニアが現場で必要とする情報を体系化しました。
本記事は Codex 料金完全ガイド、Codex コマンド・プロンプトガイド、Codex vs Claude Code 比較、Codex CLI リファレンス など既存9本のスポーク記事を統合し、Codex 利用のあらゆる判断点に1ページで答える中央ハブとして設計されています。
1. はじめに（このリファレンスの使い方・対象読者）
本リファレンスは以下の読者を想定しています。
- Codex を初めて使うエンジニア → 2-5節で導入できる
- 既に使っているが体系的に学び直したい人 → 7-9節でプロンプト・MCP・Mode 理解を深める
- Claude Code や Cursor との比較で意思決定したい人 → 14-15節
- 会社で導入検討中 → 12-13節（料金・トラブルシュート）
各セクションは独立して読めます。目次から必要な箇所だけ読んで、参照辞書として使ってください。
2. Codex とは（製品概要・OpenAI 公式の位置付け）
Codex は OpenAI が提供するターミナル型 AI コーディングアシスタント。Web 版 ChatGPT、API、Codex CLI の3つの主要プロダクトの1つで、エンジニア向けの「コードを書く・修正する・実行する」用途に最適化されています。
競合の Claude Code / Cursor / GitHub Copilot との位置付け差：
- Claude Code：Anthropic の同種ツール。ターミナル型で機能ほぼ同等、AI モデルが異なる
- Cursor：VS Code 派生 IDE。GUI 中心
- GitHub Copilot：VS Code/JetBrains 拡張。補完中心、エージェント機能後発
Codex は「OpenAI モデル（GPT-5.x、o1、o3 等）を最大限引き出す」ことに特化。詳細は Codex vs Claude Code 徹底比較 を参照。
Claude Codeを本格的に業務で使いこなしたい方へ
週1×1時間のマンツーマンで業務自動化を実装まで伴走。3ヶ月後には現場で自走できる状態へ。
3. インストール完全ガイド（macOS / Windows / Linux / Docker）
macOS
brew install codex
# または
npm install -g @openai/codexWindows
# PowerShell（WSL2 推奨）
winget install OpenAI.Codex
# または npm
npm install -g @openai/codexLinux
# Ubuntu/Debian
curl -fsSL https://codex.openai.com/install.sh | sh
# または
npm install -g @openai/codexDocker
docker pull openai/codex:latest
docker run -it -v $(pwd):/workspace openai/codexインストール後 codex --version でバージョン確認。最新は 2026年5月時点で 0.x.y 系（破壊的変更あり要注意）。
4. 初期設定（認証・API key・組織設定・MCP）
初回起動時に認証フロー。
codex loginブラウザが開き、OpenAI アカウントで認証。Pro/Plus/Team 契約済みアカウントでログインすると、その契約上限が自動で適用されます。
組織設定（Team プラン）：
codex config set organization <org-id>API key 利用（CI/CD向け）：
export OPENAI_API_KEY="sk-..."
codex --api-key-modeMCP 設定の詳細は9節で。
5. 全コマンドリファレンス
2026年5月時点の主要コマンド一覧。詳細は各セクションで深掘り。
| コマンド | 用途 |
|---|---|
codex | 対話モード起動（デフォルト） |
codex exec <prompt> | 非対話・1回実行モード（CI向け） |
codex login / logout | 認証ログイン/ログアウト |
codex mcp-server | Codex を MCP サーバーとして起動（他ツールから呼ぶ用） |
codex config get/set/list | 設定値の参照・更新 |
codex --plan | Plan Mode（実行前に計画提示） |
codex --edit | Edit Mode（ファイル直接編集） |
codex --version / --help | バージョン確認、ヘルプ |
6. 全オプション・フラグ一覧
頻出フラグ：
--model gpt-5.5：使用モデル指定--max-tokens 8192：応答最大トークン--temperature 0.2：応答のランダム性--workdir /path/to/project：作業ディレクトリ指定--read-only：書き込み禁止モード（レビュー用）--auto-confirm：人間確認スキップ（CI 向け、慎重に）--mcp <server>：MCP サーバー有効化--dangerously-disable-sandbox：サンドボックス無効化（極めて慎重に）
7. plan mode / agent mode / edit mode 完全解説
Plan Mode
実行前に Codex が「これからこういう変更をします」と計画を提示し、承認待ち。本番反映前に「何が変わるか」を見たい場合に必須。
Agent Mode（デフォルト）
Codex がプロジェクト全体を読み、対話で進む。最も柔軟だが、変更範囲が広がりやすい。
Edit Mode
特定ファイルだけを編集対象に限定。小さな修正向き。
3 mode の使い分けで生産性が大きく変わります。Plan Mode 完全ガイド で深掘り。
8. プロンプトエンジニアリング 30選
Codex で頻出する30の実用プロンプトを部門別に整理。
- コードレビュー系（5本）：「PRをレビューして問題点を3段階で指摘」「セキュリティリスクのみ抽出」など
- リファクタ系（5本）：「この関数を SOLID 原則に従って分解」「重複コードをDRY化」など
- テスト系（5本）：「カバレッジ80%目指すテストを生成」など
- ドキュメント系（5本）：「JSDoc/Sphinx形式で関数ドキュメント生成」など
- デバッグ系（5本）：「このスタックトレースから根本原因仮説3つ」など
- マイグレーション系（5本）：「Python 2 → 3 への置換」「React 17 → 18 移行」など
各プロンプトの全文と適用例は Codex コマンド・プロンプトガイド を参照。
9. MCP 連携（Codex MCP / 外部MCP接続 / カスタムMCP作成）
MCP（Model Context Protocol）で Codex を Slack、Notion、データベースなど外部ツールに接続できます。
Codex を MCP サーバーとして起動
codex mcp-server --port 3000外部 MCP サーバーへの接続
例：Slack 連携 MCP を有効化：
codex --mcp slack-mcpカスタム MCP の作成
Python/Node.js で自社向けの MCP サーバーを書ける。例：社内 API への安全な接続、独自 RAG パイプラインなど。
10. ファイル/ディレクトリ操作の挙動
Codex がファイルを変更する際の挙動。
- デフォルトは Diff 提示 → 人間承認 → 反映の3段階
--auto-confirmで承認スキップ（危険、CI 向け限定）- 変更前のスナップショットが
.codex/snapshots/に保存される（rollback 可能） .codexignoreで除外対象を指定可（.gitignore 相当）
11. セキュリティ機能（サンドボックス・権限・許可リスト）
Codex は標準でサンドボックスを有効化。サブプロセス起動、ネットワーク接続、特定ディレクトリへの書き込みを制限。
- サンドボックスデフォルト：プロジェクトディレクトリ外への書き込み禁止
- 許可リスト：
codex config set allowed-commands "git,npm,pytest"で実行可能コマンドを限定 - サンドボックス無効化：
--dangerously-disable-sandbox。本番運用では絶対避ける
12. 料金体系完全比較
| プラン | 月額 | 使用上限 | 備考 |
|---|---|---|---|
| Free | $0 | 日次低上限 | 軽い試用のみ |
| Plus | $20/月 | 標準上限 | 個人開発者向け |
| Pro | $200/月 | Plus の10倍 | ヘビーユーザー向け |
| Team | $30/人/月 | 共有上限 | 2名以上、SSO 対応 |
| API課金 | 従量制 | — | CI/CD/プロダクション向け |
詳細は Codex 料金完全ガイド、無料プランの詳細は Codex 無料プランガイド を参照。
13. レート制限・上限・トラブルシュート
頻出のエラーと解決策。
- Rate limit exceeded：プランの上限到達。Pro 切替 or 翌日待機
- Authentication failed：
codex logout && codex loginでリフレッシュ - Sandbox permission denied：許可リスト追加 or
--dangerously-disable-sandbox（自己責任） - Connection timeout：プロキシ環境か、OpenAI 側の障害（status.openai.com 確認）
14. Claude Code との徹底比較表（10軸）
| 軸 | Codex | Claude Code |
|---|---|---|
| 提供元 | OpenAI | Anthropic |
| 主力モデル | GPT-5.x / o1 / o3 | Claude Opus 4.x / Sonnet 4.x |
| 料金（個人） | $20-200/月 | $20-200/月 |
| Team プラン | $30/人 | $30/人 |
| SSO | Team 以上 | Teams 以上 |
| 長文コード | 200K token | 200K-1M token |
| Plan Mode | あり | あり（思考モード） |
| MCP 対応 | 標準対応 | 標準対応 |
| サンドボックス | 標準有効 | 標準有効 |
| 強み | OpenAI モデル最適化、安定性 | 長文コンテキスト、慎重な推論 |
15. Cursor / Aider / Cline との比較
- Cursor：VS Code 派生 IDE。GUI 中心。Codex は CLI 中心で別物
- Aider：OSS の CLI。Codex の機能制限版・OSS 版という位置付け
- Cline：VS Code 拡張型。Codex は IDE 非依存で稼働範囲広い
16. 業務別実践例 10シナリオ
- 新規プロジェクトの初期構造生成：
codex "FastAPI プロジェクトの基本構造を生成" - テストカバレッジ向上：
codex "src/utils.py のテストを pytest で 80%" - レガシーコードのモダナイズ：
codex "jQuery を React Hooks に移植" - PR 自動レビュー：CI 内で
codex exec --read-only - API ドキュメント自動生成：
codex "OpenAPI YAML 生成" - ログ解析・異常検知：
codex exec "直近1時間のエラーログから異常パターン抽出" - マイグレーションスクリプト：DB スキーマ変更時の自動生成
- 性能最適化提案：
codex "このSQLの実行計画を分析して最適化" - セキュリティ監査：
codex --read-only "OWASP Top 10 観点でレビュー" - ドキュメント整備：READMEやArchitecture Decision Records の自動更新
17. よくあるエラーと解決策
5節・13節の補完。さらに詳細なケーススタディは別途スポーク記事で展開予定。
18. アップデート履歴（2024-2026年版）
- 2024年：Codex CLI 初期版リリース。GPT-4 Turbo ベース
- 2025年：GPT-5 / o1 / o3 対応、MCP 標準対応
- 2026年4月：GPT-5.3 Codex 専用モデル登場、Plan Mode 強化
- 2026年5月：GPT-5.5 対応、Free プラン拡充
19. 関連スポーク記事ナビ・公式リソース
料金・プラン
機能・実践
比較
公式リソース
20. まとめ
Codex は「OpenAI モデルを最大限引き出すターミナル型 AI コーディングツール」。個人 Plus（$20/月）から始めて、業務で本格活用するなら Team（$30/人/月）以上、ヘビーユーザーは Pro（$200/月）が定石です。
本記事は順次セクションを深掘り更新します。最新の情報は記事冒頭の「最終更新日」を確認してください。
著者：佐藤傑（さとう・すぐる）
株式会社Uravation代表取締役。X（@SuguruKun_ai）フォロワー約10万人。
100社以上の企業向けAI研修・導入支援。著書『AIエージェント仕事術』（SBクリエイティブ）。
※ 本記事は 2026-05-27 公開のスケルトン版です。各セクションは順次深掘り更新を予定しています。
