클룩스: 클로드 코드를 위한 지속적 훅 런타임

성능 문제와 해결책

Claude Code 파이프라인이 더욱 견고해짐에 따라, 훅 수는 2-3개의 가벼운 검사에서 SessionStart, PreToolUse, PostToolUse, Stop 이벤트에 걸쳐 50개 이상의 핸들러로 증가할 수 있습니다. 각 훅은 일반적으로 새로운 Node 또는 Python 프로세스를 생성하여, 순수한 생성 오버헤드로 인한 지연 시간이 세션당 누적됩니다.

Clooks는 프로세스 생성 없이 훅 디스패치를 처리하는 지속적인 HTTP 데몬을 제공하여 이 문제를 해결합니다. Claude Code는 이미 기본적으로 HTTP 훅을 지원하므로, Clooks는 이를 가리킬 가치가 있는 데몬을 제공합니다.

성능 벤치마크

소스 벤치마크에서:

• 단일 호출: 약 34.6ms → 약 0.31ms
• 전체 세션 (120회 호출): 약 3,986ms → 약 23ms

핵심 기능

• clooks migrate: 기존 훅을 자동으로 변환하며, 재작성 없이 하나의 명령어로 완료
• LLM 핸들러: $TRANSCRIPT, $GIT_DIFF, $ARGUMENTS와 같은 변수와 프롬프트 템플릿을 사용하여 훅 구성에서 Claude를 직접 호출
• 배치 그룹화: 동일한 batchGroup을 가진 핸들러는 단일 API 호출을 공유
• 의존성 해결: depends: [other-handler] 구문과 위상 정렬을 통한 병렬 실행 웨이브
• 플러그인 시스템: 재사용 가능한 훅 세트를 clooks-plugin.yaml로 패키징하고 clooks add로 설치
• 핫 리로드: 매니페스트를 편집하면 데몬이 즉시 반영
• 메트릭 및 비용 추적: clooks stats는 실행 중인 내용을 표시하고, clooks costs는 LLM 지출을 추적

시작하기

설치: npm install -g /clooks

그런 다음 실행: clooks migrate

현재 버전은 v0.5이며, 활발히 개발 중이고 다듬어질 부분이 있습니다. 이 도구는 기여에 열려 있습니다.