Codex の承認待ちと完了を Mac の通知で確認する。

Mac で Codex の通知を受け取る方法は、次の4つです。ターンとは、1回分の作業のことです。あなたがメッセージを送り、Codex が作業を進め、止まってあなたの応答を待つまでを指します。フックとは、承認を求める直前など、決まったタイミングで Codex が実行するコマンドです。

よくあるのが、notify を設定すれば承認待ちの通知も届くと思い、そのまま待ってしまうケースです。OpenAI の設定ドキュメントによると、現時点で notify が実行されるのは agent-turn-complete だけです。承認待ちの通知には、表のほかの3つの方法のいずれかを使ってください。

Codex のターミナル通知はデフォルトでオンなので、すでに届いているかもしれません。通知されるのは、ターミナル（Terminal や iTerm2 など、Codex を実行しているアプリ）が前面にないときだけです。通知するイベントを自分で選ぶには、設定ファイルで指定します。

~/.codex/config.toml に追加してください。すでに [tui] セクションがある場合は、その下に各キーを置きます。[tui] の見出しをもう1つ追加しないでください。コメント内のターミナル一覧は、Codex のドキュメントではなく、ソースコードに基づいています（後述）。

[tui]
notifications = ["agent-turn-complete", "approval-requested"]
notification_method = "auto"        # osc9 in iTerm2/Ghostty/Kitty/Warp/WezTerm; bel elsewhere
notification_condition = "unfocused" # or "always"

notification_method を auto にすると、Codex が通知方法を選びます。osc9 は特殊なコード（エスケープシーケンス）を送り、一部のターミナルがそれをデスクトップ通知として表示します。bel はターミナルのベルを鳴らします。ターミナルを見ている間も通知を受け取りたい場合は、notification_condition を "always" にしてください。

Terminal でベルしか鳴らない理由を知る。

OpenAI のドキュメントには、バナーを表示できるターミナルの名前は記載されていません。Codex の公開ソースコードでは、Ghostty、iTerm2、Kitty、Warp、WezTerm にはバナー用のシーケンスを送り、macOS に付属する Terminal を含め、それ以外のターミナルには通常のベルを送ります。この動作は今後変わる可能性があります。ベルだけではバナーは表示されません。Terminal の Settings > Profiles > Advanced > Bell では、ビジュアルベル、Dock のバッジ、ウインドウがバックグラウンドにある間の Dock アイコンのバウンドを設定できます。Terminal で実際にバナーを表示するには、後述のフックを使ってください。

tmux 内では、allow-passthrough をオンにした場合だけ、Codex のバナー用シーケンスが通ります。on では表示中のペインからのみ、all では非表示のペインからも通ります（tmux マニュアル）。次の行を ~/.tmux.conf に追加してください。非表示のペインからも通知を受け取るには、on の代わりに all と記述します。

set -g allow-passthrough on

notify はターンが完了すると1つのプログラムを実行し、詳細を1つの JSON 引数として渡します。どのターミナルでも同じように動作します。OpenAI の例では、macOS に付属しないサードパーティー製の Homebrew ツール、terminal-notifier を使っています。以下のスクリプトは macOS に付属するものだけを使います。Codex の最後の返信の冒頭とプロジェクトフォルダを表示し、通知音 Glass を鳴らします。

手順1．次の内容を新しいファイル ~/.codex/notify-macos.js として保存してください。

// Codex notify -> macOS banner + sound. Codex appends one JSON argument.
function run(argv) {
  var n = {};
  try { n = JSON.parse(argv[argv.length - 1] || "{}"); } catch (e) {}
  if (n.type && n.type !== "agent-turn-complete") return;
  var app = Application.currentApplication();
  app.includeStandardAdditions = true;
  var msg = String(n["last-assistant-message"] || "Turn complete").slice(0, 180);
  var folder = String(n.cwd || "").split("/").pop();
  app.displayNotification(msg, { withTitle: "Codex finished", subtitle: folder, soundName: "Glass" });
}

手順2．既存の ~/.codex/config.toml の、最初の [section] 見出しより上に次の行を追加してください。YOUR_NAME は自分のホームフォルダ名に置き換えます。Codex はこのリストを記述どおりに実行するため、~ は展開されません（ドキュメントではなく、Codex のソースコードに基づく情報です）。

