Claude Code hooks는 Claude Code 라이프사이클의 모든 주요 이벤트(도구 사용 전, 도구 사용 후, 프롬프트 제출 시, 에이전트 중지 시, 알림 전송 시)에서 결정론적 셸 명령을 실행할 수 있게 해줍니다. AgentsRoom은 수십 개의 Claude Code 에이전트와 수십 개의 프로젝트 전반에서 모든 훅 발화를 실시간으로 지켜볼 수 있는 비주얼 커맨드 센터입니다.
Hooks는 Claude Code에 결정론적 자동화, 가드레일, 감사 추적 및 사용자 정의 부수 효과를 추가하기 위한 Anthropic의 공식 방법입니다. AgentsRoom은 당신의 훅을 대체하지 않습니다. 진짜 Claude Code CLI를 실행하므로, .claude/settings.json에 구성한 모든 훅은 의도된 대로 계속 작동합니다. AgentsRoom이 추가하는 것은 가시성입니다: 에이전트별, 프로젝트별, 실행별로 모든 훅 트리거를 볼 수 있는 라이브 대시보드.
Claude Code hooks는 Claude Code가 에이전트 세션 중 특정 시점에 자동으로 실행하는 사용자 정의 셸 명령입니다. .claude/settings.json(공유, git에 커밋됨) 또는 .claude/settings.local.json(개인용, gitignored)에서 구성되며, Claude Code 에이전트의 동작에 대한 결정론적 제어를 제공합니다. 프롬프트가 확률적인 반면, 훅은 100% 결정론적입니다: 일치하는 이벤트가 발화할 때마다 예외 없이 실행됩니다.
Hooks는 가드레일, 자동화, 텔레메트리, 감사 로깅 및 사용자 정의 통합의 필요성에 대한 Anthropic의 답변입니다. Claude Code hooks를 사용하여 모든 편집 후 코드를 자동으로 포맷하고, 실행 전에 위험한 명령을 차단하고, 모든 도구 호출을 파일에 로깅하고, 에이전트가 입력을 기다릴 때 데스크톱 알림을 보내고, 세션이 끝날 때 CI 작업을 트리거하거나, 모든 프롬프트를 관측 가능성 백엔드로 스트리밍할 수 있습니다. 작성할 수 있는 모든 셸 명령을 Claude Code 훅에 연결할 수 있습니다.
Hooks는 프로젝트 자체에 있기 때문에(.claude/settings.json은 git에 커밋됨) 당신의 코드베이스와 함께 이동합니다. 팀의 모든 개발자와 해당 프로젝트에서 생성된 모든 AI 에이전트는 동일한 안전망을 상속합니다. AgentsRoom은 이 모델을 끝까지 존중합니다: 데스크톱 앱은 훅을 다시 작성하지 않고, 진짜 Claude Code CLI를 자식 프로세스로 실행하므로 터미널에서 claude code를 실행하는 것처럼 훅 구성이 자동으로 적용됩니다.
모든 Claude Code 에이전트 세션은 잘 정의된 지점에서 훅 이벤트를 발화합니다. 각 이벤트가 무엇을 의미하고 무엇을 할 수 있는지 설명합니다.
PreToolUse 훅은 Claude Code가 어떤 도구(Bash, Edit, Write, Read, Grep 등)를 실행하기 전에 발화합니다. 가드레일을 배치하기에 완벽한 장소입니다: 위험한 명령을 차단하고, 파괴적인 작업에 대한 확인을 요구하고, 프로젝트별 규칙을 시행하거나, 실행 전에 도구 인수를 재작성할 수 있습니다. 훅에서 0이 아닌 종료 코드를 반환하여 도구 호출 전체를 차단할 수 있습니다. PreToolUse는 안전을 중시하는 팀을 위한 최고의 Claude Code 훅입니다.
PostToolUse 훅은 어떤 Claude Code 도구가 완료된 직후에 발화합니다. 여기서 자동 사후 처리를 연결합니다: 모든 Edit 후 포매터(Prettier, Black, rustfmt)를 실행하고, 모든 Write 후 린터를 트리거하고, 파일이 수정될 때 changelog를 업데이트하거나, 텔레메트리 이벤트를 푸시합니다. PostToolUse는 Claude Code를 코드베이스를 발견했을 때보다 더 깨끗하게 유지하는 규율 있는 팀 멤버로 만드는 기본 훅입니다.
UserPromptSubmit 훅은 새 프롬프트가 Claude Code 에이전트에 전송될 때마다 발화합니다. 감사 및 규정 준수를 위해 모든 프롬프트를 로깅하고, 즉석에서 프롬프트를 다시 작성하고(컨텍스트 주입, 비밀 제거), 다른 모델로 요청을 라우팅하거나, 명명 규칙을 시행하는 데 사용하세요. AgentsRoom의 멀티 에이전트 대시보드와 결합하면 UserPromptSubmit는 모든 Claude Code 에이전트에 전송된 모든 지시의 완전한 감사 추적을 제공합니다.
Stop 훅은 Claude Code 에이전트 세션이 종료될 때(작업이 완료되었거나 취소되었기 때문에) 발화합니다. 정리 작업을 실행하고, 추적 시스템에 최종 요약을 푸시하고, 아티팩트를 커밋하거나, 세션이 끝났음을 인간에게 알리기에 적절한 장소입니다. AgentsRoom은 자체 알림 시스템으로 Stop 훅을 보완하므로 사용자 정의 훅과 AgentsRoom의 데스크톱 + 모바일 푸시 알림 모두에서 알림을 받을 수 있습니다.
Notification 훅은 Claude Code가 시스템 알림을 보낼 때(일반적으로 에이전트가 사용자 입력을 기다리거나 장시간 실행되는 작업을 완료했을 때) 발화합니다. Slack, Discord, Telegram, 이메일 또는 원하는 모든 웹훅으로 알림을 라우팅하는 데 사용하세요. AgentsRoom은 이미 Claude Code 알림을 멀티 에이전트 대시보드와 휴대폰 푸시 알림으로 기본적으로 표시하므로 Notification 훅은 그 위에 사용자 정의 통합을 추가하기에 완벽한 장소입니다.
SubagentStop 훅은 Claude Code 서브에이전트가 작업을 완료하고 부모에게 제어를 반환할 때 발화합니다. .claude/agents/*.md에 정의된 Claude Code 서브에이전트를 사용하여 전문 작업을 위임하는 경우, SubagentStop을 통해 각 서브에이전트가 수행한 작업을 로깅하고, 출력을 집계하거나, 후속 단계를 트리거할 수 있습니다. AgentsRoom 내에서 SubagentStop 이벤트는 라이브 에이전트 타임라인에 나타나므로 각 Claude Code 세션 내에서 어떤 서브에이전트가 실행되었는지 정확히 볼 수 있습니다.
Hooks는 Claude Code를 인상적인 AI에서 팀 전체가 의존할 수 있는 프로덕션 등급 코딩 에이전트로 변환합니다.
프롬프트는 확률적이며 우회될 수 있습니다. Claude Code hooks는 항상 실행되는 결정론적 셸 명령입니다. PreToolUse 훅은 에이전트가 추론을 어떻게 표현하든 관계없이 모든 rm -rf, 모든 push --force, 모든 파괴적인 마이그레이션을 차단할 수 있습니다. 이것이 안전 중요 Claude Code 배포를 위한 골드 스탠다드입니다.
Claude Code hooks를 포매터, 린터, 테스트 러너, 타입 체커 및 빌드 스크립트에 연결하세요. 에이전트가 수행하는 모든 편집은 CI 파이프라인이 실행하는 것과 동일한 검사를 트리거합니다 — 로컬에서, 즉시, 자동으로. 당신의 Claude Code 에이전트는 포매터 실행을 잊지 않는 자율적인 기여자가 됩니다.
모든 프롬프트, 모든 도구 호출, 모든 세션 시작 및 중지는 Claude Code hooks에 의해 로깅될 수 있습니다. 이를 AgentsRoom의 비주얼 타임라인과 결합하면 모든 AI 코딩 에이전트 작업의 완전한 감사 추적을 얻을 수 있습니다 — 규정 준수가 많은 팀, 보안 의식이 있는 회사 및 관측 가능한 AI 개발에 진지한 모든 사람에게 필수적입니다.
.claude/settings.json은 git에 커밋되기 때문에 단일 Claude Code hooks 세트가 팀의 모든 개발자와 프로젝트에서 생성된 모든 AI 에이전트에 대해 동일한 규약을 시행합니다. 새 팀 멤버는 저장소를 클론하는 순간 가드레일을 상속받습니다. 단일 풀 리퀘스트로 AI 코딩 팀 전체의 동작을 업그레이드하세요.
Claude Code hooks는 이벤트를 생성합니다. AgentsRoom은 이러한 이벤트를 비주얼 피드로 변환합니다: 모든 훅 트리거, 모든 도구 호출, 모든 상태 변경이 에이전트별 및 프로젝트별로 라이브 스트리밍됩니다. 더 이상 로그를 tail할 필요가 없습니다 — Claude Code 플릿이 실시간으로 작동하는 것을 지켜봅니다.
훅이 없으면 Claude Code 실행은 모든 도구 호출을 지켜보는 것을 의미합니다. 훅을 사용하면 관찰을 결정론적 코드에 위임하고 예외 수준에서 감독합니다. AgentsRoom은 이를 증폭합니다: 훅으로 보호되는 모든 Claude Code 에이전트를 한 번에 보고, 주의가 필요한 것이 발생할 때만 개입합니다.
AgentsRoom은 Claude Code 및 기타 AI 코딩 CLI를 위한 비주얼 커맨드 센터입니다. Claude Code를 포크하지 않고, 훅을 다시 구현하지 않으며, 도구 호출을 가로채지 않습니다. 완전한 xterm.js 터미널 내에서 진짜 Claude Code CLI를 자식 프로세스로 실행하므로 .claude/settings.json 또는 .claude/settings.local.json에 정의한 모든 훅은 Anthropic이 설계한 대로 정확하게 실행됩니다 — 타협 없이, 놀라움 없이, 보이지 않는 미들웨어 없이.
AgentsRoom이 추가하는 것은 규모와 가시성입니다. 수십 개의 Claude Code 에이전트를 병렬로 실행하고, 수십 개의 프로젝트 전반에서 각각 자체 훅 구성을 가지고 있으며, 하나의 대시보드에서 모든 훅 트리거를 볼 수 있습니다. AgentsRoom의 에이전트별 알림, 모바일 컴패니언 앱 및 실시간 상태 추적과 결합하면 Claude Code hooks는 AI 코딩 운영 전체를 위한 일급 관측 가능성 계층이 됩니다.
AgentsRoom은 완전한 xterm.js 터미널 내에서 진짜 claude CLI 프로세스를 생성합니다. .claude/settings.json, .claude/settings.local.json 또는 사용자 수준 설정에 구성된 모든 훅은 터미널에서 Claude Code를 실행하는 것처럼 자동으로 발화합니다. 패치 없음, 재작성 없음, 충실도 손실 없음.
훅이 활성화된 10개, 20개, 50개의 Claude Code 에이전트를 병렬로 실행합니다. AgentsRoom의 멀티 에이전트 대시보드는 모든 에이전트의 훅 트리거 알림과 상태 변경을 동시에 표시합니다. 당신의 PreToolUse 가드레일, PostToolUse 포매터 및 Stop 핸들러가 모두 플릿 규모로 작동합니다.
AgentsRoom의 모든 프로젝트는 자체 .claude/settings.json을 가지고 있으므로 자체 Claude Code 훅 구성을 가집니다. 사이드바는 프로젝트 전반의 라이브 상태를 집계하므로 어떤 훅이 어디서 발화하고 있는지, 어떤 에이전트가 사용자 입력에서 차단되어 있는지, 어떤 Stop 훅이 방금 실행을 완료했는지 한눈에 파악할 수 있습니다.
AgentsRoom은 기본 macOS 알림과 종단간 암호화된 모바일 푸시 알림과 함께 제공됩니다. Claude Code의 Notification 훅, Stop 훅 및 SubagentStop 훅은 모두 AgentsRoom이 데스크톱과 휴대폰에 직접 표시하는 신호를 생성합니다. 컴퓨터에서 멀어져도 훅이 돌아오라고 알릴 때를 알 수 있습니다.
AgentsRoom을 다운로드하고, .claude/settings.json 훅이 있는 프로젝트를 열고, Claude Code 에이전트를 생성하여 모든 훅 이벤트가 실시간으로 대시보드에 스트리밍되는 것을 지켜보세요.
컴패니언 앱: 이동 중에도 에이전트를 모니터링
Claude, Codex, OpenCode, Gemini CLI, Aider와 호환