Codex Automations 完全ガイド：スレッド自動化と単発実行を使い分ける
Codex App の Automations 機能を解説。スレッド型（ハートビート）と単発／プロジェクト型の違い、cron を含むスケジュール書式、Codex App UI と自然言語による設定、Skills 連携、Claude Code Routines との比較を 2026 年 5 月時点でまとめました。
この章の要点
- スレッド自動化（thread automations）: 既存スレッドに「ハートビート」のように戻ってくる継続型
- 単発／プロジェクト自動化（standalone / project automations）: 起動ごとに新規実行され、結果は Inbox（トリアージ）に届く
- スケジュールは分単位の継続ループ、特定時刻の日次・週次、任意の cron 構文をサポート
- 設定は Codex App の Automations ペインか、スレッド内の自然言語指示
- Skills を
$skill-nameで呼び出して定型処理を再利用できる
Codex Automations とは
Codex App に組み込まれた定期実行の仕組みです。長時間タスクの進捗ウォッチ・GitHub の定期トリアージ・調査ループの継続実行などを、Codex に任せて回せます。
「同じ会話に戻り続けるか、新規セッションを毎回切るか」で 2 種類のタイプが用意されており、目的に応じて使い分けます。
公式仕様の概要
公式 /codex/app/automations では、スレッド型と単発／プロジェクト型の概念差、スケジュール書式（分単位ループ／日次・週次／cron）、Codex App UI とスレッド内自然言語での設定方法、Skills との統合が説明されています。
使い方
タイプの違い
| タイプ | 振る舞い | 向いているタスク |
|---|---|---|
| スレッド自動化（Thread） | 既存スレッドにハートビート的に戻り、同じコンテキストで続きを実行 | ビルド完了待ち、PR ステータスの追跡、調査ループの継続 |
| 単発自動化（Standalone） | 起動のたびに新規セッションを開始。結果はトリアージ（Inbox）に届く | 日次レポート、独立した定期チェック |
| プロジェクト自動化（Project） | 指定したプロジェクト上で新規セッションを起動。対象プロジェクトをローカルで開いた状態で Codex App が稼働している必要がある | 特定リポジトリでの定期メンテナンス・横断バッチ |
スケジュール書式
公式ドキュメントは「分単位の継続ループ／日次・週次スケジュール／カスタム cron 構文」をサポートと明記しています。具体的な自然言語表記の文法（タイムゾーンや曜日指定の書式）は公式に明示されていないため、下表の自然言語例は UI で動作するかを実機で確認してから使ってください。
| 形式 | 例 |
|---|---|
| 分単位の継続ループ | every 30 minutes |
| 日次 | daily at 9am JST（表記は要確認） |
| 週次 | every Monday at 8am（表記は要確認） |
| cron 構文（カスタム） | 0 2 * * 1-5（平日 2 時） |
設定方法
- Codex App UI: Automations ペインから対話式に作成・編集・無効化できます。
- スレッド内の自然言語: 既存スレッドで「30 分ごとに戻ってきてビルド状況を確認して」と頼むと、その場で自動化が登録されます。
- Skills の併用:
$skill-nameで定型ワークフローを呼び出せるため、長いプロンプトを毎回書かなくて済みます。
効果的なプロンプト設計
公式の推奨パターンは「何をするか／いつ報告するか／いつ停止するか」を明示することです。
# 週次コードレビュー Automation
## 何をするか
毎週月曜 8 時に先週マージされた PR を一覧取得し、
コードの品質・テストカバレッジ・セキュリティリスクを評価してください。
## いつ報告するか
評価完了後、Slack #code-review チャンネルにサマリーを投稿してください。
指摘が 5 件以上ある場合は @channel メンションを付けてください。
## いつ停止するか
PR が存在しない週はサマリーを投稿せず終了してください。
GitHub API が 3 回連続で失敗した場合は停止してください。主要ユースケース
長時間タスクの進捗監視（スレッド型）
30 分ごとに戻ってきてビルド状況を確認してください。
完了していれば結果を要約し、失敗していればエラーログを解析して修正案を提示してください。
成功またはエラー解決後は自動停止してください。GitHub 定期ウォッチ（単発型 / 日次）
毎時、リポジトリのオープン Issue を確認し、
`triage` ラベルが付いていないものに適切なラベルを自動付与してください。
1 回あたり最大 10 件を処理し、処理済み Issue 番号を記録しておいてください。PR レビューループ（スレッド型）
新しい PR レビューコメントが投稿されたら、コンテキストを確認して返信してください。
レビューが「LGTM」または「Approved」になったらこのスレッドを停止してください。Skills との連携
Skills を呼び出すと、プロンプト本文をトリガー条件と最終出力の記述に絞れます。
$pr-summary を実行し、結果を Slack #release に投稿してください。
PR が 0 件の週はメッセージを送らないでください。外部イベントとの連携について
公式 /codex/app/automations 自体はスケジュール起動を中心に説明しており、GitHub Webhook 等の外部イベントトリガーは Automations の機能としては明示されていません。GitHub イベントに反応させたい場合は openai/codex-action@v1 を使った Workflow（CI/CD 連携の章を参照）と組み合わせるのが堅実です。
Claude Code Routines との比較
| 項目 | Codex Automations | Claude Code Routines |
|---|---|---|
| コンテキスト | スレッド型は同一スレッドで継続／単発型は新規セッション | タスクごとに新規（履歴の引き継ぎは限定的） |
| トリガー | スケジュール・cron が中心 | スケジュール・API・GitHub Webhook 等 |
| 設定 UI | Codex App の Automations ペイン | Claude Code の Routines 設定 |
| 結果の受け取り | スレッド継続 or トリアージ Inbox | プラン依存・通知系統に応じる |
| 得意タスク | 長期継続・監視ループ・反復修正 | イベント駆動・短いバッチ処理 |
長期間継続するタスク（監視・調査・反復修正）は Codex Automations のスレッド型が向いており、外部イベントを起点にした単発処理は Claude Code Routines のほうが整理しやすい場面があります。
注意点・セキュリティ観点
スレッド型は停止条件を明示する スレッド型はタスクが終わるまで戻り続けます。条件が曖昧だと不要な実行が増えるため、「いつ止めるか」を必ず書いてください。
コストとレートリミットを意識する 分単位の継続ループはトークン消費が積み上がります。短い間隔で長期間回す場合は、サマリーだけ取得して詳細はリクエスト時のみ展開するなど、消費を抑える工夫を加えてください。
機密情報を投稿チャネルに流さない Slack や Inbox への出力にシークレットや個人情報が含まれていないか、プロンプト側で明示的にフィルタしてください。
外部トリガーは別経路で組む
GitHub Webhook 等の外部イベントを起点にする場合は Automations 単独ではなく、openai/codex-action@v1（GitHub Actions 連携）や Routines 系との組み合わせを選びます。
サンドボックス・承認モードは Codex App 側の設定で確認する
Automations はバックグラウンドで Codex セッションを起動するため、ファイル書き込みや外部通信が想定外に走らないかを App の権限設定で事前に確認してください。Automations 専用フォームで model や reasoning effort、ローカル／worktree 実行などを切り替えられます（--sandbox などの CLI フラグが Automations に直接引き継がれるかは公式に明示されていません）。