notify = ["/usr/bin/osascript", "-l", "JavaScript", "/Users/YOUR_NAME/.codex/notify-macos.js"]

バナーが表示されない場合は、「システム設定」>「通知」を開いてください。Anthropic のフックガイドによると、osascript で送ったバナーは、そこに Script Editor として表示されるため、通知を許可する必要があります。macOS が事前に許可を求めることはないとも説明されています。お使いの Mac では、表示名が異なる場合があります。

フックを使うと、Terminal を含むどのターミナルでも、承認待ちを実際のバナーで知らせることができます。Codex は、承認を求める直前に PermissionRequest フックを、ターン完了時に Stop フックを実行します。承認が不要なコマンドでは、PermissionRequest は実行されません。

次の内容を ~/.codex/hooks.json に組み込んでください。ファイルがすでにある場合は、丸ごと置き換えないでください。ほかのツールのエントリが保存されている場合があります（Cowork Island も、アプリ内で Codex をオンにすると、このファイルにエントリを保存します）。以下の各エントリを、"hooks" 内の対応するリストに追加してください。リストがなければ作成し、各エントリはそれぞれ個別の波括弧で囲んでください。

{
  "hooks": {
    "PermissionRequest": [
      { "hooks": [ { "type": "command", "async": true, "timeout": 10,
        "command": "/usr/bin/osascript -e 'display notification \"Codex needs your approval\" with title \"Codex\" sound name \"Funk\"' >/dev/null 2>&1" } ] }
    ],
    "Stop": [
      { "hooks": [ { "type": "command", "async": true, "timeout": 10,
        "command": "/usr/bin/osascript -e 'display notification \"Codex finished\" with title \"Codex\" sound name \"Glass\"' >/dev/null 2>&1" } ] }
    ]
  }
}

1. ファイルを保存し、Codex を開いて /hooks と入力します。
2. 新しい2つのエントリを両方とも信頼してください。Codex は、新規または変更されたフックを、信頼されるまでスキップします。そのため、信頼していないフックは動作していないように見えます。
3. 末尾の >/dev/null 2>&1 は残してください。Stop フックの出力は、JSON か、何も出力しないかのいずれかである必要があります。

代わりに読み上げやスマートフォンへの通知を使うなら、通知設定ジェネレーターがブラウザ内でエントリを作成し、保存先のファイル名も示します。

2026年7月9日から、macOS の Codex アプリは ChatGPT デスクトップアプリの一部になりました。通知は設定ファイルではなく、アプリ内で設定します。

• Settings > Notifications（Cmd+,）：ターン完了の通知を、表示しない、ChatGPT がバックグラウンドにあるときだけ表示、常に表示、のいずれかに設定できます。権限リクエストと質問の通知には、それぞれ個別のスイッチがあります。
• Sound：タスク完了、権限リクエスト、質問に共通の通知音です。Default、Classic、None から選べます。macOS では、システムサウンドやインポートしたファイルも使えます。
• Activity：利用できる場合は、サイドバーのベル、または Cmd+Option+U で、未読、実行中、応答待ちのチャットを一覧表示できます。

前述の [tui] の各キーは、ターミナル内で動く Codex 用です。OpenAI のドキュメントには、デスクトップアプリ内のチャットで notify や自作のフックが実行されるかどうかは書かれていません。そのため、アプリ内でも動くとは考えないでください。

• OpenAI：高度な設定
• OpenAI：設定リファレンス
• OpenAI：設定例
• OpenAI：フック
• OpenAI：通知
• OpenAI：設定リファレンス
• OpenAI：変更履歴
• openai/codex のソースコード（ターミナル一覧のみ）
• Apple：Terminal のプロファイルの詳細設定
• Apple：通知の表示
• tmux マニュアル
• Anthropic：Claude Code フックガイド（Script Editor）

情報源の確認日：2026年10月18日。このガイドは Cowork Island の制作者が書いています。訂正については、support@coworkisland.com にメールするか、GitHub で Issue を作成してください。