이렇게 작동합니다 · 예시
되돌리기 어려운 명령을 실행 직전에 점검합니다.
이런 상황에서
Claude Code가 홈 디렉터리를 재귀 삭제하거나, 다운로드한 내용을 셸로 바로 실행하려고 합니다.
도구가 하는 일
알려진 위험 명령 형태에 해당하면 실행 전에 차단합니다.
Claude Code · cc-agents-kit
실수는 줄이고,하던 일은 이어가세요.
위험한 명령 점검부터 세션 인수인계, 커밋 전 확인까지. 지금 반복해서 겪는 문제를 고르면 필요한 도구와 작동 예시를 볼 수 있습니다.
어떤 일이 자꾸 발목을 잡나요?
명령, 비밀 정보, 저장소 변경을 훅으로 점검합니다.
설치
필요한 기능을 확인한 뒤 설치하세요.
아래 명령은 선택한 플러그인을 묶음으로 설치합니다. 현재 환경에 추가하기 전에 포함된 기능을 확인하세요.
선택한 플러그인
guard-hooks스킬 하나가 유용하다고 플러그인 전체 설치를 권하지 않습니다. 일부 기능만 필요하면 해당 소스와 지원되는 적용 방법부터 검토하세요. 필요하지 않다면 설치하지 않아도 됩니다.
필요한 도구만 고르도록 AI에 검토를 요청하세요.
현재 환경을 알고 있는 AI에 아래 프롬프트를 전달하세요. 설정을 변경하기 전에 소스 근거와 최소한의 추천 조합을 요청합니다.
검토 프롬프트
제가 검토를 허용한 프로젝트와 범위 안에서 https://github.com/AndrewDongminYoo/cc-agents-kit에 공개된 cc-agents-kit 저장소의 플러그인이 현재 환경에 적합한지 평가해 주세요.
1. 공개 README, 마켓플레이스 및 플러그인 매니페스트, 훅 정의, 스킬 파일을 읽어 주세요.
2. 이번 검토를 위해 제가 허용한 로컬 도구와 설정만 확인해 주세요.
3. 각 플러그인을 현재 환경의 도구, 스킬, 훅, 권한, 의존성과 비교해 주세요.
4. 적합성, 중복 기능, 운영 위험을 식별하고, 각 판단의 공개 소스 파일 경로를 제시해 주세요.
5. 필요한 개별 스킬과 훅을 평가해 주세요. 스킬 하나가 유용하다는 이유만으로 플러그인 전체를 추천하지 마세요.
6. 묶음 설치와 일부 기능의 적용을 구분하고, 어떤 적용 방법이 실제로 지원되는지 확인해 주세요. 분명한 이점이 없다면 설치하지 않는 방향을 추천해 주세요.
비밀 정보를 검토 내용에 붙여 넣거나 저장소의 명령을 자동으로 실행하지 마세요. 제가 명시적으로 승인하기 전에는 플러그인을 설치하거나 설정을 변경하지 마세요.이 프롬프트는 분석만 요청합니다. 변경을 승인하기 전에 제시된 근거를 직접 확인하세요.
Claude Code에서 선택한 플러그인 설치하기
/plugin install guard-hooks@cc-agents-kit이미 설치했나요?
마켓플레이스 접미사를 포함한 업데이트 명령을 사용하세요. 다시 설치하는 명령은 성공으로 표시되지만 설치된 버전을 갱신하지 않으며, 마켓플레이스만 새로 고쳐도 런타임 캐시는 바뀌지 않습니다.
셸에서 플러그인 업데이트하기
claude plugin update guard-hooks@cc-agents-kit설치하거나 업데이트한 뒤에는 열려 있는 Claude Code 세션을 모두 다시 시작하세요. 훅은 세션을 시작할 때 로드됩니다.
가드 요구 사항 및 한계
가드가 확인할 수 있는 범위를 알아두세요.
guard-hooks 실행 조건
아래 실행 도구는 guard-hooks에 필요합니다. 선택 도구가 없으면 관련 검사만 비활성화되지만, jq가 없으면 모든 훅이 문제를 차단하지 않고 통과시킵니다.
jq필수- 훅 입력을 해석하며, jq가 없으면 가드가 문제를 차단하지 않습니다
bash필수- macOS를 포함한 모든 환경에서 훅을 실행합니다
git조건부- staged-secret-guard가 커밋 후보를 읽을 때 사용합니다
shellcheck선택- 셸 파일 편집 후 검사 결과를 제공합니다
gitleaks 8.x선택- 출력에서 자격 증명으로 보이는 값을 마스킹합니다
python3테스트 전용- 회귀 테스트 모음을 실행합니다
자주 묻는 질문
마켓플레이스를 추가하기 전에 확인하세요.
세 가지 플러그인을 모두 설치해야 하나요?
아닙니다. 각 플러그인은 의도적으로 분리되어 있습니다. 현재 워크플로의 문제를 해결하는 플러그인만 설치하세요.
guard-hooks는 보안 샌드박스인가요?
아닙니다. guard-hooks는 알려진 실수 유형을 패턴으로 확인합니다. Claude Code의 권한과 운영체제의 제어 기능이 실제 보안 경계를 담당합니다.
업데이트한 뒤에 세션을 다시 시작해야 하는 이유는 무엇인가요?
Claude Code는 세션을 시작할 때 훅을 읽습니다. 플러그인 업데이트 명령이 끝나면 열려 있는 세션을 다시 시작하세요.
구현 내용을 어디에서 확인할 수 있나요?
공개 GitHub 저장소에서 README, 마켓플레이스 메타데이터, 플러그인 매니페스트, 훅 정의, 스킬 파일, 테스트, 라이선스 정보를 확인할 수 있습니다.