karanb192/claude-code-hooks

🪝 Claude Code hooks + an installable plugin marketplace: safety, cost, observability, productivity.

개요

**claude-code-hooks**는 Claude Code(Anthropic 기반 AI 어시스턴트 소프트웨어로, 셸 명령 실행, 파일 편집, 패키지 설치 등을 자율적으로 수행할 수 있음)에 연결할 수 있는 바로 사용 가능한 후크 모음입니다. 후크는 에이전트의 작업을 전후에 가로채서 차단, 수정 또는 기록할 수 있게 해주는 안전 가드 및 자동화 헬퍼 역할을 합니다. 이 프로젝트는 단일 Claude Code 명령으로 설치할 수 있는 22개의 개별 플러그인 마켓플레이스를 제공합니다.

프로젝트 제공 기능

기능 설명 사용 방법
안전 가드 위험한 명령(rm -rf ~, `curl sh`) 차단, 시크릿 파일 읽기 방지, Git 브랜치 규칙 적용, 테스트 숨기기 트릭 중지, 에이전트 자체 구성 보호, 하위 에이전트 생성 제한 등.
로깅 및 감사 세션 수준 Markdown 로그, 스탠드업 자동 생성, 실패에 대한 개인 비행 기록 장치, 규정 준수 스코어카드, 파일별 "컨텍스트 비용" 리더보드. session-logger와 같은 로거 플러그인을 설치하고 생성된 Markdown 또는 명령줄 카드를 확인합니다.
자동화 헬퍼 편집된 파일 자동 스테이징, 편집 후 코드 자동 포맷, PR 본문에 출처 정보 스탬프, 저장소 TODO를 현상금 보드 퀘스트로 전환. 헬퍼 플러그인을 설치하고 슬래시 명령(예: /auto-stage)을 호출합니다.
알림 Claude가 사용자 권한이 필요할 때 Slack 알림을 보냅니다. notify-permission을 설치하고 Slack 웹훅을 구성합니다.
개발자 유틸리티 event-logger.py는 자체 후크를 빌드할 때 모든 후크 이벤트의 페이로드를 검사하는 데 도움이 됩니다. Claude 세션이 활성화된 동안 Python 스크립트를 실행합니다.

모든 후크는 일반 Node.js 스크립트(*.js)로 모델 프로세스 외부에서 실행되므로 프롬프트 인젝션 공격이 이를 우회할 수 없습니다. 각 후크는 개별적으로 설치하거나 7가지 핵심 가드의 경우 guard-pack 플러그인을 통해 번들로 설치하여 단일 프로세스로 시작할 수 있습니다.

시작 방법

  1. 마켓플레이스 추가(한 번만):
    /plugin marketplace add karanb192/claude-code-hooks
  2. 필요한 후크 설치(예):
    /plugin install protect-secrets@claude-code-hooks
  3. Claude Code를 재시작하여 후크를 활성화합니다.
  4. 제공된 슬래시 명령(예: /protect-secrets)을 사용하거나 생성된 로그/보드를 확인합니다.

구성은 HOOK_SAFETY_LEVEL=high 또는 CONFIG_GUARD_ALLOW=true와 같은 환경 변수를 통해 이루어지며 특정 호출에 대한 가드를 완화할 수 있습니다.

누구에게 유용한가?

  • Claude Code를 사용하는 개발자: 어시스턴트가 파일을 실수로 삭제하거나 자격 증명을 유출하거나 파괴적인 Git 작업을 수행하지 않도록 하려는 경우.
  • 규정 준수 요구 사항이 있는 팀: AI 기반 코드 변경에 대한 감사 추적이 필요한 경우.
  • 운영/보안 엔지니어: CI/CD 파이프라인에서 AI 에이전트를 샌드박스 처리하려는 경우.
  • 사용자 지정 Claude Code 확장을 구축하는 모든 사람: 제공된 event-logger 및 예제 후크를 템플릿으로 재사용할 수 있습니다.

제한 사항/고려 사항

  • 가드는 문서화된 후크 이벤트(PreToolUse, PostToolUse 등)를 발생시키는 Claude Code 버전에서만 작동합니다.
  • config-guard를 활성화하면 플러그인 관리자 자체도 차단되므로 다른 모든 플러그인을 설치한 후 켜거나 CONFIG_GUARD_ALLOW=true를 임시로 설정해야 합니다.
  • 후크는 별도 프로세스로 실행되며 번들된 guard-pack의 경우 호출당 약 35ms의 작은 오버헤드가 추가됩니다.
  • 안전 수준(critical, high, strict)에 따라 후크가 자동으로 거부하거나, 경고하거나, 진행 전에 사용자에게 확인하는지가 결정됩니다.

