본문으로 건너뛰기
ReviewRamble

주간 브리프

AI 리뷰를 받은편지함으로.

  • 도구, 모델, MCP 서버, 저장소의 새 리뷰(결론부터)
  • 변경이 있을 때 다시 확인한 가격과 평점
  • 새로 발행된 분석 글

모델, 에이전트, MCP 서버, 그리고 정말 시간을 들일 만한 도구.

일주일에 한 통입니다. 각 브리프의 링크로 구독을 해지할 수 있습니다. 이메일 사용 방식

에이전트 훅

에이전트 훅(agent hooks)은 코딩 에이전트가 도구 호출 전이나 파일 수정 후처럼 작업 중 정해진 시점에 자동으로 실행하는, 사용자가 정의한 명령이나 스크립트입니다. 에이전트의 동작을 점검하거나, 막거나, 확장하는 데 씁니다.

다른 이름: hooks

작성 Divya Sharma · 2026년 11월 15일 확인 · 리뷰 방식

프롬프트나 지침 파일에 적은 지시는 모델이 대개 따르는 제안입니다. 훅은 모델이 어떻게 판단하든 매번 실행되는 코드입니다. 그래서 반드시 지켜야 하는 규칙, 그리고 모델이 기억해 주기를 기대하고 싶지 않은 잡무를 두는 자리가 됩니다.

작동 방식

에이전트 설정에서 특정 이벤트에 훅을 등록합니다. Claude Code의 이벤트에는 세션 시작, 사용자가 프롬프트를 보내는 순간, 도구 실행 직전(PreToolUse), 실행 직후(PostToolUse), 에이전트가 멈출 때가 있습니다. 에이전트는 도구 이름과 입력 같은 이벤트 정보를 스크립트에 넘깁니다. 스크립트는 동작을 그대로 진행시키거나, 모델이 볼 수 있는 이유와 함께 막거나, 컨텍스트를 추가할 수 있습니다.

흔한 용도

파일을 수정할 때마다 포매터나 린터를 실행합니다. 파일을 지우거나 비밀 정보에 접근하는 셸 명령을 막습니다. 보호된 경로의 수정을 거부합니다. 에이전트가 입력을 기다릴 때 데스크톱 알림을 보냅니다. 감사를 위해 모든 도구 호출을 기록합니다.

훅과 권한

에이전트 권한은 도구에 대한 허용 목록과 거부 목록입니다. 훅은 프로그래밍할 수 있으므로 인자를 살펴보고 목록으로는 표현할 수 없는 규칙을 적용할 수 있습니다. 둘 다 에이전트 하네스의 일부입니다.

한계

훅은 사용자의 전체 권한으로 실행되므로, 부주의하거나 악의적인 훅 스크립트 자체가 위험이 됩니다. 공유 저장소의 훅은 활성화하기 전에 검토해야 합니다. 명령에 대한 패턴 매칭은 우회될 수 있으므로, 훅을 유일한 방어선이 아니라 에이전트 샌드박스와 함께 쓰는 한 계층으로 다뤄야 합니다.

관련 용어

코딩 에이전트
코딩 에이전트(coding agent)는 소프트웨어를 직접 다루는 AI 에이전트입니다. 사람이 붙여 넣을 코드를 제안하는 데 그치지 않고, 코드베이스를 읽고, 파일을 수정하고, 명령과 테스트를 실행하며, 변경이 동작할 때까지 반복합니다.
에이전트 하네스
에이전트 하네스(agent harness)는 모델을 실제로 동작하는 에이전트로 만드는 주변 소프트웨어입니다. 루프, 도구, 시스템 프롬프트, 권한, 컨텍스트 관리, 그리고 세션 사이에 진행 상황을 이어 주는 파일이 여기에 포함됩니다.
에이전트 권한
에이전트 권한(agent permissions)은 AI 에이전트가 어떤 도구, 파일, 명령, 네트워크, 계정을 쓸 수 있는지, 어떤 동작에 먼저 사람의 승인이 필요한지를 정하는 규칙입니다. 에이전트가 실수하거나 조작당해도 피해를 제한하기 위한 것입니다.
에이전트 지침 파일(AGENTS.md)
에이전트 지침 파일(agent instructions file)은 AGENTS.md나 CLAUDE.md처럼 코드 저장소 안에 두는 Markdown 파일로, 코딩 에이전트가 세션을 시작할 때 읽어 프로젝트의 명령, 관례, 규칙을 익힙니다.
에이전트 샌드박스
에이전트 샌드박스(agent sandbox)는 AI 에이전트가 코드와 명령을 실행하는 격리된 환경입니다. 컨테이너, 가상 머신, 운영체제 제한 등이 있으며, 정해진 한계 밖의 파일, 네트워크, 데이터에 닿지 못하게 합니다.

출처