Erhalte am Mac eine Benachrichtigung, wenn Codex deine Genehmigung braucht oder fertig ist.

Codex kann dich auf einem Mac auf vier Arten benachrichtigen. Eine Runde ist ein Arbeitsdurchlauf: Du sendest eine Nachricht, Codex arbeitet, hält dann an und wartet auf dich. Ein Hook ist ein Befehl, den Codex zu einem festgelegten Zeitpunkt ausführt, etwa direkt bevor es dich um eine Genehmigung bittet.

Ein häufiges Missverständnis: Du richtest notify ein und wartest dann auf eine Benachrichtigung zur Genehmigung, die nie kommt. Laut OpenAIs Konfigurationsdokumentation wird notify derzeit nur bei agent-turn-complete ausgelöst. Für Genehmigungsanfragen nutze eine der anderen drei Optionen in der Tabelle.

Die Terminal-Benachrichtigungen von Codex sind standardmäßig eingeschaltet. Vielleicht erhältst du sie also bereits. Sie werden nur ausgelöst, wenn das Terminal, also die App, in der Codex läuft, etwa Terminal oder iTerm2, nicht im Vordergrund ist. Wenn du die Ereignisse selbst auswählen möchtest, lege sie in deiner Konfigurationsdatei fest.

Füge den folgenden Abschnitt in ~/.codex/config.toml ein. Hat die Datei bereits einen Abschnitt [tui], füge die Schlüssel dort ein. Lege keine zweite Überschrift [tui] an. Die Terminal-Liste im Kommentar stammt aus dem Quellcode von Codex, nicht aus seiner Dokumentation (siehe unten).

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

Wenn notification_method auf auto steht, wählt Codex die Art des Signals: osc9 sendet einen speziellen Code (eine Escape-Sequenz), den manche Terminals in eine Desktop-Benachrichtigung umwandeln. bel löst die Terminal-Glocke aus. Setze notification_condition auf "always", wenn du auch Benachrichtigungen erhalten möchtest, während du im Terminal arbeitest.

Warum Terminal nur die Glocke auslöst.

OpenAIs Dokumentation nennt nicht, welche Terminals ein Banner anzeigen. Laut dem öffentlichen Quellcode von Codex, der sich ändern kann, geht die Banner-Sequenz an Ghostty, iTerm2, Kitty, Warp und WezTerm. Alle anderen Terminals erhalten nur ein Glockensignal, auch die mit macOS gelieferte App Terminal. Ein Glockensignal allein erzeugt kein Banner. In Terminal bietet Settings > Profiles > Advanced > Bell ein visuelles Signal, eine Markierung am Dock-Symbol und ein hüpfendes Dock-Symbol, solange das Fenster im Hintergrund ist. Für ein echtes Banner in Terminal nutze den weiter unten beschriebenen Hook.

In tmux kommt die Banner-Sequenz von Codex nur durch, wenn allow-passthrough eingeschaltet ist: mit on nur aus einem sichtbaren Bereich, mit all auch aus ausgeblendeten Bereichen (tmux-Handbuch). Füge diese Zeile in ~/.tmux.conf ein. Schreibe all statt on, wenn du auch Benachrichtigungen aus ausgeblendeten Bereichen erhalten möchtest:

set -g allow-passthrough on

notify führt ein Programm aus, wenn eine Runde abgeschlossen ist, und übergibt ihm die Details als einzelnes JSON-Argument. Das funktioniert in jedem Terminal gleich. OpenAIs Beispiel verwendet terminal-notifier, ein Homebrew-Tool eines Drittanbieters, das nicht zu macOS gehört. Das folgende Skript nutzt nur Bestandteile von macOS: Es zeigt den Anfang der letzten Antwort von Codex und den Projektordner an und spielt den Ton Glass ab.

Schritt 1. Speichere dies als neue Datei ~/.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" });
}

Schritt 2. Füge diese Zeile in deine vorhandene ~/.codex/config.toml ein, oberhalb der ersten Überschrift [section]. Ersetze YOUR_NAME durch den Namen deines Benutzerordners: Codex führt diese Liste genau so aus, wie sie geschrieben ist. Daher wird ~ nicht zum vollständigen Pfad aufgelöst (laut Codex-Quellcode, nicht laut Dokumentation).

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

