---
title: "让 Kilobat 知道智能体何时在等待或已完成 · Kilobat 实用技巧"
url: "https://kilobat.app/zh-hans/guides/recipes/connect-agent-hooks.html"
description: "把 Claude Code、Codex、Gemini CLI 或 Cline 的 hook 连接到 kilobat agent-event，让 Kilobat 知道一次运行何时在工作、何时等待你操作、何时已完成。"
---

实用技巧

# 智能体等待或完成时通知 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-hans/docs.html#agents)。之后智能体就可以调用这些工具。会更改设置的工具会提示智能体先征求你的同意。

| 工具与参数 | 作用 |
|---|---|
| `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-hans/docs.html#connect-agents)
- [Kilobat llms.txt：CLI 和 MCP 参考](https://kilobat.app/llms.txt)

参考资料核查于 2026年10月29日。man 手册页为 macOS 自带版本；在“终端”中用 `man <name>` 打开。

## 相关指南

- [合盖时让智能体继续运行](https://kilobat.app/zh-hans/guides/recipes/agent-lid-closed.html): 合上机盖会让 Mac 笔记本电脑进入睡眠。
- [让 Mac 保持唤醒，直到下载完成](https://kilobat.app/zh-hans/guides/recipes/keep-mac-awake-download.html): 传输进行期间，Kilobat 会让 Mac 保持唤醒。
- [智能体下载大文件前先检查网络](https://kilobat.app/zh-hans/guides/recipes/check-network-before-download.html): 智能体可以询问 Kilobat 现在是否适合进行大量传输。