JYP Garden

클로드 코드 공식 플러그인 4개로 토큰 절약 끝 (하네스 실무 포함)

Properties1
tagsclaude-code, token-optimization, harness-engineering, plugin, serena-mcp, hookify, knowledge

8 min read

클로드 코드 공식 플러그인 4개로 토큰 절약 끝 (하네스 실무 포함)

채널: 짐코딩 | 길이: 15분 31초 | 분류: 10-Knowledge/sources (LLM/Claude Code 일반 지식)

핵심 요약

Anthropic 공식 마켓플레이스(171개 플러그인 중) 토큰 절약에 직결되는 4가지 플러그인 소개:

  1. 세션 리포트 — 토큰 사용 명세서
  2. CLAUDE.md 매니지먼트 — CLAUDE.md 관리 자동화
  3. 세레나MCP — 의미 기반 코드 검색으로 토큰 절약
  4. Hookify — 반복 실수 사전 차단 (하네스 엔지니어링 핵심 도구)

IDEAS

  • 토큰 낭비의 주요 원인은 Claude의 반복 실수와 불필요한 코드 탐색이다
  • 세션 리포트 플러그인은 프로젝트별·스킬별·프롬프트별 토큰 사용량을 HTML로 시각화한다
  • 프롬프트 캐싱이 깨지면 반복 비용 할인이 무용지물이 된다
  • CLAUDE.md 파일은 모든 프롬프트에 자동 첨부되므로 비대해지면 비용이 증가한다
  • “리바이즈 CLAUDE.md”는 세션 종료 전 대화를 분석해 CLAUDE.md 추가 후보를 추출한다
  • “CLAUDE.md 임프루버”는 6개 기준으로 CLAUDE.md를 주기적으로 평가·등급화한다
  • 세레나 MCP는 IDE의 “Go to Definition” 기능을 Claude에게 붙여주는 도구다
  • grep 기반 검색은 글자만 보고 의미를 모르지만 세레나는 코드 의미(semantic)를 파악한다
  • 세레나는 한 번 탐색에 사용된 토큰이 대화 내내 누적 소모되므로 절약 효과가 복리로 커진다
  • 리팩토링 시 세레나의 rename 기능으로 30개 파일을 일괄 변경할 수 있다
  • Hookify는 Claude가 자주 하는 실수를 등록하면 사전 차단 훅을 자동 생성한다
  • Hookify 사용 패턴: 같은 실수 3회 반복 시 Hookify 실행 → 자동 규칙 추가
  • 잘못된 작업 → 수정 → 재시도 사이클이 수천 토큰을 낭비시킨다
  • 하네스 엔지니어링의 핵심은 AI를 탓하지 않고 실수가 재발하지 않도록 환경을 고치는 것이다
  • Hookify가 생성한 규칙은 .claude/ 디렉터리 하위 Markdown 파일에 frontmatter + 지침으로 저장된다
  • 세레나MCP 설치에는 UV-Python패키지매니저 선행 설치가 필요하다
  • Anthropic 공식 마켓플레이스에서도 외부 도구임에도 세레나를 별도 소개한다
  • 자연어 요청 시 원하는 MCP가 동작하지 않으면 MCP 이름을 명시적으로 언급해야 한다

INSIGHTS

  • 토큰 최적화는 단순 비용 절감이 아니라 작업 품질 유지 문제다 — Claude가 실수를 반복하거나 불필요한 탐색을 할수록 컨텍스트도 오염된다
  • 세레나 MCP의 절약 효과는 “1회 검색 비용 절감”이 아니라 “누적 컨텍스트 팽창 억제”에서 온다 — 대화가 길어질수록 격차가 벌어진다
  • CLAUDE.md 관리 자동화(리바이즈 + 임프루버)는 하네스 엔지니어링 피드백 루프의 문서 계층에 해당한다 — 실수 → 기록 → 지침화 → 예방
  • Hookify는 개발자가 매번 수동으로 규칙을 작성하는 부담을 없애고, Claude 스스로 실수를 분석해 규칙을 제안하게 만든다는 점에서 “자가 개선 하네스”의 패턴이다

QUOTES

  • “AI가 실수를 하면 그 실수가 다시 안 나오도록 환경을 고치는 거예요. 이게 바로 하네스 엔지니어링의 핵심이죠.”
  • “세션 리포트는 클로드 코드의 카드값 명세서라고 보시면 돼요.”
  • “캐시는 토큰 비용을 할인해 주는 핵심 기능인데 자꾸 캐시가 깨지면 이 할인이 무용지물되거든요.”
  • “같은 실수를 세 번 반복했다 싶으면 그냥 Hookify를 한번 때려 보세요.”
  • “에이전트가 실수할 때마다 그 실수가 다시는 발생하지 않도록 엔지니어링 하는 것 — Mitchell Hashimoto”

REFERENCES

이름유형비고
짐코딩person/channel이 영상 제작자, 클로드코드 완벽 마스터 강의 운영
세레나MCPtool의미 기반 코드 검색 MCP
Hookifytool반복 실수 차단 훅 생성 플러그인
Mitchell Hashimotoperson하네스 엔지니어링 용어 최초 제안자
UV-Python패키지매니저tool세레나 MCP 설치 선행 조건
하네스 엔지니어링concept에이전트 실수 재발 방지 엔지니어링 방법론

FACTS

  • Anthropic 공식 마켓플레이스에는 총 171개의 플러그인이 있다 (2026-05 기준)
  • 프롬프트 캐싱은 반복 부분을 캐시에 저장해 두 번째 요청부터 비용을 10분의 1로 줄인다
  • 짐코딩의 클로드코드 완벽 마스터 강의는 출시 6개월 만에 6,600여 명 수강
  • 세레나 MCP는 Anthropic 공식 마켓플레이스에서도 별도 소개될 만큼 Claude 공식 권장 도구
  • Hookify 생성 규칙 파일은 .claude/ 디렉터리에 frontmatter가 포함된 Markdown으로 저장된다
  • 세션 리포트의 기본 분석 기간은 7일이며 --period 30d, --period 24h 옵션으로 변경 가능

HABITS

  • 세션 종료 전 “리바이즈 CLAUDE.md” 실행 → 대화에서 배운 패턴·함정 추출
  • 같은 실수 3회 반복 시 즉시 Hookify 실행 → 자동 규칙 추가
  • 주기적으로 “CLAUDE.md 임프루버” 실행 → 파일 품질 점검

RECOMMENDATIONS

  • 토큰 비용이 많이 나올 때: 세션 리포트로 가장 비싼 프롬프트·프로젝트 파악
  • 대규모 코드베이스 분석·리팩토링: 세레나 MCP 활성화
  • Claude 반복 실수 3회 이상: Hookify로 즉시 규칙화
  • CLAUDE.md 파일이 커질수록: CLAUDE.md 매니지먼트 플러그인으로 주기적 정리

그래프 뷰