Wenn kein Banner erscheint, öffne Systemeinstellungen > Mitteilungen. Laut Anthropics Hook-Anleitung werden mit osascript gesendete Banner dort unter Skripteditor geführt. Du musst sie dort erlauben; macOS fragt dich nicht vorher. Auf deinem Mac kann ein anderer Name angezeigt werden.

Hooks ermöglichen ein echtes Banner für Genehmigungsanfragen in jedem Terminal, auch in der App Terminal. Codex führt einen PermissionRequest-Hook direkt vor einer Genehmigungsanfrage aus und einen Stop-Hook, wenn eine Runde abgeschlossen ist. Bei Befehlen, die keine Genehmigung brauchen, wird PermissionRequest nicht ausgelöst.

Ergänze die folgenden Einträge in ~/.codex/hooks.json. Falls die Datei bereits existiert, ersetze sie nicht: Andere Tools speichern dort möglicherweise ihre Einträge (Cowork Island tut das, sobald du Codex darin einschaltest). Füge jeden der folgenden Einträge der passenden Liste innerhalb von "hooks" hinzu. Erstelle die Liste, falls sie fehlt, und belasse jeden Eintrag in seinen eigenen geschweiften Klammern.

{
  "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. Speichere die Datei, öffne Codex und gib /hooks ein.
2. Bestätige beide neuen Einträge als vertrauenswürdig. Codex überspringt neue oder geänderte Hooks, bis du ihnen vertraust. Ein noch nicht bestätigter Hook wirkt deshalb so, als wäre er defekt.
3. Behalte die Endung >/dev/null 2>&1 bei: Ein Stop-Hook muss JSON oder gar nichts ausgeben.

Wenn du stattdessen eine gesprochene Meldung oder eine Benachrichtigung auf dem Handy möchtest, erstellt der Generator für Benachrichtigungseinstellungen den Eintrag in deinem Browser und nennt die Datei, in die er gehört.

Seit dem 9. Juli 2026 ist die Codex-App Teil der ChatGPT-Desktop-App unter macOS. Ihre Benachrichtigungen stellst du in der App ein, nicht in Konfigurationsdateien:

• Settings > Notifications (Cmd+,): Zeige Benachrichtigungen zu abgeschlossenen Runden nie, nur wenn ChatGPT im Hintergrund ist, oder immer an. Für Benachrichtigungen zu Berechtigungen und Fragen gibt es separate Schalter.
• Sound: ein gemeinsamer Benachrichtigungston für abgeschlossene Aufgaben, Berechtigungsanfragen und Fragen. Wähle Default, Classic oder None. Unter macOS kannst du auch einen Systemton oder eine selbst importierte Datei verwenden.
• Activity: Wo diese Funktion verfügbar ist, zeigt die Glocke in der Seitenleiste oder Cmd+Option+U eine Liste der Chats, die ungelesen sind, gerade laufen oder auf dich warten.

Die oben genannten [tui]-Schlüssel gelten für Codex im Terminal. OpenAIs Dokumentation sagt nicht, ob notify oder deine eigenen Hooks für Chats in der Desktop-App ausgeführt werden. Verlasse dich dort also nicht darauf.

• OpenAI: Erweiterte Konfiguration
• OpenAI: Konfigurationsreferenz
• OpenAI: Beispielkonfiguration
• OpenAI: Hooks
• OpenAI: Benachrichtigungen
• OpenAI: Einstellungsreferenz
• OpenAI: Änderungsprotokoll
• Quellcode von openai/codex (nur für die Terminal-Liste)
• Apple: Erweiterte Einstellungen für Terminal-Profile
• Apple: Benachrichtigungen anzeigen
• tmux-Handbuch
• Anthropic: Anleitung zu Claude-Code-Hooks (Skripteditor)

Quellen geprüft am 18. Oktober 2026. Diese Anleitung stammt vom Entwickler von Cowork Island. Für Korrekturen schreib an support@coworkisland.com oder eröffne ein Issue auf GitHub.