YeonwooSung/my-claude-code-mods
Custom Claude Code Mods that I need
My Claude Code Mods – 소개
Anthropic의 코드 어시스턴트 환경인 Claude Code를 위한 플러그인(이하 "모드") 모음입니다. 각 모드는 개발자가 코딩 세션 중에 Claude가 수행하는 작업을 이해하고 제어할 수 있도록 돕는 작은 UI 또는 진단 기능을 추가합니다.
개별 모드
| 모드 | 기능 (평이한 설명) |
|---|---|
| agent‑profiler | 세션 시간이 어디에 소비되는지(모델 대기, 도구 실행, 하위 에이전트 호출, 코드 재읽기 등)를 보여줍니다. Jaeger나 Tempo에서 볼 수 있는 OpenTelemetry 추적 데이터를 내보낼 수도 있습니다. |
| context‑inspector | Claude가 프롬프트 창을 어떻게 사용하는지 분석합니다. 창을 채우는 텍스트, 재읽기 빈도, 중복에 가까운 출력 생성 여부, 압축되는 부분 등을 분석하여 컨텍스트 낭비를 줄이기 위한 조언을 제공합니다. |
| time‑machine | 각 단계 후 파일 시스템의 "shadow‑git" 스냅샷을 찍어 분기되는 타임라인에 모든 도구 호출을 기록합니다. 특정 단계로 되돌리기, 테스트를 깨뜨린 편집 확인, 파일 복원, 브랜치 생성, 실행 비교, 단계 재실행이 가능합니다. |
| loop‑detective | 반복되는 Bash 실패 및 편집 재시도 주기를 감시합니다. 루프를 발견하면 증거를 제시하고 조사를 유도하며, 경계가 있는 기록이 포함된 라이브 케이스 창을 표시합니다. |
| pin‑memo | 입력 상자 위에 메모와 클릭 가능한 TODO를 고정할 수 있습니다. 동일한 폴더나 세션을 다시 열면 메모가 자동으로 복원됩니다. |
| model‑effort‑band | 프롬프트 위에 색상 밴드를 그려 선택된 모델과 모델이 사용하는 메인 스레드 작업량을 표시하여, 작업 부하를 시각적으로 빠르게 파악할 수 있게 합니다. |
설치 방법
- Claude Code Mods 마켓플레이스를 추가합니다 (README에 링크된 공식 문서 참조).
- 마켓플레이스를 통해 원하는 모드를 설치합니다. 각 모드의 README에 정확한 명령어가 포함되어 있습니다.
- Claude Code 실행 시
--plugin-dir로 모드를 로드합니다 (또는 UI를 통해 활성화). 다른 설치된 플러그인은 깨끗한 벤치마킹을 위해 비활성화할 수 있습니다.
개발 및 테스트
- Node 버전 – Node 22.19.0 이상이 필요합니다.
- 의존성 –
package-lock.json에 고정되어 있습니다. - 테스트 명령어:
npm ci --ignore-scripts– 정확한 의존성을 설치합니다.npm test– Claude 설치가 필요 없는 핵심 로직 테스트를 실행합니다.CLAUDE_BIN=/path/to/claude npm run test:adapters– Claude와 통신하는 어댑터를 포함한 전체 엔진 스위트를 실행합니다.npm run typecheck– 로컬에서 생성된 엔진 선언에 대해 TypeScript 타입을 검사합니다.
- README의 호환성 매트릭스에는 각 모드가 검증된 Claude Code 버전(주로 2.1.292, 일부 얼리 액세스 참고 사항 포함)이 표시되어 있습니다.
- UI 관련 테스트는 핵심 단위 테스트 스위트와 분리되어 있으며, 대화형 실행이 필요합니다.
성능 벤치마킹 (설명된 방식)
README는 다음과 같은 통제된 실험을 제안합니다:
- 고정된 커밋의 대규모 저장소를 선택합니다.
- 모드 없음, 프로파일러 전용, 타임머신 전용, 모두 사용의 네 가지 구성에서 동일한 워크로드를 실행합니다.
--plugin-dir로 모드를 명시적으로 로드하고 다른 모드는 비활성화합니다.- 예열 후 각 구성당 최소 5회 측정하고 순서를 교차합니다.
- 벽시계 시간, 도구 호출 횟수, 모델 토큰 사용량, 평균 스냅샷 비용을 기록합니다.
- 중앙값과 95분위 값을 보고하며, 순수 모델 지연 시간과 스냅샷/후크 오버헤드를 분리합니다.
추천 대상
- Claude Code를 통한 코드 생성에 의존하며 모델 지연 시간, 컨텍스트 사용량, 도구 호출 기록을 확인하고 싶은 개발자.
- 재현성(time‑machine)이 필요하거나 Bash 스크립트의 무한 루프 버그를 잡고 싶은 팀(loop‑detective).
- 코딩 세션에 빠른 메모를 남기고 싶은 사람(pin‑memo).
결론
My Claude Code Mods는 진단, 기록 추적, UI 도우미 기능을 통해 Claude Code를 확장하는 작고 집중적인 툴박스입니다. 이 저장소는 소스 코드, Node 기반 테스트 하네스, 그리고 공식 Claude Code 마켓플레이스를 통해 각 모드를 설치하는 명확한 지침을 제공합니다. 이는 대규모 언어 모델 코딩 어시스턴트를 사용할 때 개발자 경험을 향상시키는 것을 목표로 하는 진정한 AI 관련 소프트웨어 프로젝트입니다.
관련
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트