클로드 코드 hook이 같은 작업을 계속 반복하면 원인보다 실행 중단과 hook 비활성화를 먼저 해야 합니다. 반복을 끊는 순서, 반복 구조를 찾는 법, 다시 켜기 전 안전장치를 정리했습니다.
반복이 보이면 원인을 찾기 전에 실행부터 끊어야 합니다. 그다음 hook을 잠시 꺼둔 상태에서 다시 여는 것이 안전합니다.
원인은 hook을 끈 뒤에 천천히 봐도 늦지 않습니다. 반복이 돌아가는 동안에는 토큰이 계속 쓰이니까요.
💡 이 글에는 공식 문서에서 확인한 단축키나 설정 파일 경로를 적지 않았습니다. 정확한 값은 버전에 따라 달라질 수 있으니 Anthropic의 Claude Code 공식 문서 중 hooks 항목과 단축키 항목에서 확인하세요.
반복이 보이면 지금 바로 할 일
멈추는 것이 먼저입니다. 순서는 이렇습니다.
- ☐Claude Code 화면에서 진행 중인 응답을 중단하는 키를 누른다 (공식 문서 단축키 표에서 확인)
- ☐그래도 계속 돌아가면 Claude Code가 실행 중인 터미널 창이나 탭을 닫는다
- ☐다시 열기 전에 hook부터 꺼둔다 (다음 섹션)
터미널은 검은 화면에 명령어를 입력하는 프로그램이고, Claude Code는 이 안에서 실행됩니다.
터미널 창을 닫으면 그 창에서 돌던 프로그램도 함께 종료될 수 있습니다. 단축키가 먹히지 않거나 어떤 키인지 모를 때 쓰는 마지막 수단입니다.
여기서 꼭 구분할 점이 있습니다. 중단은 되돌리기가 아닙니다.
멈춘 시점 이전에 이미 수정된 파일이나 실행된 명령은 그대로 남습니다. 중단 명령이 막는 건 앞으로의 진행뿐입니다.
hook을 켜둔 채로 Claude Code를 다시 열면 같은 반복이 또 시작될 수 있습니다. 세 번째 항목을 건너뛰면 안 되는 이유입니다.
hook을 잠시 꺼두는 방법
hook은 "특정 시점이 되면 자동으로 실행할 명령"을 미리 적어둔 규칙입니다. "파일을 고친 뒤마다 이 정리 도구를 실행해라" 같은 식이죠.
이 규칙은 설정 파일에 적혀 있습니다. 설정 파일은 JSON 형식(중괄호와 따옴표로 항목을 적는 텍스트 형식)입니다.
끄기 전에 백업부터
설정 파일을 직접 고치기 전에 복사본을 만들어 둡니다.
- 원본 파일을 같은 폴더에 복사한다
- 복사본 이름에 표시를 붙인다 (예: 파일명 뒤에
-backup) - 원본에서 hook 관련 항목만 지우거나 비활성화한다
복사본이 있으면 나중에 원래 설정으로 되돌리기 쉬워집니다.
설정 파일이 하나가 아닐 수 있습니다
hook 설정은 적용 범위에 따라 여러 위치에 있을 수 있습니다. 한 곳만 지웠는데 반복이 계속된다면 다른 위치에 같은 hook이 남아 있는지 확인해 보세요.
정확한 파일 위치와 우선순위는 공식 문서의 설정 항목에 나옵니다. 짐작으로 찾기보다 문서를 옆에 띄워두고 하나씩 대조하는 편이 빠릅니다.
등록된 hook 목록을 Claude Code 안에서 보거나 관리하는 메뉴가 있는지도 공식 문서에서 확인해 보세요. 파일을 직접 열지 않아도 될 수 있습니다.
토큰이 얼마나 쓰였는지 확인
반복을 멈췄다면 계정의 사용량 화면에서 지금까지 쓴 양을 확인해 둡니다. 확인하는 위치는 요금제나 결제 방식에 따라 다르니 Anthropic 계정 화면을 기준으로 보면 됩니다.
반복을 만드는 구조 찾기
hook 반복은 "hook이 한 일이 다시 같은 hook을 부르는" 고리에서 생길 수 있습니다.
작업 실행 ↓ hook 실행 ↓ hook이 새 작업을 만듦 ↓ 다시 hook 실행 (반복)
눈여겨볼 곳은 세 번째 줄입니다. hook이 끝나면서 무언가를 새로 만들어내면, 그게 다시 hook을 부를 조건이 됩니다.
증상을 보면 의심할 지점을 좁힐 수 있습니다. 다만 증상만으로 원인이 확정되지는 않으니, 아래 표는 "먼저 열어볼 곳" 정도로 보세요.
| 보이는 증상 | 먼저 확인할 것 |
|---|---|
| 같은 파일이 계속 고쳐짐 | 파일 수정 뒤 실행되는 hook이 그 파일을 또 고치는지 |
| 끝날 듯하다가 계속 이어짐 | 작업이 끝나는 시점의 hook이 "계속하라"는 신호를 돌려주는지 |
| 새 Claude Code 작업이 생김 | hook 명령 안에서 Claude Code를 다시 실행하는지 |
블로그 글 파일을 저장할 때마다 맞춤법을 자동으로 고치는 hook을 만들었다고 해봅시다 (가상 예시입니다).
hook이 파일을 고치는 순간 "파일이 수정됐다"는 조건이 다시 충족될 수 있습니다. 고칠 게 없을 때 아무것도 하지 않도록 만들어 두지 않았다면 고리가 생길 수 있습니다.
하나씩 다시 켜서 범인 찾기
hook이 여러 개라면 모두 끈 상태에서 하나씩 켜 봅니다.
- ☐hook 하나만 다시 켠다
- ☐작은 작업 하나를 시킨다
- ☐같은 동작이 두 번 이상 반복되는지 지켜본다
- ☐반복이 보이면 즉시 중단하고 그 hook을 다시 끈다
반복이 없으면 다음 hook으로 넘어갑니다. 시간은 걸리지만 의심 범위를 하나씩 좁혀갈 수 있는 방법입니다.
반복이 사라졌다고 해서 그 hook이 안전하다고 단정하기는 이릅니다. 특정 파일이나 특정 작업에서만 고리가 생기기도 하니, 실제로 쓰던 작업과 비슷한 조건에서 한 번 더 확인하는 편이 좋습니다.
다시 켜기 전에 넣어둘 안전장치
범인 hook을 찾았다면 고치는 방향은 하나입니다. 스스로 멈출 조건을 넣는 것입니다.
| 안전장치 | 하는 일 |
|---|---|
| 종료 조건 | 이미 처리된 상태면 아무것도 하지 않고 끝냄 |
| 실행 대상 좁히기 | 모든 작업이 아니라 필요한 경우에만 실행 |
| 자기 호출 금지 | hook 안에서 Claude Code를 다시 부르지 않음 |
hook 스크립트를 직접 고치기 어렵다면 Claude Code에게 맡겨도 됩니다. 단, 해당 hook은 꺼둔 상태에서 요청해야 합니다.
요청은 이렇게 써볼 수 있습니다 (가상 예시입니다).
이 hook이 반복 실행되는 것 같아. 고칠 내용이 없으면 아무것도 하지 않고 끝나도록 종료 조건을 넣어줘. 수정 전후를 비교해서 보여줘.
hook이 할 일이 없을 때 조용히 끝나도록 만들어 달라는 요청입니다. 수정된 내용은 직접 읽어보고 적용할지 정하세요.
테스트는 작은 폴더에서
고친 hook은 중요한 작업 폴더가 아니라 테스트용 빈 폴더에서 먼저 돌려봅니다. 반복이 다시 생겨도 피해가 작습니다.
git(파일 변경 이력을 저장해두는 도구)을 쓰는 폴더라면 테스트 전 상태를 저장해 두세요. hook이 파일을 엉뚱하게 바꿔도 이전 상태로 돌아갈 수 있습니다.
그래도 꼬였다면
- hook 설정은 처음에 만든 백업 파일로 되돌린다
- 반복 중에 바뀐 파일은 git 이력이나 별도 백업에서 복원한다
- 원인 hook은 꺼둔 채로 두고 공식 문서의 hook 동작 설명과 내 설정을 대조한다
순서는 멈추기 → 끄기 → 하나씩 켜서 찾기 → 종료 조건 넣기입니다. 이 순서를 따르면 원인을 찾는 동안 불필요한 토큰 사용을 줄이는 데 도움이 됩니다.
함께 보면 좋은 글
'AI & LLM > Claude & Anthropic' 카테고리의 다른 글
| 클로드 코드 토큰 사용량 확인: 결제 방식부터 구분하는 순서 (1) | 2026.10.21 |
|---|---|
| Claude PDF 업로드 한도 걸렸을 때 나눠 올리는 순서 (0) | 2026.10.16 |
| claude update 안됨, 버전이 그대로일 때 확인할 곳 (0) | 2026.10.07 |
| 클로드 무료 사기 의심될 때 구글 계정 점검 순서 (1) | 2026.10.07 |
| CLAUDE.md 수정이 반영 안 될 때 확인할 4가지 (1) | 2026.10.04 |