產生 Claude Code、Codex 與 Gemini CLI 的通知設定。

使用鈴聲的 Codex 內建通知。

選用：Codex 內建的 Mac 通知。

放在 ~/.codex/config.toml 中

如果檔案中已有 [tui] 區段，請勿再次加入 [tui] 這一行。在現有區段下，更新已存在的相關鍵值，只加入缺少的項目。重複的 [tui] 區段標頭，或同一個鍵出現兩次，都會讓 Codex 無法讀取檔案。

鈴聲會產生什麼效果，取決於你的終端機。在 Terminal 中，開啟 Settings > Profiles > Advanced > Bell，即可選擇音效、標記或彈跳的 Dock 圖示。

你所選通知方式的鉤子。

放在 ~/.claude/settings.json 中

將這些項目加入檔案的 "hooks" 物件中，與現有項目並列。請勿取代整個檔案，因為裡面可能還有你的其他設定與其他工具的鉤子。設定檔必須遵守嚴格的 JSON 格式，不能有註解或尾端逗號。更簡單的方式是將目前的檔案內容貼到下方合併欄位。

將這些項目新增到檔案中。Cowork Island 與其他工具也可能寫入同一個檔案，因此請勿覆寫；下方合併欄位可以幫你完成合併。接著開啟 Codex，輸入 /hooks，並將每個新項目設為信任。在你完成這一步之前，Codex 會略過新增或變更過的鉤子。

將這些項目加入檔案的 "hooks" 物件中，與現有項目並列，或使用下方合併欄位。Gemini CLI 鉤子只允許輸出 JSON，因此每個指令最後都會輸出 {}。

將這項設定加入檔案中，與現有設定並列，或使用下方合併欄位。

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "/usr/bin/osascript -e 'on run argv' -e 'display notification (item 1 of argv) with title (item 2 of argv) subtitle (item 3 of argv) sound name \"Glass\"' -e 'end run' 'Claude Code finished' 'Claude Code' \"${PWD##*/}\""
          }
        ]
      }
    ],
    "Notification": [
      {
        "matcher": "permission_prompt|elicitation_dialog|elicitation_url_dialog",
        "hooks": [
          {
            "type": "command",
            "command": "/usr/bin/osascript -e 'on run argv' -e 'display notification (item 1 of argv) with title (item 2 of argv) subtitle (item 3 of argv) sound name \"Funk\"' -e 'end run' 'Claude Code needs you' 'Claude Code' \"${PWD##*/}\""
          }
        ]
      }
    ]
  }
}

• 在 Claude Code 中，權限通知與已連接工具的輸入請求，會在提示出現約 6 秒後送達；輸入文字會延後通知。這是 Claude Code 的 Notification 鉤子的運作方式。其他問題不一定會觸發這個鉤子。
• 完成通知使用 Stop，每次 Claude 完成回覆時都會觸發，不只是在長任務結束時。當你中斷 Claude 時，它不會觸發。
• 在你接受工作區信任對話框之前，Claude Code 不會執行該資料夾中的鉤子。如果使用公司的 Mac，你的組織可能只允許使用自己的鉤子。
• 如果已開啟的工作階段沒有套用變更，請重新啟動該工作階段。

你的隨機命名 ntfy 主題。

ntfy.sh 上的主題是公開的。任何知道或猜到主題名稱的人，都能讀取傳送到該主題的內容，因此請像保護密碼一樣保護它。這就是主題名稱使用瀏覽器產生的 32 個隨機字元的原因。鉤子也只會傳送「Claude Code 已完成」之類的固定文字，絕不傳送代理的回覆或檔案內容。

在手機上安裝 ntfy App，並訂閱這個主題。ntfy.sh 是免費的第三方服務，有自己的每日訊息數量限制。

測試通知。

將這一行貼到 Terminal，然後按 Return。它會執行與鉤子相同的指令。

/usr/bin/osascript -e 'on run argv' -e 'display notification (item 1 of argv) with title (item 2 of argv) subtitle (item 3 of argv) sound name "Glass"' -e 'end run' 'Claude Code finished' 'Claude Code' "${PWD##*/}"

測試鈴聲。

將這一行貼到 Terminal，然後按 Return：

printf '\a'