신규하 블로그

개발 기록 보관소

Claude Code Hooks 완전 정복: 이벤트/결정 제어/비동기까지 한 번에 이해하기

AI Development
Claude Code의 hooks는 “언젠가 LLM이 알아서 하겠지”가 아니라, 특정 시점에 특정 검사를 반드시 실행하도록 만드는 장치입니다. 이 글은 공식 문서의 참조 스키마를 기준으로, 어떤 이벤트가 있고(언제 발화하고), matcher가 무엇을 필터링하며, 훅이 어떤 방식으로 Claude Code의 동작을 허용/차단/계속 작업 유도 할 수 있는지까지 한 번에 정리합니다. 핵심은 2가지입니다. 훅은 명령(Exit code) 과 구조화된 JSON 출력 두 축으로 동작을 제어합니다. “차단 가능 여부”는 이벤트마다 다릅니다. PreToolUse는 실행 전이라 차단이 되지만 PostToolUse는 실행 후라 차단이 아닌 피드백 으로 작동합니다. 더보기

ykdojo/claude-code-tips 실전 운영 가이드: 46개 팁(0-45)을 워크플로우로 엮기

AI Development Productivity
ykdojo/claude-code-tips는 Claude Code를 오래 쓰면서 생기는 문제(컨텍스트 비대화, 검증 루프 부재, 위험한 자동화, 반복 설정)를 46개의 팁(0-45)과 스크립트/스킬/플러그인 형태로 정리한 저장소입니다. 단순히 “팁을 많이 안다” 보다 중요한 건, 팁을 시스템으로 엮어서 매번 같은 품질로 실행하는 것인데, 이 글은 그 관점(측정 - 컨텍스트 - 검증 - 격리 - 패키징)으로 재구성합니다. 더보기

Claude HUD: Claude Code를 위한 실시간 상태 표시줄(Statusline) 플러그인

claude-code
Claude Code와 같은 에이전트형 CLI 도구가 등장하면서, 개발자들은 터미널을 떠나지 않고 코딩 작업을 AI에게 위임하는 경우가 늘고 있습니다. 하지만 긴 세션을 유지하다 보면 컨텍스트 윈도우가 얼마나 찼는지, 에이전트가 무한 루프에 빠진 것은 아닌지 파악해야 할 필요성이 커졌습니다. Claude HUD는 이러한 문제를 해결하는 실시간 모니터링 도구입니다. 더보기