✦ 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-09-03 GPT-6 Astra統合 · Vimモードundo/redo · プラグインマーケットプレイス

0.153.0 / GPT-6 Astra

GPT-6 Astra統合: OpenAIの新フラッグシップモデル(コンテキスト1Mトークン)にCodex CLIが0.153.1〜0.153.4で順次対応。Amazon Bedrockのモデル選択肢にも追加。

0.153.0: Vimモードにu(undo)・Ctrl+R(redo)を追加。プラグインCLIがリモートマーケットプレイスからのプラグイン一覧表示・インストール・削除に対応。

Guardianのレビュー履歴がcompaction・再起動・ユーザー作成のフォークをまたいで保持されるように。詳細はニュース参照

2026-09-01 Vimモードにドラフト内検索 · レート制限バナー刷新 · planningツール既定無効化

0.152.0-0.152.1

ドラフト内検索: Vimモードに/?によるドラフト内検索・ハイライト・n/Nナビゲーションを追加。

レート制限バナー刷新: 利用量確認・クレジット管理・上限リセット・プラン変更のアクションを提供するように。

planningツール既定無効化⚠️: 挙動が変わる変更。

Guardian承認レビューがモデルメタデータ経由のNode REPLポリシーを正しく反映するよう修正(🔒、0.152.1)。詳細はニュース参照

2026-08-29 拡張機能がMCPツール結果を検査/置換可能に · Guardian誤承認修正

0.151.0

MCPツール結果の検査/置換: 拡張機能がMCPツール結果をモデル到達前に検査・置換可能に。

Guardian誤承認修正🔒: stale Guardian分類による権限変更後の誤承認を修正。

ネストしたsubagentのトークン使用量をルートのgoal budgetに算入するように。詳細はニュース参照

★ 概要
  • 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指定)
03⚠️ --profile が唯一のセレクタに統一(v0.134.0 破壊的変更)

v0.134.0より --profile フラグがCLI・TUI・サンドボックス全体のプロファイル指定方法として一本化。旧来の設定形式は明示的に拒否されてマイグレーションガイダンスが表示される。

# 推奨: --profile を必ず明示
codex --profile myprofile "タスク内容"

CI/CDのcodexコマンドや既存のconfig.tomlにレガシーなプロファイル指定がある場合は --profile 形式に統一すること。

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で自動化
◀ ホームへ   ★ 技術比較ページへ