AIナレッジ
OpenAI公式「Codex 101」完全攻略マニュアル
前提知識ゼロから始める「ガチで強い」AIコーディングエージェント実装ガイド
「AIでプログラミングができるのは知っているけれど、結局どこから手を付ければいいかわからない……」
「専門用語ばかりで、最初の一歩で挫折してしまった……」
そんな悩みを抱えていませんか？
2026年3月18日、OpenAIはこれまでの「難しそう」という常識を完全に覆す、完全無料の公式オンボーディング資料「Codex 101: Introduction and Onboarding」を公開しました [1]。
これまで一部のギークや強者エンジニアだけのものだった、最強のコーディングエージェント「Codex」。その導入から実践、さらには開発現場への組み込み方までを、前提知識ゼロの初心者でも100%理解できるように徹底解説します。
「Codexって難しそう」そう思って避けていた人は、今日で完全に状況が変わります。
これは単なるノウハウ紹介ではありません。現場で実際に回り、売上や工数削減に直結する「本物のAI実装手順」です。
1. OpenAI Academy「Codex 101」とは？
OpenAI Academyで公開された「Codex 101」は、コーディングエージェント「Codex」を実務に導入するための公式ワークショップ資料です [1]。
1.1 ワークショップの全体像
本資料は、以下の5つの「ライトニングトーク（Lightning Talks）」と、実践的な「マイクロハッカソン」で構成されています。
| セクション | タイトル | 主な学習内容 |
|---|---|---|
| 01 | Introduction and Setup | CLI、アプリ、IDEでのインストールとログイン方法 |
| 02 | Understanding Agents | 自律型AIが動く仕組み「エージェント・ループ」の理解 |
| 03 | Using Codex in the SDLC | 開発ライフサイクル（計画〜保守）へのCodexの組み込み方 |
| 04 | How to Delegate to Agents | 効果的なプロンプトの型、AGENTS.mdの書き方と優先順位 |
| 05 | How Teams are Using Codex | Cisco、Datadog、楽天、Sora開発チームでの実例紹介 |
1.2 資料へのアクセス方法
アクセスは非常にシンプルです。
- OpenAI Academy の公式リソースページ にアクセスします [1]。
- ページ内の「Open PDF in new tab」をクリックするだけで、誰でも無料で資料を閲覧・ダウンロードできます。
図1：OpenAI Academy の「Codex 101」公開ページ。ここからワンクリックで公式PDFにアクセス可能。
2. 3つのアプローチと提供クライアント
AIを活用したコーディングには、大きく分けて3つのアプローチがあります。
2.1 AIコーディングの3つのアプローチ
- コード補完（Code Complete）：従来の入力補完。次に書くべきコードを1行ずつ提案します。
- ペアプログラミング（Pair Programming）：チャット形式でAIと対話しながら、協調してコードを書いていきます。
- エージェントへの委譲（Agentic Delegation）：Codexが採用しているアプローチです。 ゴールと制約を与えるだけで、AIが自律的にファイルを読み込み、ツールを使い、テストを実行してタスクを完了させます。
2.2 Codexの3つのクライアント
Codexは、あなたの作業スタイルに合わせて3つの環境（クライアント）で動作します。性能はどれも同じですが、UIや機能が少し異なります。公式ワークショップでは、最も視覚的で並行処理に強い「Codex App」を推奨しています。
| クライアント | 特徴 | 推奨されるユースケース |
|---|---|---|
| CLI（コマンドライン） | ・インストールが最も簡単（ゼロ依存） ・ /compact /fork /new などの強力なスラッシュコマンドを搭載 | ターミナルから離れたくないエンジニア、素早いセッション開始 |
| Codex App（デスクトップアプリ） | ・複数のワークスペースで並行してタスクを実行可能 ・差分（Diff）表示が最も見やすく、視覚的に分かりやすい | 公式推奨。 複雑なワークフロー、エージェントへの自律的なタスク委譲 |
| IDEs（VS Code / JetBrains / Xcode） | ・使い慣れた開発環境にプラグインとしてシームレスに融合 ・チャット形式でのクイックな支援に最適 | 日常的なコーディング中のコード補完、部分的なデバッグやリファクタリング |
3. 前提知識ゼロでもできる！インストール＆ログイン手順
それでは、実際にCodexを導入してみましょう。驚くほど簡単です。
図2：公式資料で紹介されている3つのインストール方法。
3.1 CLI（コマンドラインインターフェース）
ターミナルを開き、以下のコマンドを順番に実行するだけです。
# npmを使う場合 npm install -g @openai/codex # MacでHomebrewを使う場合 brew install --cask codex # ログイン（ブラウザが起動し、ChatGPTアカウントで認証します） codex login # セッションを開始する codex
3.2 Codex App（デスクトップアプリ）
- openai.com/codex/ にアクセスしてアプリをダウンロードします。
- ダウンロードしたファイルを「アプリケーション（Applications）」フォルダにドラッグ＆ドロップします。
- アプリを起動し、ChatGPTのアカウントでサインインします。
3.3 IDE（VS Codeなど）
- VS Codeなどの拡張機能（Extensions）ペインを開きます。
- 「OpenAI Codex」と検索し、インストールをクリックします。
- ChatGPTのアカウントでサインインして連携を完了します。
4. なぜCodexは賢いのか？「エージェント・ループ」と「コンテキスト」
多くの人が「AIはすぐに嘘をつく（ハルシネーション）」「大きなプロジェクトだと指示を忘れる」と不満を持ちます。Codexは、この問題を「エージェント・ループ」と「コンテキスト管理」という2つの仕組みで解決しています。
4.1 エージェント・ループ（Agentic Loop）の仕組み
Codexは、ユーザーからのプロンプト（指示）を受け取ると、単にコードを生成して終わりにはしません。
ユーザーの指示（プロンプト）
↓
【推論（Model Inference）】: 「何をすべきか？」を考える
↓
【ツール実行（Tool Calls）】: ファイルの読み込み、テストの実行、コマンド実行
↓
【結果の評価（Agent Response）】: 「指示通りにできたか？」を検証する
↓ （できていなければループに戻る）
完了後にユーザーへ報告このように、「考えて、実行して、確認する」というサイクルを自律的に繰り返すため、正確性が圧倒的に高いのです。
4.2 コンテキスト（Context）の重要性
「コンテキスト」とは、AIにとっての「作業用メモリ（記憶）」です。
Codexは、一度に数百ページ（400〜600ページ分、トークン数にして数十万）のドキュメントをこのメモリに保持できます。
コンテキストが整理されているほど、AIの出力は安全で、正確で、一貫したものになります。
4.3 自動コンテキスト圧縮（Intelligent Context Compression）
メモリが限界（約90%）に達すると、Codexは自動的に過去の不要な履歴を要約・圧縮（Auto compaction）します。これにより、長時間のコーディングセッションでも「指示を忘れる」「動作が重くなる」といったことがありません。
5. 開発ライフサイクル（SDLC）を爆速化するCodexの役割
Codexは、コードを書く「Build」のフェーズだけでなく、システム開発のすべての工程（SDLC）で人間のエンジニアをサポートします。
図3：計画から運用まで、Codexがエンジニアを強力にバックアップ。
| 開発フェーズ | Codex（エージェント）の役割 | 人間（エンジニア）の役割 |
|---|---|---|
| Plan（計画） | 不足している詳細仕様や前提条件の洗い出し | 優先順位の決定、タスクの順序整理 |
| Design（設計） | 初期プロトタイプや骨組みのスケッチ | 設計方針、重要な技術選定、制約の決定 |
| Build（実装） | 実際のコード記述、バグの自動修正 | 設計パターンの指示、トレードオフの調整 |
| Test（テスト） | テストコードの新規作成、既存テストの更新 | テスト範囲（カバレッジ）と意図の確認 |
| Review（レビュー） | プルリクエスト（PR）の1次レビュー | 最終承認、コード品質の最終チェック |
| Document（ドキュメント） | 仕様書、変更サマリー、解説書のドラフト作成 | 内容の正確性と決定事項の整合性確認 |
| Deploy & Maintain（運用） | ログやアラートの自動分析・原因特定 | 高リスクな障害への対応、意思決定 |
6. 実践！Codexの能力を120%引き出す「プロンプトの型」
Codexを動かす際、「完璧なプロンプト」を書こうとする必要はありません。
それよりも、Codexが迷わないように「コンテキスト（文脈）」をきれいに整えてあげることが重要です。
公式ワークショップでは、作業を予測可能にし、手戻りを防ぐための「ミニ・プロンプトテンプレート」が推奨されています。
6.1 ミニ・プロンプトテンプレート（4つの要素）
この4つの要素をプロンプトに含めるだけで、Codexの実行精度は劇的に向上します。
- Goal（ゴール）：達成したい具体的な成果、変更内容、そして「なぜそれが必要なのか」の理由。
- Context Pointers（文脈の指定）：参考にしてほしい既存のファイル、実装パターン、類似のコード例（
@でファイルを指定）。 - Constraints（制約条件）：やっていいこと、やってはいけないこと、命名規則やスタイルのルール。
- Done When（完了条件）：タスクが完了したとみなす基準（実行すべきテスト、コマンド、期待される動作）。
6.2 プロンプト作成の極意（Tips）
- 極限までシンプルに： 長々と説明するより、「ゴール ＋ 制約 ＋ 完了条件」を短く書く方がCodexは正確に動きます。
- 検証手順を埋め込む： 「完了したら
pnpm testを実行して、エラーが出ないことを確認して」と指示します。Codexがテストを実行できない環境の場合は、「テストを実行するための具体的なコマンドと、確認すべきポイントを箇条書きで教えて」と指示します。 - ファイル指定（@mention）を活用する： 修正対象や参考ファイルを
@filenameで直接指定し、Codexの探索範囲を絞り込みます。 - エラー時はスタックトレースを丸ごと貼る： デバッグの際は、エラーメッセージ、再現手順、環境情報をそのまま貼り付けることで、Codexが瞬時に原因を特定します。
7. 最強の武器『AGENTS.md』でCodexを自社専用にカスタマイズする
Codexを使いこなす上で、最も重要と言っても過言ではないのが『AGENTS.md』の活用です。
図4：AGENTS.mdは、自社の開発ルールをCodexに自動で読み込ませるためのオープンフォーマット。
7.1 AGENTS.mdとは？
Codexは、起動した直後はあなたのプロジェクトの「独自のルール（命名規則、テストの実行方法、ディレクトリ構成など）」を何も知りません。
AGENTS.mdは、プロジェクトのルートディレクトリに置いておく、「AIエージェント向けの説明書」です。
これを用意しておくだけで、Codexは起動時に自動でルールを読み込み、 retries（やり直し）を減らし、安全なコード変更を行うようになります。
💡 プロの裏技：
ターミナルで/initコマンドを実行すると、現在のプロジェクトを分析して、スターター用のAGENTS.mdを自動生成してくれます。
7.2 AGENTS.mdに書くべき4つの基本セクション
- Repo map（リポジトリ構成）： 重要なディレクトリ、主要なモジュールの役割。
- How to run the project（実行手順）： インストール、ビルド、テスト、静的解析（Lint）の具体的なコマンド。
- Engineering guardrails（開発の制約）： 命名規則、PR作成時のルール、セキュリティ上の禁止事項（「do not」ルール）。
- How work gets verified（検証方法）： 「完了（Done）」の定義と、それを検証するための手順。
7.3 AGENTS.mdの優先順位（ディレクトリ優先順位）
Codexは、以下の順番で AGENTS.md を探し、内容を組み合わせて適用します。
1. グローバル設定（ ~/.codex/AGENTS.md ）
└ ユーザー個人のPC全体のデフォルト設定。最も優先度が低い。
↓
2. プロジェクト設定（ プロジェクトルート/AGENTS.md ）
└ リポジトリ全体で共通の開発ルール。
↓
3. ディレクトリ設定（ サブディレクトリ/AGENTS.md ）
└ 特定の機能やモジュール固有のルール。
↓
★ 【最優先】AGENTS.override.md
└ 一時的な上書きルール。注意点： 同一ディレクトリ内に
AGENTS.override.mdが存在する場合、AGENTS.mdよりも優先して読み込まれます。
8. 世界のトップ企業・開発チームでの驚異的な導入実績
「本当に実務で使えるの？」という疑問に対する答えが、公式資料に示されている導入実績です。
8.1 楽天：MTTR（平均復旧時間）を50%削減
「私たちは、単にコードを素早く生成することだけを求めているのではありません。安全にリリースすること（Shipping Safely）を重視しています。安全性のないスピードは成功とは言えません。
私たちの役割は、もはやコードの1行1行をチェックすることではなく、『何を望んでいるのか』を明確に定義し、それを『どう検証するか』を確立することです。」
―― 楽天 AI担当ジェネラルマネージャー 梶 友介 氏 [1]
楽天では、Codexの導入により、障害発生から復旧までの時間（MTTR）を50%削減することに成功しました。
8.2 Sora（OpenAI）：わずか28日間でAndroidアプリを開発
OpenAIの最先端動画生成AI「Sora」のAndroidアプリは、わずか4人のエンジニアで、プロトタイプ作成に18日、リリースまでに10日の、計28日間で開発されました。
- Codexのコード記述比率： 全体の 85%
- 人間の役割： アーキテクチャの設計とコードレビューに集中
- 開発プロセス： デバッグ、リファクタリング、テスト、信頼性向上をCodexの並行ワークストリームで同時に実行
- 成果： クラッシュフリー率 99.9%、Google Playストアで1位を獲得（評価 4.9/5）
8.3 Cisco：毎月1,500時間の開発時間を削減
- 削減時間： 毎月 1,500時間 のエンジニアリング工数を削減
- バグ修正スピード： 欠陥修正（Defect Remediation）が 10〜15倍 高速化
- ビルド時間： ビルド時間を 20% 削減
- 教訓： 「Codexを単なるツールとして見るのをやめ、『チームの一員』として扱い始めたときに、最大の成果が得られた」
8.4 Datadog：過去のインシデントのリスクを22%検知
- コードレビューの自動化： 1,000人以上のエンジニアが毎週Codexをコードレビューに使用
- インシデント防止： 過去に発生した障害（インシデント）の 22% について、Codexが事前にコードレビューでリスクを指摘していた
9. 今日から始める！次の3ステップ
マニュアルを読み終えたあなたが、今すぐ実践すべきステップは以下の3つです。
- 実際のプロジェクト（リポジトリ）でCodexを動かしてみる
/initコマンドを使って、自社のAGENTS.mdを作成してみる- ドキュメント作成やテストコードの作成など、身近な実務をCodexに委譲してみる
より詳細な情報や最新のアップデートは、以下の公式リソースから確認できます。
- 公式ドキュメント： developers.openai.com/codex
- Codexクックブック（実例集）： cookbook.openai.com/topic/codex
- Codex変更履歴： developers.openai.com/codex/changelog
10. 参考文献（References）
[1] OpenAI Academy, “Codex 101: Introduction and Onboarding”, March 18, 2026.
WRITERライター紹介
黒山結音
NEXT INNOVAITION 代表取締役
「AIは現場で使えなきゃ意味がない」を掲げ、30社以上にAI顧問として導入から定着までサポート。OpenClaw・Claude・ChatGPTなどAIツールを実務でフル活用し、AI駆動経営を実践。本メディアでは、実際の現場で効果が出た事例や、AI初心者がつまずく「最初の一歩」を、専門用語を極力使わずに解説します。
OpenClaw / Claude Code / Codex / Cursor / Manus
この記事をシェアする
