【保存版】初心者向けCodexの教科書
いち(AirCle代表 / AI×マーケ)による、OpenAI Codex × GPT-5.5 × GPT image 2 の全体像を網羅した初心者向け教科書記事(note, 2026-05-07)。
OpenAI 公式資料・システムカード・APIドキュメント・開発者ガイド(2026年4月29日時点)を読み込み、「何も知らない状態から一通り使えるようになる」レベルで解説されている。
核心メッセージ
「ClaudeCodeだけ触ってればいい」時代は、もう完全に終わりました。4月24日。GPT-5.5の登場で、Codexの精度が”別次元”まで跳ね上がりました。
ChatGPTは「会話するAI」、Codexは「作業するAI」という区別が本記事の出発点。
Codex とは何か
OpenAI Codex はAIコーディングエージェント。ファイルを開いて・コードを書き換えて・テストを走らせて・結果を確認するところまで自動で行う。
2026年4月の大型アップデート「Codex for (almost) everything」でコード以外の業務(Jira・Slack・Notion・Google Workspace・HubSpot など90以上のツール)にも対応し、「ほぼ万能のAIエージェント」に進化。
3つの使い方
| 種別 | 概要 | 推奨対象 |
|---|---|---|
| デスクトップアプリ | アプリをDLしてログインするだけ。ターミナル不要 | 初心者 |
| Codex CLI | ターミナルで動くOSS(Apache 2.0)エージェント | ターミナル慣れしている人 |
| Codex Cloud | クラウド上でバックグラウンド並列実行。GitHub連携 | チーム開発 |
初心者はデスクトップアプリから始め、慣れたらCLI→Cloudへ移行するのが推奨ロードマップ。
GPT-5.5 の性能
2026年4月23日リリース、コードネーム「Spud」。Codexの推奨モデルとして位置づけられている。
主要スペック
| 指標 | 値 |
|---|---|
| コンテキストウィンドウ | 1,050,000トークン(日本語約80万文字 ≒ 新書8冊) |
| 最大出力 | 128,000トークン |
| マルチモーダル | テキスト・画像・音声・動画を入力可能 |
| 推論努力レベル | none / low / medium / high / xhigh の5段階 |
ベンチマーク(競合比較)
| ベンチマーク | GPT-5.5 | Claude Opus 4.7 | Gemini 3.1 Pro |
|---|---|---|---|
| Terminal-Bench 2.0(エージェント自動化) | 82.7%(歴代1位) | 69.4% | — |
| GPQA Diamond(大学院レベル知識) | 93.6% | 94.2% | 94.3% |
| SWE-Bench Pro(ソフトウェアエンジニアリング) | 58.6% | 64.3% | — |
→ エージェント自動化(Terminal-Bench)での圧倒的優位が Codex × GPT-5.5 の最大の強みとなっている。
gpt-image-2 との連携
GPT image 2(ChatGPT Images 2.0)は GPT-5.5 と同週(2026年4月21日)にリリース。
- 日本語テキストを画像内に正確に描画(12以上の言語で95%以上の文字レベル精度)
- Codexからgpt-image-2を呼び出すのに特別な設定不要
- 1プロンプトで最大8枚の一貫画像生成、最大16枚の参照画像からの編集
- 最大3840px高解像度出力
- 料金:実質1枚あたり約0.21
設定ファイル(~/.codex/config.toml)
model = "gpt-5.5"
approval_policy = "on-request"
sandbox_mode = "workspace-write"approval_policy(承認ポリシー):
"untrusted"— 読み取り専用のみ自動実行(最も安全)"on-request"— 必要に応じて確認(推奨)"never"— 確認なしで全実行(上級者向け)
sandbox_mode(サンドボックス):
"read-only"— ファイル読み取りのみ"workspace-write"— ワークスペース内の読み書き+コマンド実行(推奨)"danger-full-access"— 制限なし
初心者は on-request + workspace-write で始めることを推奨。
料金体系
ChatGPTプラン経由(初心者向け)
| プラン | 月額 | GPT-5.5 | Codex |
|---|---|---|---|
| Free | $0 | 利用可 | 期間限定 |
| Go | $8 | 利用可 | 期間限定 |
| Plus | $20 | 利用可 | 利用可 |
| Pro | 200 | フル機能 | フル機能 |
→ 初心者はFreeで試し、本格利用なら Plus($20/月)が推奨。
API直接利用(中級者以上)
| モデル | 入力(1Mトークン) | 出力(1Mトークン) |
|---|---|---|
| GPT-5.5 | $5.00 | $30.00 |
| GPT-5.4 | $2.50 | $15.00 |
| GPT-5.3 | $1.75 | $14.00 |
割引オプション:Batch / Flex いずれも 50%オフ。 注意:272,000トークン超の長コンテキスト入力は入力2倍・出力1.5倍の割増料金。
プロンプト設計(4要素構造)
GPT-5.5 での推奨プロンプト構造:
| 要素 | 内容 |
|---|---|
| Goal(目的) | 何を達成したいか |
| Context(文脈) | どういう状況・環境か |
| Constraints(制約) | やってはいけないこと・制限条件 |
| Done when(完了条件) | 何をもって「完了」とするか |
→ プロンプト設計 の4要素構造と一致。「ユーザー登録APIを作って」だけでなく完了条件まで明記することで出力精度が劇的に向上する。
デバッグ・テスト生成の実践
- エラーログをそのまま渡すことが核心(「動きません」ではなく「スタックトレース全文 + 修正して」)
- GPT-5.5 の1,050,000トークンコンテキストにより、長いエラーログも全量渡せる
codex "このテストが落ちている原因を調べて修正して。テストが通ることを確認して。"でread→analyze→fix→retest を自動実行
セキュリティ構造
2層のセキュリティ:
- サンドボックスモード — 技術的に「できること」の範囲を制限
- 承認ポリシー — 境界を超える操作の前に確認
Codex Cloudは隔離されたOpenAI管理コンテナで実行。ローカルのCLI/IDE拡張もOSレベルでサンドボックスが強制される。
IDE連携
- VS Code: Marketplace から「Codex - OpenAI’s coding agent」をインストール。Claude Code や GitHub Copilot との同時利用可能。モデル切り替え・推論努力・承認モードをエディタ内から変更可能。
- JetBrains (IntelliJ / PyCharm / WebStorm 等): 2026年1月からネイティブ統合。バージョン2025.3以降で利用可能。
実際の活用事例(OpenAI社内)
- OpenAI社内では 85%の社員が毎週Codexを使用
- 財務チーム:24,771件のK-1税務書類(71,637ページ)をCodexでレビュー → 前年より2週間短縮
- マーケティングチーム:週次ビジネスレポート生成の自動化 → 週5〜10時間節約
ゼロから使いこなすロードマップ
| ステップ | 内容 |
|---|---|
| Step 1(理解) | ChatGPT=会話するAI / Codex=作業するAI の区別を理解 |
| Step 2(始める) | デスクトップアプリをDL・ログイン(5分) |
| Step 3(基本操作) | Goal/Context/Constraints/Done whenの4要素プロンプト |
| Step 4(実践) | エラーログをそのまま渡す・テスト自動生成・IDE連携 |
| Step 5(コスト最適化) | 普段はGPT-5.4、複雑な処理だけGPT-5.5。Batch/Flexで50%オフ |
| Step 6(応用) | gpt-image-2で画像生成・Cloudで並列タスク・プラグインで業務自動化 |