요약: claude-code-hooks는 Claude Code 에이전트에 최소 권한, 로깅 및 자동화를 제공하는 실용적인 도구 상자로, 모델이 컴퓨터에서 실제로 수행할 수 있는 작업을 엄격하게 제어하면서 AI 기반 코딩을 안전하게 활용할 수 있게 해줍니다.

관련

  • 프로젝트
    sangrokjung/claude-forge

    Claude Forge는 기본적인 Claude Code 터미널 기반 코딩 어시스턴트를 프로덕션 수준의 개발 환경으로 바꾸는 플러그인 팩입니다. 16개의 전문 AI 에이전트, 35개의 슬래시 명령어, 33개의 저장된 '스킬', 22개의 안전 훅, 14개의 행동 규칙, 4개의 외부 도구 연결을 추가합니다. 1줄 스크립트로 설치(전체 설치)하거나 Claude Code의 플러그인 마켓플레이스를 통해 설치(명령어만). 이 팩은 계획 수립, 테스트 우선 개발, 보안 리뷰, 문서 동기화, 그리고 독립된 에이전트가 모든 변경 사항을 승인해야 하는 적대적 검증 루프를 자동화합니다. MIT 라이선스, v4.3.0 (2026년 9월) 기준으로 지속적으로 유지보수 중입니다.

  • 프로젝트
    Chachamaru127/claude-code-harness

    Claude Code Harness는 Claude 기반(또는 호환 가능한) AI 에이전트를 체계적인 루프—계획, 작업, 검토, 동기화, 릴리스—로 조율하는 Go 네이티브 플러그인입니다. 각 단계에서 강력한 가드레일과 인간 승인을 강제하며, 사양 생성, AI 기반 구현, 독립적 변경 검토, 검증된 릴리스 패키징을 지원합니다. Claude Code, Codex CLI, Cursor, Grok를 지원합니다.

  • 프로젝트
    Lifecycle-Innovations-Limited/claude-ops

    Claude‑Ops는 Claude Code 환경을 터미널 기반 비즈니스 운영 체제로 전환하는 플러그인 겸 설치 프로그램으로, 대시보드, 자동 수정, 안전 후크, 자율 에이전트, GitHub, AWS, Stripe, 마케팅 도구, 음성 통화 등과의 통합을 제공합니다.

  • 프로젝트
    wesammustafa/Claude-Code-Everything-You-Need-to-Know

    Anthropic의 Claude Code CLI를 위한 실용적이고 최신화된 가이드로, 설치, 프롬프트 엔지니어링, 커스텀 슬래시 명령어(Skills), 자동화 Hooks, 하위 에이전트, JavaScript 워크플로우 및 외부 도구 통합을 위한 Model-Context-Protocol을 다룹니다. AI 강화 개발 파이프라인을 구축하는 팀을 위한 복사 가능한 .claude/ 예제를 포함합니다.

  • 프로젝트
    Prorise-cool/Claude-Code-Multi-Agent

    Claude Code Multi‑Agent는 Anthropic의 Claude Code 프로젝트에 인식 능력과 전문가 에이전트 기능을 제공하는 오픈소스 프레임워크입니다. Python Hook 시스템과 로컬에서 실행되는 Ollama 모델을 사용해 코드베이스 유형을 자동 감지하고, 사용자 의도를 분석하며, 300개 이상의 도메인 전용 "스킬"(백엔드, 프론트엔드, 테스트, 보안 등)을 로드하고, 자동 문서화(DEVELOPMENT.md, KNOWLEDGE.md, CHANGELOG.md)를 강제합니다. 리포지토리를 클론하고 Ollama, 모델, uv를 설치한 후 프로젝트를 리포지토리에 넣기만 하면, Claude Code는 즉시 컨텍스트를 이해하고 적절한 도구를 제안하며, `/backend‑specialist` 또는 `/kiro/spec`와 같은 슬래시 명령어로 조작할 수 있습니다. 주요 특징: - 제로 설정 시작; 모든 설정은 `.claude/settings.json`과 `prompts.json`에 저장. - 세션 시작, 사용자 프롬프트, 도구 사용 등에 따라 실행되는 Hooks로 프로젝트 감지, 의도 분석, 문서 업데이트 처리. - Skills는 `SKILL.md` 파일로 정의되며 자동 탐지됨. - 외부 API를 전혀 사용하지 않고 완전히 로컬에서 동작. Git과 통합 가능. MIT 라이선스. 개인 개발자나 소규모 팀이 재현 가능하고 온프레미스 AI 코딩 보조 도구를 원할 때 이상적입니다.