hamzafer/claude-code-mods

해결하는 문제

Claude Code (Anthropic의 터미널 코딩 에이전트)는 내부 작동 방식이 대부분 보이지 않습니다. 이 프로젝트는 Claude Code의 동작을 시각화하는 일련의 선택적 플러그인을 제공합니다. 프롬프트 위의 실시간 상태 줄, 에이전트 활동을 보여주는 패널, 파괴적 명령 전 경고, 심지어 시간을 보낼 수 있는 게임까지 포함합니다. 컨텍스트 사용량, 하위 에이전트의 작업 내용, 검토 완료 시점, 또는 파일 삭제와 같은 위험한 명령이 실행되려는지 알 수 없는 문제를 해결합니다.

작동 방식

이 플러그인들은 Claude Code의 함수 후크를 기반으로 구축되었습니다. 이는 도구 호출, 프롬프트 전송, 세션 수명 주기와 같은 이벤트에서 실행되는 후크입니다. 각 "mod"는 개별적으로 설치할 수 있는 작은 플러그인입니다. 프로젝트에는 설치 프로그램 (npx claude-code-mods@latest)이 포함되어 있어 사용 가능한 mod 목록을 보여주고, 활성화할 항목을 선택하여 Claude Code 설정에 설치할 수 있습니다. 또한 간단한 인터페이스를 통해 "bands"(프롬프트 위의 실시간 줄)의 순서를 정할 수도 있습니다. Mod는 Claude Code의 마켓플레이스 시스템을 통해 플러그인으로 설치되며, 일부 mod는 추가 도구(예: 이미지 렌더링을 위한 Chrome, GitHub 기능을 위한 gh)가 필요합니다.

대상 사용자

터미널에서 Claude Code를 사용하며 세션에 대한 더 많은 투명성과 제어권을 원하는 개발자. 컨텍스트 사용량을 확인하고, 하위 에이전트를 모니터링하며, 파괴적 명령으로부터 보호받거나, 대기 시간 동안 즐길 거리를 원하는 분들에게 이상적입니다. 터미널과 Claude Code에 익숙한 사용자를 대상으로 하며, 다른 작성자가 유지 관리하는 커뮤니티 mod도 포함되어 있습니다.

주요 기능

• 실시간 상태 줄 (예: context-bar, token-weather, cache-clock)이 프롬프트 위에 컨텍스트 사용량, 토큰 캐시, 세션 비용을 표시합니다.
• mission-control은 하위 에이전트, 도구 호출, 작업 중인 파일을 매핑하는 실시간 패널을 제공합니다.
• blast-radius는 rm -r 및 강제 푸시와 같은 위험한 명령을 보류하고, 진행하기 전에 삭제될 내용을 보여줍니다.
• switchboard는 하위 에이전트를 더 저렴한 모델(예: Claude Opus에서 Haiku로)로 자동 라우팅합니다.
• reels (YouTube Shorts), snake, now-playing (Spotify)과 같은 재미있는 mod가 Claude가 작업하는 동안 즐거움을 더해줍니다.
• 커뮤니티 mod는 이미지 미리보기, 중국어 현지화, 약 2,700개의 mod가 있는 mod 스토어와 같은 기능을 추가합니다.
• 설치 프로그램을 통해 활성화할 mod를 정확하게 선택할 수 있으며, 자동화를 위한 --dry-run 및 --pick 옵션도 제공합니다.