---
title: "讓 Kilobat 知道代理程式何時在等你、何時完成 · Kilobat 實用技巧"
url: "https://kilobat.app/zh-hant/guides/recipes/connect-agent-hooks.html"
description: "把 Claude Code、Codex、Gemini CLI 或 Cline 的 hook 接到 kilobat agent-event，讓 Kilobat 知道每次執行何時在工作、何時在等你、何時已完成。"
---

實用技巧

# AI 代理程式等待或完成時通知 Kilobat

沒有 hook 時，Kilobat 只能從流量和 CPU 看出代理程式在做事。hook 會告訴它是哪個專案，以及執行何時在等你、何時已完成。

App 和 CLI 中免費 · 檢查日期：2026年10月29日

## 在 App 中

1. 打開「設定」，找到「喚醒與代理程式」。
2. 開啟「AI 代理程式工作時保持 Mac 喚醒」。
3. 看看彈出式視窗裡的工作階段列。每次代理程式執行都會顯示成一個標籤，附上它的狀態。

## 使用 CLI

1. Claude Code：在 `~/.claude/settings.json` 的 SessionStart、UserPromptSubmit、Notification、Stop、StopFailure 和 SessionEnd 下加入 command hook。

   ```
   kilobat agent-event --agent claude --stdin-json
   ```
2. Codex：在 `~/.codex/config.toml` 加入這一行。它只會回報完成。

   ```
   notify = ["kilobat", "agent-event", "done", "--agent", "codex", "--json-arg"]
   ```
3. Cline：安裝 Kilobat 外掛。

   ```
   cline plugin install https://kilobat.app/agents/cline/kilobat.ts
   ```
4. 手動測試 hook。`--verbose` 會說明發生了什麼。

   ```
   kilobat agent-event start --agent claude --verbose
   ```
5. 查看記錄下來的執行。

   ```
   kilobat sessions --days 1
   ```

## 透過 MCP

用 `claude mcp add kilobat -- kilobat mcp` 連接 MCP 伺服器一次即可。其他用戶端請參閱[說明文件](https://kilobat.app/zh-hant/docs.html#agents)。之後 AI 代理程式就能呼叫這些工具。會更改設定的工具會告訴 AI 代理程式先詢問你。

| 工具與參數 | 作用 |
|---|---|
| `list_sessions` `{"days": 1}` | 各次執行的 `project`、`state`（working、waitingForYou、done、stalled、networkFailed 或 failed）和用量。 |

## 注意事項

- `kilobat agent-event` 不會輸出任何內容，而且一律以 0 結束，所以不會弄壞代理程式。
- 如果 App 沒有在執行，事件會先存在一個小檔案裡，App 打開時再讀取。
- Kilobat 只讀取工作階段 ID、資料夾和簡短的狀態文字，絕不讀取提示詞或回覆。
- 把這些 hook 和你現有的 hook 合併。

## 資料來源

- [Kilobat 說明文件：連接代理程式](https://kilobat.app/zh-hant/docs.html#connect-agents)
- [Kilobat llms.txt：CLI 與 MCP 參考資料](https://kilobat.app/llms.txt)

資料來源檢查日期：2026年10月29日。man 頁面為 macOS 內建版本；在終端機中用 `man <name>` 開啟。

## 相關指南

- [闔上螢幕時讓 AI 代理程式繼續執行](https://kilobat.app/zh-hant/guides/recipes/agent-lid-closed.html): 闔上螢幕會讓 Mac 筆電進入睡眠。
- [讓 Mac 保持喚醒直到下載完成](https://kilobat.app/zh-hant/guides/recipes/keep-mac-awake-download.html): 傳輸進行時，Kilobat 會讓 Mac 保持喚醒。
- [在 AI 代理程式執行大型下載前檢查網路](https://kilobat.app/zh-hant/guides/recipes/check-network-before-download.html): AI 代理程式可以詢問 Kilobat，現在是否適合進行大型傳輸。