Claude Code 훅 설명: 훅이란 무엇이고 무엇을 만들 수 있을까

한 단락으로 보는 개념

에이전트에게 이렇게 지시합니다. 이런 일이 생기면 이 명령을 실행하라고요. 에이전트가 그 명령을 실행하고 이벤트에 대한 짧은 설명을 넘겨 줍니다. 명령은 그냥 기록만 할 수도 있고(예: 알림 보내기), 일부 이벤트에서는 에이전트가 사용할 답을 돌려보낼 수도 있습니다.

훅을 걸 수 있는 순간

정확한 이벤트 이름과 설정은 에이전트와 버전마다 다르므로, 직접 작성하기 전에 각 에이전트의 공식 문서를 확인하세요.

• 세션이 시작되거나 끝날 때, 또는 프롬프트를 보낼 때.
• 도구가 막 실행되려 하거나 방금 실행되었을 때.
• 에이전트가 무언가를 하려고 권한을 요청할 때.
• 에이전트가 턴을 끝낼 때(Stop 이벤트).

있는 곳

설정 파일에 있습니다. Claude Code는 ~/.claude/settings.json, Codex는 ~/.codex/hooks.json, Cursor는 ~/.cursor/hooks.json입니다. 이 파일들을 직접 편집해도 괜찮으며, Herdbell 같은 도구도 같은 방식으로 연결합니다.

Herdbell이 사용하는 방법

1. 연결할 때 Herdbell은 파일을 백업한 뒤, 필요한 이벤트에 대한 작은 명령을 추가합니다.
2. 대부분의 이벤트에서는 듣기만 하므로, 에이전트가 무엇을 하는지 보여 줄 수 있습니다.
3. 권한 요청의 경우 사용자의 답을 기다렸다가 전달하므로 허용과 거부가 실제로 적용됩니다. 턴 종료 시에는 에이전트를 열어 둘 수 있어 답장이 같은 채팅으로 돌아갑니다.
4. 제때 답하지 않으면 손을 떼고, 에이전트는 자체 프롬프트로 돌아갑니다. 연결을 해제하면 Herdbell의 훅만 제거됩니다.

자주 묻는 질문