---
title: "에이전트가 대기 중이거나 완료되었을 때 Kilobat에 알리기 · Kilobat 레시피"
url: "https://kilobat.app/ko/guides/recipes/connect-agent-hooks"
description: "Claude Code, Codex, Gemini CLI 또는 Cline 훅을 kilobat agent-event에 연결하면 Kilobat이 실행 중인지, 사용자를 기다리는지, 완료되었는지 알 수 있습니다."
---

레시피

# 에이전트가 대기하거나 완료했을 때 Kilobat에 알리기

훅이 없으면 Kilobat은 트래픽과 CPU 사용량으로만 에이전트를 확인합니다. 훅은 프로젝트와 실행이 입력을 기다리는 시점 또는 완료된 시점을 알려줍니다.

앱과 CLI에서 무료 · 확인일: 2026년 10월 29일

## 앱에서

1. 설정을 열고 잠자기 방지 및 에이전트를 찾으세요.
2. AI 에이전트가 작업하는 동안 Mac 잠자기 방지를 켜세요.
3. 팝오버의 세션 표시줄을 확인하세요. 각 에이전트 실행이 상태와 함께 칩으로 표시됩니다.

## CLI로 사용

1. Claude Code의 경우 `~/.claude/settings.json`에서 SessionStart, UserPromptSubmit, Notification, Stop, StopFailure, SessionEnd 아래에 명령 훅을 추가합니다.

   ```
   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. 훅을 수동으로 테스트합니다. `--verbose`이 발생한 일을 알려줍니다.

   ```
   kilobat agent-event start --agent claude --verbose
   ```
5. 기록된 실행을 확인합니다.

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

## MCP로 사용

`claude mcp add kilobat -- kilobat mcp`로 MCP 서버를 한 번 연결하세요. 다른 클라이언트는 [문서](https://kilobat.app/ko/docs/agents#agents)를 참고하세요. 그러면 에이전트가 이 도구를 호출할 수 있습니다. 설정을 변경하는 도구는 에이전트에게 먼저 확인하도록 안내합니다.

| 도구 및 인수 | 기능 |
|---|---|
| `list_sessions` `{"days": 1}` | `project`, `state`(working, waitingForYou, done, stalled, networkFailed 또는 failed) 및 사용된 데이터가 포함된 실행입니다. |

## 알아두면 좋은 정보

- `kilobat agent-event`은 아무것도 출력하지 않고 항상 0으로 종료하므로 에이전트의 동작을 방해하지 않습니다.
- 앱이 실행 중이 아니면 이벤트가 작은 파일에 대기하며, 앱이 열릴 때 이를 읽습니다.
- Kilobat은 세션 ID, 폴더 및 짧은 상태 텍스트를 읽습니다. 프롬프트나 답변은 읽지 않습니다.
- 이 훅을 기존 훅과 합칩니다.

## 출처

- [Kilobat 문서: 에이전트 연결](https://kilobat.app/ko/docs/agents#connect-agents)
- [Kilobat llms.txt: CLI 및 MCP 참조](https://kilobat.app/llms.txt)

2026년 10월 29일 확인했습니다.

## 관련 가이드

- [덮개를 닫은 상태에서 에이전트 계속 실행하기](https://kilobat.app/ko/guides/recipes/agent-lid-closed): 덮개를 닫으면 Mac 노트북이 잠자기 상태가 됩니다.
- [다운로드가 끝날 때까지 Mac 잠자기 방지](https://kilobat.app/ko/guides/recipes/keep-mac-awake-download): Kilobat은 전송이 진행되는 동안 Mac의 잠자기를 방지합니다.
- [에이전트의 대용량 다운로드 전에 네트워크 확인](https://kilobat.app/ko/guides/recipes/check-network-before-download): 에이전트는 지금이 대용량 전송에 적합한 시점인지 Kilobat에 물어볼 수 있습니다.