📚 Codex CLI 完全ガイド¶
OpenAIが提供する公式ターミナルAI・Codex CLIの導入から高度な自動化ワークフロー構築までを体系化した日本語ガイド群です。日常のコーディング自動化から、エンタープライズでのチーム導入まで網羅しています。
対象 / ポイント
対象: Codex CLI をこれから導入する人、実行モードや料金、セキュリティを横断して把握したい人、関連記事の入口を1本にまとめて確認したい人。
ポイント:
- Codex CLI の概要、導入、承認モード、自動化、料金、比較記事への入口を1ページで把握できます
- 「何をしたいか」から読む記事を逆引きでき、関連ガイドへ最短で移動できます
- Codex app の Automation を含め、Codex 周辺の運用テーマをまとめて見渡せます
この記事のポイント¶
- Codex CLI 関連記事のハブとして、導入から運用までの導線を整理しています
- 用途別テーブルとフローチャートで、次に読むべき記事をすぐ決められます
- Codex CLI 本体だけでなく、Codex app の Automation も含めて全体像を把握できます
🔀 どの記事から読む?¶
graph TD
Q1{"Codex CLIを<br>インストールした?"}
Q2{"コマンド毎の<br>承認を省きたい?"}
Q3{"実行前に計画を<br>確認させたい?"}
Q4{"CI/CD等で<br>自動化したい?"}
Q5{"利用にコスト<br>不安がある?"}
A1["概要と<br>クイックスタート"]
A2["承認なし<br>実行ガイド"]
A3["Planモード<br>完全ガイド"]
A4["自動化<br>ワークフロー"]
A5["料金<br>完全ガイド"]
A6["ベスト<br>プラクティス"]
Q1 -- No --> A1
Q1 -- Yes --> Q2
Q2 -- Yes --> A2
Q2 -- No --> Q3
Q3 -- Yes --> A3
Q3 -- No --> Q4
Q4 -- Yes --> A4
Q4 -- No --> Q5
Q5 -- Yes --> A5
Q5 -- No --> A6
style A1 fill:#e1f5fe,stroke:#0288d1
style A2 fill:#e1f5fe,stroke:#0288d1
style A3 fill:#e8f5e9,stroke:#388e3c
style A4 fill:#e1f5fe,stroke:#0288d1
style A5 fill:#fff3e0,stroke:#f57c00
style A6 fill:#e1f5fe,stroke:#0288d1| フローの結果 | 概要 |
|---|---|
| 概要とクイックスタート | 初めてのセットアップから簡単な利用方法 |
| 承認なし実行ガイド | Auto Edit / Full Auto での効率的なコード編集 |
| Planモード完全ガイド | 先に実装計画を提示させ、同意してから実行させる |
| 自動化ワークフロー | CI連携や定型業務の自動化パターン |
| 料金完全ガイド | OpenAI/Anthropicの料金比較と節約術 |
| ベストプラクティス | 日常開発の効率を最大化する実践Tips |
📋 やりたいこと別ガイド¶
🔰 導入・基本・比較¶
| やりたいこと | 読むべき記事 |
|---|---|
| インストールして最初のコードを書きたい | 概要とクイックスタート |
| Claude Codeとどちらを使うべきか迷っている | Codex vs Claude Code 比較 |
| ハンズオンで実践的に学びたい | 実践ハンズオンガイド |
🚀 効率化・自動実行¶
| やりたいこと | 読むべき記事 |
|---|---|
| 承認なしでどんどんコードを書かせたい | 承認なし実行ガイド |
| 大規模改修で事前に計画を確認したい | Planモード完全ガイド |
| 計画やdiffを別Codexセッションでレビューしたい | 独立セッションレビュー |
/goal の有効化、コマンド、objective実例を知りたい | Codex /goalの使い方 |
| 「続けて」連打を減らす仕組みを理解したい | Codex /goalとは |
| 定期監視や「あとで見ておいて」を任せたい | Codex app の Automation 解説 |
| ベストプラクティスを知りたい | Codex CLI ベストプラクティス |
| 承認ポリシー・ガードレールを設定したい | 承認ポリシー実装 / 危険コマンド自動化抑止策 |
⚙️ 運用・トラブルシューティング¶
| やりたいこと | 読むべき記事 |
|---|---|
| GitHub Actions等のCIに組み込みたい | 自動化ワークフロー / GitHub Actions連携 |
| API課金のコストを抑えたい | 料金完全ガイド |
| トラブル(Contextエラーやネットワーク等)を解決したい | Contextエラー解決 / 診断ログ解読 / ネットワーク制限解決 |
🚀 Codex CLIとは?¶
Codex CLIは、OpenAIが開発した公式のコマンドライン型AIコーディングツール。ターミナル内で動作し、自然言語の指示でプログラミングタスクを自動化するエージェントだ。
| 特徴 | 詳細 |
|---|---|
| 認証 | ChatGPT Plus/Pro/Team認証で追加料金なし、またはAPIキー課金 |
| 実行環境 | ローカル実行。必要な差分・抜粋のみAPI送信 |
| 安全性 | 3段階の実行モード(Read Only / Auto Edit / Full Auto) |
| 隔離 | macOS Seatbelt、Linux Landlock+seccomp によるOSレベルサンドボックス |
| ライセンス | Apache-2.0(オープンソース) |
セットアップ手順は 概要とクイックスタート を参照。
🆕 2026年2月 最新情報
- GPT-5.3-Codex: 最新のエージェント型コーディングモデル。GPT-5.2比25%高速化
- GPT-5.3-Codex-Spark(研究プレビュー): リアルタイムコーディング向け軽量モデル。1000+ tokens/sec
- Codex CLI v0.101.0+: サンドボックス安定性向上、プロファイル永続化改善
⚙️ 実行モードと機能体系¶
Codexは実行の自動化レベルを3段階で選べる。詳細は各ガイドを参照。
| モード | 起動方法 | ファイル編集 | コマンド実行 | 詳細 |
|---|---|---|---|---|
| Read Only | codex | 提案のみ | 提案のみ | クイックスタート |
| Auto Edit | codex --auto-edit | 自動実行 | 承認必須 | 承認モードガイド |
| Full Auto | codex --full-auto | 自動実行 | 自動実行 | 承認モードガイド |
インストール、認証、最初の5分で確認すべきこと
Auto Edit / Full Autoの使い分けとガードレール設計
大規模改修を事前計画→承認→実行のワークフローで安全に
codex-review/codex-impl-reviewで計画やdiffを別Codexセッションにレビューさせる「続けて」連打を、目標保持・自動継続・完了監査のループに変える仕組み
有効化、TUIコマンド、objective実例、検証、Stop ruleをまとめて確認
実際のプロジェクトで学ぶCodex CLI活用パターン
日常開発の効率を最大化する実践Tips
チーム開発向けのセキュリティ・ガバナンス設計
🔄 自動化・CI/CD連携¶
Codex CLIはCI/CDパイプラインやスケジュール実行に組み込める。
CI連携、定型業務の自動化、スケジュール実行
通知との違い、向いている依頼、バックグラウンド運用の考え方
朝ブリーフ、調査メモ、ニュース収集、ワークフロー監査の設計例
PRレビュー・CHANGELOG更新・テスト修正の自動化
Full Autoモードのリスクを制御するガードレール
🆚 競合ツール比較¶
| 観点 | Codex CLI (OpenAI) | Claude Code (Anthropic) |
|---|---|---|
| ライセンス | OSS(Apache-2.0) | プロプライエタリ |
| 認証 | ChatGPT Plus/Pro/Team + APIキー | Anthropic API / AWS Bedrock / Google Vertex |
| 課金 | ChatGPT認証で追加料金なし / API従量課金 | Anthropic API課金準拠 |
| 隔離方式 | OSレベルサンドボックス(Seatbelt/Landlock+seccomp) | 許可ツールのホワイトリスト + 権限管理 |
詳細な比較は Codex CLI vs Claude Code 比較 を参照。
料金比較 — ChatGPT認証なら追加料金なし、APIキーなら従量課金
| モデル | 入力(100万トークン) | 出力(100万トークン) | 特記事項 |
|---|---|---|---|
| Codex CLI(o4-mini) | $1.50 | $6.00 | ChatGPT認証で追加料金なし |
| Claude Code(3.7 Sonnet) | $3.00 | $15.00 | Max/Max+プランで無制限利用 |
詳細は 料金完全ガイド を参照。
🔧 トラブルシューティング¶
| 症状 | 読むべき記事 |
|---|---|
| Context windowエラーが発生する | Contextエラー解決 |
| ネットワーク制限で接続できない | ネットワーク制限解決 |
| 診断ログの読み方がわからない | 診断ログ解読 |
🔗 関連トピック¶
Codex CLI と組み合わせて使われることが多いツール・技術のガイドです。
- Claude Code: Claude Code 完全ガイド — 自律型エージェントとの使い分け
- GitHub Copilot: GitHub Copilot 完全ガイド — IDE統合型との比較
- /goalとは: Codex /goalとは — 「続けて」連打を終わらせる自律ループ機構
- /goalの使い方: Codex /goalの使い方 — 有効化、コマンド、objective実例
- 参考リンク: Codex CLI GitHub / OpenAI Help Center / Homebrew Formula