✦ OpenAI Codex ✦ 5種Hook GA ✦ Goal mode ✦ Automations ✦ カスタムプロバイダー ✦ AGENTS.md ✦ Subagents ✦ Skills ✦ Azure OpenAI対応 ✦ ChatGPT mobile連携 ✦ OpenAI Codex ✦
OpenAI · Codex

OpenAI Codex
Best Practices

Goal mode · Hooks GA · Automations · カスタムプロバイダー

5種Hook GA Goal mode Automations カスタムプロバイダー

★ 直近3アップデート — OpenAI Codex
2026-05-22 Goal mode GA · AppShots ⌘⌘ · codex doctor

Codex

Goal mode GA: 数日〜1週間単位の継続タスク実行が正式GA。ゴールを定義するとCodexが自律的に計画→実行→修正を繰り返す。最大72h継続実行、チェックポイントでgit commitが自動作成される。

AppShots ⌘⌘: ⌘⌘ショートカットで他アプリのスクリーンショットをCodexへ即座に転送。デザインツール・ブラウザのUIをそのままコーディングに活かせる。

codex doctor: 新しい環境診断コマンド。APIキーの有効性・設定ファイルの問題・依存関係の確認を自動実行してレポートを生成。

2026-05-17 Hooks GA · Codexアクセストークン · ChatGPT mobile接続

Codex

Hooks GA: 5種類のHooksシステムが正式GA。PreToolUse / PermissionRequest / PostToolUse / UserPromptSubmit / Stop。managed_dirでエンタープライズ強制Hooksを配布できる。Codexアクセストークンとの組み合わせでCI/自動化パイプラインが構築可能。

ChatGPT mobile接続: iOSアプリからリモートでCodexに接続可能に。Remote Controlを有効化→QRコードスキャンでセットアップ。長時間Goal modeタスクをモバイルから監視・方向転換できる。

2026-05-15 GPT-5.3-Codex-Spark Preview · --full-auto 廃止予告

Codex

GPT-5.3-Codex-Spark (Preview): 軽量高速モデル。コスト比でGPT-5の約1/5。ルーティング・ステップ間判断・シンプルな補完に最適。Goal mode内の計画ステップに使うとコスト削減効果が大きい。

--full-auto 廃止予告: --full-autoフラグは廃止予定。config.toml[approval_policy]設定に移行する。default = "on-failure"(失敗時のみ確認)など細かい制御が可能になる。

★ 概要
  • OpenAI製 · CLI(Mac/Linux/WSL)
  • 5種類のHookシステム(GA)
  • Goal modeで数日単位の継続実行
  • Automations(cron + webhook)
  • カスタムプロバイダー(Azure/社内LLM)
  • config.toml(TOML形式・コメント可)
  • AGENTS.md でコンテキスト管理
  • ChatGPT mobileからリモート監視
  • Skills(Open Agent Skills仕様準拠)
★ ベストプラクティス Top10
  • Goal / Context / Constraints / Done when の4要素をプロンプトに
  • Plan Modeで実装前にリポジトリを探索させる
  • HooksとCIをアクセストークンで統合する
  • Goal modeはSkill化してから長期委任する
  • カスタムプロバイダーでベンダーロックを避ける
  • Automationsはスケジュール前にSkill化する
  • --full-auto廃止前にapproval_policyへ移行する
  • AGENTS.md description精度が暗黙発火の品質を決める
  • PR並列レビューは6観点×1エージェントで実施する
  • ChatGPT mobileで長時間タスクの監視コストを下げる
設定システム — config.toml
01完全な config.toml 例(Hook + Automations + Provider)
# ~/.codex/config.toml
[features]
codex_hooks  = true
goal_mode    = true

[approval_policy]
default      = "on-failure"

[hooks]
managed_dir  = "/enterprise/hooks"

[[hooks.PreToolUse]]
matcher      = "^Bash$"
[[hooks.PreToolUse.hooks]]
type         = "command"
command      = "python3 /hooks/policy.py"
timeout      = 30

[automations]
schedule     = "0 9 * * 1"
webhook_url  = "https://hooks.slack.com/services/..."

[goal]
timeout      = "72h"
enabled      = true

[provider]
type         = "azure"
endpoint     = "https://my-azure.openai.azure.com"
model        = "gpt-4o"
023スコープ構造
スコープファイル対象範囲
User~/.codex/config.toml自分・全プロジェクト
Project.codex/config.tomlリポジトリ全員(Git管理)
Enterpriserequirements.toml組織強制(managed_dir指定)
AGENTS.md — コンテキスト管理
01AGENTS.md テンプレート
# AGENTS.md
## Project
TypeScript monorepo (pnpm workspaces)
Node 22 / React 19 / PostgreSQL 16

## Build & Test
build: pnpm build | test: pnpm test | lint: pnpm lint

