Repolode
karanb192

karanb192/claude-code-hooks

Claude Code의 에이전트 도구 호출에 안전장치, 자동화, 비용 추적 및 알림을 적용하는 설치형 훅 모음입니다.

스타
576
포크
49
열린 이슈
6
마지막 커밋
5일 전

어떤 프로젝트인가요?

claude-code-hooks는 바로 사용할 수 있는 Claude Code용 훅 모음으로, 설치 가능한 플러그인 22개를 플러그인 마켓플레이스 형태로 제공합니다. 훅은 PreToolUse 및 PostToolUse 같은 시점에 실행되어 도구 호출을 허용하거나 거부하거나 수정할 수 있으며, 그 이유는 에이전트에 전달됩니다. 훅은 모델 외부에서 별도 프로세스로 실행되므로 프롬프트 내용과 관계없이 적용됩니다.

안전 플러그인은 .env 및 기타 비밀 파일 읽기와 유출, pipe-to-shell 방식의 설치, 홈 디렉터리에서의 rm -rf, main 브랜치로의 force push, 훅 및 설정 구성을 직접 수정하는 작업을 차단합니다. 그 밖에도 마크다운 세션 기록, 일일 스탠드업 생성, 테스트 변조 방지, 자동 git 스테이징, ruff 및 prettier를 이용한 코드 포맷팅, 컨텍스트 비용 추적, Claude가 입력을 기다릴 때 보내는 Slack 알림 플러그인이 있습니다. 대부분의 가드에는 설정 가능한 안전 수준이 있으며, 차단하는 대신 확인을 요청하는 ask 모드도 지원합니다.

각 플러그인은 슬래시 명령 하나로 설치할 수 있으며, 각 스크립트는 settings.json에 등록하면 독립 실행형으로도 사용할 수 있습니다. 프로젝트에는 Node 18, 20, 22에서 실행하는 테스트 스위트와 OWASP LLM Top 10 2026에 대한 매핑이 포함되어 있습니다.

핵심 기능

  • 01홈 디렉터리에서의 rm -rf, fork bomb, curl | sh 같은 위험한 셸 명령을 차단합니다.
  • 02.env 파일, SSH 키, 클라우드 자격 증명의 읽기 또는 유출을 방지합니다.
  • 03세션 중 에이전트 자체의 안전장치 구성이 변경되지 않도록 보호합니다.
  • 04Claude Code가 사용자 입력을 기다릴 때 Slack 알림을 보냅니다.
  • 05각 세션을 마크다운으로 기록하고 에이전트 활동을 바탕으로 일일 스탠드업을 생성합니다.
  • 06Claude Code 마켓플레이스에서 개별 플러그인으로 설치하거나 독립 실행형 스크립트로 사용할 수 있습니다.

활용 사례

  • 자율 코딩 에이전트가 파일을 삭제하거나 main 브랜치에 force push하지 못하도록 안전장치를 추가할 때.
  • .env 파일이 포함된 저장소에서 에이전트가 비밀 정보에 접근하지 못하게 할 때.
  • 매일 Claude Code를 사용하는 팀에서 세션 활동과 토큰 비용을 추적할 때.
  • 장시간 실행되는 에이전트 세션이 승인을 기다릴 때 Slack 알림을 받을 때.

빠른 시작

  1. 1

    Claude Code에 마켓플레이스를 추가합니다(최초 1회)

    /plugin marketplace add karanb192/claude-code-hooks
  2. 2

    원하는 hook을 설치합니다(예: context-hogs. 이름은 원하는 것으로 바꾸세요)

    /plugin install context-hogs@claude-code-hooks
  3. 3

    hook을 활성화하려면 Claude Code를 다시 시작합니다

사용 전 알아둘 점

  • Config-guard는 기본 높은 수준 설정에서 claude plugin install, uninstall, disable도 차단합니다. 따라서 다른 플러그인을 먼저 설치하거나 해당 명령을 실행할 때 CONFIG_GUARD_ALLOW=true를 설정하세요.
  • Config-Change 페이로드 스키마는 문서화되어 있지 않으므로 config-watch는 이를 방어적으로 파싱합니다.

포함된 컬렉션

토픽

자주 묻는 질문

claude-code-hooks은(는) 무엇인가요?
Claude Code의 에이전트 도구 호출에 안전장치, 자동화, 비용 추적 및 알림을 적용하는 설치형 훅 모음입니다. claude-code-hooks는 바로 사용할 수 있는 Claude Code용 훅 모음으로, 설치 가능한 플러그인 22개를 플러그인 마켓플레이스 형태로 제공합니다. 훅은 PreToolUse 및 PostToolUse 같은 시점에 실행되어 도구 호출을 허용하거나 거부하거나 수정할 수 있으며, 그 이유는 에이전트에 전달됩니다. 훅은 모델 외부에서 별도 프로세스로 실행되므로 프롬프트 내용과 관계없이 적용됩니다.
claude-code-hooks은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
claude-code-hooks은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
claude-code-hooks은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. claude-code-hooks의 마지막 커밋은 2026년 11월 2일입니다.
claude-code-hooks은(는) 어디에 사용할 수 있나요?
자율 코딩 에이전트가 파일을 삭제하거나 main 브랜치에 force push하지 못하도록 안전장치를 추가할 때. .env 파일이 포함된 저장소에서 에이전트가 비밀 정보에 접근하지 못하게 할 때. 매일 Claude Code를 사용하는 팀에서 세션 활동과 토큰 비용을 추적할 때. 장시간 실행되는 에이전트 세션이 승인을 기다릴 때 Slack 알림을 받을 때.
claude-code-hooks는 어떻게 설치하나요?
Claude Code에 마켓플레이스를 추가합니다(최초 1회): /plugin marketplace add karanb192/claude-code-hooks 원하는 hook을 설치합니다(예: context-hogs. 이름은 원하는 것으로 바꾸세요): /plugin install context-hogs@claude-code-hooks hook을 활성화하려면 Claude Code를 다시 시작합니다
claude-code-hooks은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/karanb192/claude-code-hooks

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트