# 클로드 코드의 훅은 “시키지 마”라는 의도로 설치된 것——실제로 작동하는 7가지와 3번의 구멍

> https://bookfactory.kr/c/ai-tech/11855
> 게시판: AI·머신러닝
> 작성자: admin
> 작성일: 2026-09-13T18:53:04.817Z

---

![見出し画像](https://assets.st-note.com/production/uploads/images/308435406/rectangle_large_type_2_afde3c5beade293d43182a7b42bf0ed2.png?width=1280)

클로이드 코드를 업무에 활용할 때, 가장 먼저 따르고 싶은 것은 “이것은 하지 마세요”라는 지시를 따르도록 하는 방법이 아닐까요?

저희는 매일 30명의 AI 직원들을 운영하고 있습니다. 지시 사항을 글로만 적어 놓으면, 처음에는 제대로 따르지 않았습니다.

지켜지게 된 것은 훅을 버린 뒤부터였습니다.

단지, 단순히 놓아두면 안심한다는 이야기가 아니라, 훅 자체가 오작동하여 작업을 멈춘 경우가 여러 번 있었습니다. 오늘은 그 두 가지 사항을 함께 기록하겠습니다.

먼저 말씀드리지만, 이 글은 좁은 범위의 이야기입니다. 하지만 클로이드 코드를 혼자 사용하는 것을 넘어, 무인으로 돌려놓기 시작한 사람들에게는 반드시 찾아옵니다.

## 클로이드 코드(Claude Code)의 훅(Hook)이 무엇을 하는 것인지?

먼저 한마디로 말씀드리겠습니다.

훅은 Claude Code가 어떤 일을 시작하거나 끝내는 바로 직전에 개입하여 중단시키거나 내용을 보완하는 기능입니다.

예를 들어 파일에 쓰려고 하는 순간, 예를 들어 작업을 마치려고 하는 순간과 같이, 정해진 상황에서 저희가 준비한 프로그램이 호출됩니다.

초대에 응답한 프로그램이 “실패”라고 응답하면 해당 작업은 실행되지 않습니다.

지시서와는 차이가 있습니다. 지시서는 요청 사항이지만, 훅은 통선보입니다. AI가 읽씹하거나 잊더라도 상관없이 효과가 있습니다.

저희가 지시서에서 훅(Hook)으로 옮겨간 것은 같은 주의사항을 세 번이나 지적했음에도 불구하고 세 번 모두 폐기되었기 때문이었습니다.

![画像](https://assets.st-note.com/img/1788147429-hGQFsvjWrml83VbiHq2g5NLM.png?width=1200)

## 지금 실제로 움직이는 7가지

저희가 매일 효과를 보는 것들을 그대로 말씀드리겠습니다. 어려운 것은 전혀 없습니다.

첫째, 결과물을 제작한 후에도 열어보지 않고 끝내려 멈추지 않는 점을 지적합니다. 불완전한 상태를 구조적으로 제거하도록 했습니다.

세 번째로, 그 날의 기록을 저장하지 않고 끝내려したら 멈추도록 합니다. 이것이 후반의 주역이 되므로, 지금은 이름만 지어둡니다.

세 번째는 기록용 파일을 완전히 다시 쓰려 하지 마십시오. 덧붙이려던 내용을 새롭게 작성하면 그 날의 기록이 삭제됩니다. 실제로 한 번 삭제한 적이 있습니다.

네 번째는 AI 직원에게 주어진 지시서를 완전히 대체하려는 시도를 막고, 여러 세션이 동시에 실행될 경우 이전 버전으로 대체될 때 롤백되는 것을 방지하는 것입니다. 롤백을 방지한 후에는 바로 이전 버전을 백업합니다.

5번째는 무거운 검색이나 사용하면 안 되는 경로를 사전에 차단하는 기능입니다. 6번째는 요청이 들어올 때마다 관련된 절차서를 자동으로 읽어들이는 기능입니다. 7번째는 외부로 전달되는 작업 전에 반드시 승인을 요청하는 기능입니다.

7개의 경우 중 5개가 ‘멈추는’ 측에 해당하며, 기록을 더하는 측보다 ‘멈추는’ 측이 압도적으로 효과적이었습니다.

### 제공된 순서대로 말하자면, 멈추는 쪽부터 만드는 것이 빠릅니다.

지금 들어오는 분들께는 먼저 순서를 말씀드립니다.

갑자기 편리한 것부터 만들지 않는 것이 좋습니다. 되돌릴 수 없는 것을 막는 고정핀부터 먼저 배치합니다. 삭제, 전송, 공개, 결제라는 4가지 작업에 관련된 조작이 이루어지는 위치에 각각 하나씩 놓으면 큰 사고는 거의 막을 수 있습니다.

편의를 제공하는 방식은 나중에서 괜찮다. 저희는 오히려 역으로 만들어서 한 번은 큰 고생을 했다.

## 똑같은 구멍을 세 번 밟는 이야기

이제 본론으로 들어가겠습니다.

두 번째로 언급한 “기록을 저장하지 않고 끝내려したら 멈춰라” 훅이, 저장된 기록이 있음에도 불구하고 미저장된 것으로 판단하여 작업을 중단했습니다.

게다가 1개월 동안 3번입니다.

문제의 원인은 매번 같았습니다. 이 훅은 저장 여부를 문자열 신호로 판단했습니다. 기록 파일의 이름과 쓰기 신호가 같은 명령 안에 함께 있을 경우 “저장했다”고 간주했습니다.

호시호 목록에는 자주 사용되는 표기 방식이 나열되어 있었다. 덧붙임 기호, 덧붙이 기구의 이름, 표기 명령의 철자가 여러 종류로 제시되어 있었다.

문제는 저장 방식이 하나 추가될 때마다 목록에서 누락되는 것이었습니다.

첫 번째는 여러 줄을 한 번에 전송하는 방법을 사용했을 때입니다. 두 번째는 일단 읽고 다시 전송하는 방법을 사용했을 때입니다. 세 번째는 글자가 한 글자만 다른 명령어를 사용했을 때입니다. 세 번째 경우에는 글자 직후의 기호가 예상과 다르고, 이에 따라 일치하지 않았습니다.

세 번 모두, 저는 제대로 보관하고 있었습니다. 훅만 발견되지 않았습니다.

### 가장 효과적이었던 것은 훅 자신에게 남아있던 과거 행적이었다.

세 번째로 조사하던 중, 잠시 손이 멈췄습니다.

그 훅 프로그램 안에 첫 번째 기록과 두 번째 기록이 주석으로 남아 있었습니다.

날짜와 그 때 누락된 부분을 정확한 방식으로까지 기록되어 있었습니다. 즉, 두 번 모두 수정한 사람은 제대로 기록을 남겼습니다. 그럼에도 불구하고 세 번째 일이 발생했습니다.

여기에서는 수정 방식에 변화가 생겼습니다. 추가 신호를 더하는 것은 4회를 먼저 미루는 것뿐입니다. 발을 밟을 때마다 목록이 계속 늘어나는 것 자체가 문제의 본질인 것이죠.

대응책으로 신호를 확장했습니다. 5가지 유형의 방법을 준비하여 모두 회귀 확인을 실측하고 통신하고 있습니다. 읽기만 하는 명령의 저장 및 오인 방지 특성이 그대로 유지되고 있음을 확인했습니다.

하지만 가장 큰 값어치는 ‘같은 곳에서 3바퀴 돌았다’고 세어질 수 있었던 점이었다고 생각합니다.

![画像](https://assets.st-note.com/img/1788147432-rP8NV0UA37Y5mohuEt4FSZwy.png?width=1200)

## 다시 수정하지 않기로 결정했다.

다음 날, 또 같은 훅이 오작동했습니다. 네 번째입니다.

이번에는 원인이 달랐습니다. 작성 누락이 아닌, 기록을 저장한 후 검증 명령을 실행한 탓에 “마지막 작업”이 “마지막 저장”보다 뒤에 나타났던 것입니다.

훅에서 보면, 보관한 후에 어떤 작업을 하고, 그대로 끝내려 하고 있다. 설계대로의 움직임이었다.

그래서 바로 수정하지 않았습니다.

대신 취한 조치는 절차의 측면을 변경하는 것이었습니다. 기록은 작업의 마지막에 진행합니다. 검증하고 싶다면 검증한 후 기록합니다.

훅을 바로해야 할지, 이 방법을 바로해야 할지 고민입니다. 이 선을 긋는 것은 매번 딜레마입니다. 우리가 지금 사용하고 있는 기준은 하나이고, 그 挙動에 이유가 있다면 절차를 바로하고, 이유를 설명할 수 없다면 시스템을 바꿔야 합니다.

이유를 설명할 수 없는 동작을 사양이라고 부르기 시작하면, 그 이후로는 아무도 그 문제에 대해 언급하지 않습니다.

## 클로이드 코드의 훅을 삽입할 때 고려해야 할 세 가지 사항

저희가 지금도 사용하는 정해진 문구를 그대로 적어놓겠습니다.

첫째, 방해하는 측에서 먼저 준비하고, 회복 불가능한 행동의 바로 앞에 한 번씩 배치한다. 편리한 측은 뒤로 미루어도 된다.

두 번째로, 오탐이 발생했을 경우, 수정하기 전에 “몇 번째인지”를 세어야 합니다. 훅의 프로그램 안에 날짜를 기록하여 이전 사항을 남겨두면 이것이 세어집니다. 처음 두 번까지는 합격을 더해줘도 괜찮습니다. 세 번째 경우에는 합하는 것을 그 자체로 의심해야 합니다.

세 번째, 회귀 확인을 실측한 후 닫는다. 쓰기는 다섯 개를 배열하고, 모두가 기대에 부합하는지 실제로 확인했다. 읽고 만족한 것만으로 닫으면 다시 같은 장소로 돌아온다.

저희는 세 번째를 빠진 채로 두 번이나 되돌아왔습니다.

![画像](https://assets.st-note.com/img/1788147435-0mh3AlbTixUNCBkLoqP8Rw2v.png?width=1200)

## 오늘 해야 할 한 발자국

한 가지 말씀드리겠습니다.

클루드 코드에 “이것은 하지 마라”라고 요청하고 있는 규칙이 현재 몇 개나 있습니까?

그 중 하나라도 손상되면 좋겠는 순서대로 가장 위에 있는 것을 선택해 주세요. 삭제, 전송, 공개하는 것들입니다. 관련 내용이 당연한 것입니다.

그 지시사항에서 제거하고, 후크로 옮겨보세요. 내용물은 “그 작동 방식이라면 멈출”이라는 몇 줄의 프로그램으로 충분합니다.

옮겨놓은 후, 의도적으로 찢어보고 멈추면 성공입니다.

저희도 첫 번째는 거기서 시작했어요. 하나만 움직여도 나머지는 같은 형태로 늘릴 수 있습니다.

오늘 있었던 이야기는 다음과 같습니다.

### 클로이드 코드를 업무에 적용할 때의 유형을 모아 설명하고 있습니다.

클루드 코드 스튜디오에서는 Claude Code를 실무에 적용하면서 실제로 발생했던 문제점과 그 날짜에 즉시 적용했던 대책들을 그대로 공개하고 있습니다. 지침 분할 방법, 승인 게이트 활용 방법, 숫자 관리 방법까지 모두 담았습니다.

👉 ClaudeCodeStudio 6大特典を受け取る

#클로드코드 #훅 #AI 에이전트 #운영 설계 #업무 자동화 #가드레일 #생성 AI #개발 효율화 #CLI #품질 관리 #AI 활용

**출처:** [note 원문](https://note.com/claudecodestudio/n/nfcf78ef692e3)

*번역: Gemma 3(.44) 초벌 + 교정 42청크*

[원문 보기](https://note.com/claudecodestudio/n/nfcf78ef692e3) | 출처: note.com