## Rules
- Never commit to main directly
- TDD: write tests before implementation
- All API endpoints require Zod validation

## Done when
- pnpm test passes
- pnpm lint clean
- pnpm tsc --noEmit succeeds

セッション開始時に自動ロード。CLAUDE.mdと互換した設計のため既存CLAUDE.mdをそのまま使える。

Hooks — 5種類 GA (2026-05)
015種類のイベントと特徴
イベントタイミング
PreToolUseツール実行前(denyで強制ブロック・--yolo下でも有効)
PermissionRequest承認要求時
PostToolUseツール実行後(自動フォーマット等)
UserPromptSubmitユーザーのプロンプト送信時
Stopターン終了時(バリデーション強制)

複数ファイルからマッチしたHooksは全て実行。同一イベントの複数コマンドHookは並列起動

02実装例 + エンタープライズ強制
[[hooks.PreToolUse]]
matcher       = "^Bash$"
[[hooks.PreToolUse.hooks]]
type          = "command"
command       = "python3 /hooks/pre_tool_use_policy.py"
statusMessage = "Checking Bash command policy"

# エンタープライズ強制: requirements.toml
[hooks]
managed_dir   = "/enterprise/hooks"  # 全ユーザーに強制適用
Subagents — 並列エージェント
01カスタムエージェント定義(TOML)
# .codex/agents/security-reviewer.toml
model                  = "gpt-5.4"
sandbox_mode           = ":read-only"
model_reasoning_effort = "high"
nickname_candidates    = ["Sherlock", "Inspector"]
  • 個人用: ~/.codex/agents/ / プロジェクト共有: .codex/agents/
  • 省略したフィールドは親セッションから継承
  • agents.max_depthはデフォルト1(再帰的委任が必要な場合のみ変更)
02PR並列レビューパターン + ChatGPT mobile

6観点×1エージェントで並列PRレビュー: セキュリティ・コード品質・バグ・競合状態・テスト安定性・保守性

ChatGPT mobile接続: Remote Controlを有効化→QRコードスキャン。長時間タスクをモバイルから監視・承認できる。

Skills — Open Agent Skills 仕様準拠
01SKILL.md 構造と例
--- commit/SKILL.md ---
name: commit
description: Stage and commit changes in semantic groups.
  Use when the user wants to commit or organize commits.
---
1. Do not run `git add .`. Stage in logical groups.
2. Group: feat → test → docs → refactor → chore.
3. Write concise commit messages.
  • 個人用: ~/.codex/skills/ / チーム: .agents/skills/
  • 組み込み: $skill-creator / $skill-installer
  • descriptionの精度が高いほど暗黙的トリガーの信頼性が上がる
Goal mode — 長期継続タスク GA
01Goal mode の仕組みと設定
[goal]
timeout    = "72h"
enabled    = true
checkpoint = "8h"
  • ゴールを定義するとCodexが自律的に計画→実行→検証→修正を繰り返す
  • チェックポイントでgit commitが自動作成される
  • 途中でChatGPT mobileから方向転換・承認が可能
  • タイムアウト時は最後のチェックポイントから再開可能
Managed Agents — Codexでの対応について
Claude Code相当のManaged Agentsは未実装

Claude CodeのManaged Agents(Dreaming / Outcomes / Multiagent Orchestration)に相当する統合エージェントOS機能はCodexに存在しない。

01代替アプローチ
機能Codexでの代替
Dreaming(セッション間記憶)AGENTS.mdに手動でルール・学習を蓄積する
Outcomes(評価ループ)Stop Hookでテスト実行→失敗時に再実行する
Multiagent OrchestrationSubagents + Goal mode内での並列タスク分解

Codexの強みはGoal modeによる長期タスク委任。細かいエージェント制御よりも「ゴールを定義して長期委任する」スタイルが向いている。

Automations — スケジュール実行 App限定
01設定(config.toml + Codex App)
[automations]
schedule    = "0 9 * * 1"   # 毎週月曜 9:00
webhook_url = "https://hooks.slack.com/services/..."
task        = "週次PRレビューサマリーを生成してSlackへ通知"
worktree    = true
  • Webhook URLを指定するとSlack/Discord/カスタムエンドポイントに完了通知
  • Automationsはスキルを参照できる($skill-name形式)
  • 判断基準: まずSkillで手順を定義 → 安定したらAutomationsで自動化
★ 更新ログ
2026-05-22CodexGoal mode GA。AppShots ⌘⌘。codex doctorコマンド追加。
2026-05-17CodexHooksシステムGA(5種類)。Codexアクセストークン。ChatGPT mobileからリモート監視・承認。
2026-05-15CodexGPT-5.3-Codex-Spark (Preview)公開。--full-auto廃止予告(approval_policyへ移行)。
◀ ホームへ   ★ 技術比較ページへ