Claude에게 '주의하라'고 말하는 것을 멈추세요 — 프롬프트가 해결할 수 없는 문제를 해결하는 3가지 Hook 도구

Throughline, Caveat, 그리고 Spotter는 Claude Code hooks를 사용하여 컨텍스트 비대화 (context bloat), 과거 트랩 메모리 (past-trap memory), 그리고 누락된 도구 호출 (missed tool calls) 문제를 해결하는 세 가지 npm 도구입니다. 이는 CLAUDE.md 지침으로는 해결할 수 없는 문제들입니다.

Claude에게 '주의하라'고 말하는 것을 멈추세요 — 프롬프트가 해결할 수 없는 문제를 해결하는 3가지 Hook 도구

만약 여러분이 CLAUDE.md에 "파일을 추측하지 말고, 답변하기 전에 항상 읽으세요"라고 작성해 왔다면, 한계에 부딪힌 것입니다. 새로운 npm 도구인 Throughline, Caveat, Spotter의 개발자도 똑같은 사실을 깨달았습니다. Claude에게 '주의하라'고 말함으로써 해결할 수 있는 모든 문제는 이미 해결되었습니다. 남은 것들은 구조적으로 해결할 수 없는 문제들이었습니다.

무엇이 변했는가 — Hook의 깨달음

Claude Code에는 프롬프트를 보내기 전, 도구 (tool)가 실행된 후, 또는 세션이 종료될 때 실행되는 hook 메커니즘이 있습니다. 핵심적인 통찰은 다음과 같습니다: Claude 스스로가 문제를 인지하지 못하더라도, 외부에서 상태를 관찰하고 필요한 처리를 주입할 수 있습니다.

이것은 CLAUDE.md에서 분담할 수 있는 작업의 성격을 바꿉니다. Claude가 대충 훑어보고 지나칠 경고문들로 지침을 비대하게 만드는 대신, hooks를 통해 동작을 자동으로 강제할 수 있습니다.

오늘 바로 설치할 수 있는 세 가지 도구

Throughline (뺄셈 — 컨텍스트 비대화 (Context Bloat))

문제: Claude는 자신의 컨텍스트가 비대해졌을 때 이를 인지할 수 없습니다. 컨텍스트 크기는 요청이 전송되는 순간 결정되므로, 스스로의 크기를 볼 수 없습니다.

해결책: Throughline은 도구의 입력과 출력을 SQLite로 오프로드(offload)하고 컨텍스트에서 제거합니다. AI가 파일 읽기 (file read), grep 결과, 또는 bash 출력을 사용하여 결정을 내리고 나면, 그 목적은 달성된 것입니다. 하지만 이는 끝날 때까지 남아 토큰을 소비합니다. Throughline은 이를 제거하고 Claude가 필요할 때 요청하여 가져올 수 있도록 합니다.

설치: npx throughline — Claude Code에 자동으로 hook을 연결합니다.

Caveat (누적 — 과거의 함정)

문제: Claude는 이전 세션에서 마주쳤던 함정들을 기억하지 못합니다. CLAUDE.md에 내용을 추가하면 파일이 무거워지고, 모델이 내용을 대충 훑어보게 됩니다.

해결책: 함정에 빠졌을 때, 이를 Markdown 형식으로 작성하세요. Caveat은 유사한 상황이 발생할 때 해당 노트를 자동으로 표면화합니다. 즉, 유사한 프롬프트(Prompt)를 보내거나, 유사한 도구 오류(Tool error)를 받거나, 세션 종료 시점에 "고전하는 신호(struggle signal)"가 관찰될 때 작동합니다. 관련 있는 과거의 노트들이 hook을 통해 주입됩니다.

설치: npx caveat — 기존의 Markdown 노트와 함께 작동합니다.

Spotter (추가 — 누락된 도구 호출)

문제: Claude는 도구 호출을 잊었을 때 이를 인지하지 못합니다. 자신이 무엇을 모르는지조차 알지 못합니다.

해결책: 도구 카탈로그(Tool catalog)를 완벽하게 파악하고 있는 또 다른 Claude (Haiku 4.5)를 나란히 실행하세요. 이 모델은 사용자의 입력과 최종 응답을 감시합니다. 만약 "web_search를 사용하여 이 질문에 답할 수 있었습니다"라는 점을 감지하면, hook을 통해 메인 Claude에게 포인터를 보냅니다.

설치: npx spotter — 감사(Auditor) 역할을 수행할 별도의 Claude를 위한 API 키가 필요합니다.

공통 패턴: Claude에게 아무것도 기대하지 마세요

세 가지 도구 모두 Claude 자체에는 아무것도 기대하지 않는 설계를 공유합니다:

문제	Claude에게 요구하지 않는 것	대신 수행하는 주체
컨텍스트 비대화 (Context bloat)	컨텍스트 관리 (Context management)	Hook + SQLite
...	...	...

"Claude에게 필요한 변경 사항"은 0입니다. 당신은 평소처럼 프롬프트와 CLAUDE.md를 작성하면 됩니다. 더 많은 "주의하라"는 경고를 추가할 필요가 없습니다.

이것이 당신에게 의미하는 바

만약 더 많은 지침을 추가함으로써 Claude Code와 싸워왔다면, 당신은 잘못된 싸움을 하고 있는 것입니다. 컨텍스트 비대화, 세션 간 메모리(Cross-session memory), 도구 선택 정확도와 같이 남아있는 문제들은 구조적인 문제입니다. Claude는 자신의 한계를 스스로 인식할 수 없기 때문에, Claude 스스로는 이 문제들을 해결할 수 없습니다.

Claude에게 주의하라고 말하는 것을 멈추세요. 외부에서 강화하기 시작하세요.

지금 바로 시도해보세요

1. 매일 발생하는 문제 하나를 선택하세요: 컨텍스트 비대화 (context bloat), 반복되는 함정, 또는 도구 호출 (tool calls) 누락 중 하나를 고르세요.
2. 해당하는 도구를 설치하세요: npx throughline, npx caveat, 또는 npx spotter를 설치합니다.
3. CLAUDE.md에서 해당 지침들을 제거하세요. 더 이상 그것들이 필요하지 않습니다.
4. 차이점을 관찰하세요. 도구가 매번 자동으로 이를 처리합니다.

세 가지 도구 모두 MIT 라이선스 하에 npm에 공개되어 있습니다. GitHub 저장소: Throughline, Caveat, Spotter.

여전히 남아있는 과제

저자는 아직 강화되지 않은 세 가지 구조적 문제를 식별했습니다:

• 장기적인 역할 이탈 (Long-term role drift): Claude는 세션 내에서 20턴이 지나면 역할 수행이 느슨해집니다.
• 서브 에이전트 (sub-agents)를 통한 컨텍스트 손실: 작업 도구 서브 에이전트들이 부모의 암시적 컨텍스트 (implicit parent context)를 상속받지 못합니다.
• 도구 선택 정확도 (Tool selection accuracy): Spotter는 호출 누락은 감지하지만, 잘못된 도구 선택은 감지하지 못합니다.

직접 Hook 도구를 구축하고 싶다면, 이 문제들이 여러분의 다음 목표가 될 것입니다.

출처: dev.to

원문은 gentic.news에 게시되었습니다.