클로드 코드 토큰 절약 플러그인 4종 완벽 정리 2탄
클로드 코드를 쓰다 보면 어느 순간 이런 생각이 드실 겁니다. "분명히 많이 쓴 것 같지도 않은데 왜 벌써 한도야?"
원인은 대부분 한 가지입니다. 토큰이 어디서 새는지 모르는 채로 계속 쓰고 있는 것입니다. Anthropic 공식 마켓플레이스에는 현재 171개 이상의 플러그인이 등록되어 있는데, 이 중 실제로 토큰 절약에 직접 기여하는 4가지를 정리했습니다.
설치 방법부터 각 플러그인이 어떤 상황에서 효과적인지까지, 실사용 관점으로 풀어드립니다.
토큰이 왜 이렇게 빨리 사라지는 걸까요?
클로드 코드는 매 요청마다 지금까지의 대화 전체를 다시 읽습니다. 카카오톡 대화방에 메시지를 보낼 때마다 맨 처음부터 전부 다시 읽는 것과 같습니다. 대화가 길어질수록, 참조 파일이 많을수록 비용은 기하급수적으로 늘어납니다.
CLAUDE.md 파일이 길고 지저분하게 방치되어 있거나, AI가 파일 전체를 읽어야 하는 상황이 반복된다면 토큰은 생각보다 훨씬 빠르게 소진됩니다. 문제는 이 낭비가 눈에 보이지 않는다는 점입니다.
아래 4가지 플러그인은 각각 다른 방식으로 이 문제를 해결합니다.
① session-report — 토큰 낭비의 원인을 추적한다
✅ 이런 분께 추천
- 세션 비용이 어디서 발생하는지 파악하고 싶은 분
- Pro 플랜에서 한도 초과가 자주 발생하는 분
- 여러 프로젝트를 동시에 진행하는 개발자
session-report는 세션이 끝날 때 토큰 사용 내역을 리포트로 정리해주는 공식 플러그인입니다. 현재 세션에서 어떤 작업에 토큰이 가장 많이 쓰였는지, 어느 시점부터 컨텍스트가 무거워졌는지를 확인할 수 있습니다.
기본 제공되는 /usage 명령이 현재 세션의 총합만 보여준다면, session-report는 세션 종료 후 구체적인 사용 패턴을 분석해줍니다.
실용적인 팁 3가지:
- 세션 종료 전 리포트를 확인하고 다음 세션에서 불필요한 파일 참조를 줄이세요.
- 비용이 갑자기 급증한 시점을 찾아 해당 명령 패턴을 피하도록 조정합니다.
- 여러 프로젝트를 비교하면 어느 코드베이스가 토큰을 더 많이 쓰는지 파악됩니다.
② claude-md-management — CLAUDE.md를 항상 최신으로 유지한다
✅ 이런 분께 추천
- CLAUDE.md를 만들어두고 오랫동안 방치한 분
- 여러 레포지토리에 CLAUDE.md가 분산되어 있는 분
- 세션마다 비슷한 지시를 반복하는 분
CLAUDE.md는 클로드 코드가 세션 시작 시 반드시 로드하는 파일입니다. 여기에 불필요한 내용이 쌓여 있을수록 매 세션 시작부터 토큰 낭비가 시작됩니다.
claude-md-management 플러그인은 두 가지 핵심 기능을 제공합니다. claude-md-improver 스킬로 레포지토리 전체의 CLAUDE.md 품질을 점수와 등급으로 평가하고, /revise-claude-md 명령으로 세션 종료 전에 새로운 인사이트를 파일에 반영합니다.
품질 평가 기준은 명령어 목록, 아키텍처 설명, 주의사항(gotchas), 간결성 등 4가지입니다. 수정사항은 diff로 보여주고 승인 후에만 적용됩니다.
실용적인 팁 3가지:
- CLAUDE.md는 500줄 이하를 목표로 유지하세요. 자주 쓰지 않는 내용은 SKILL.md로 분리합니다.
- 생산적인 세션 직후
/revise-claude-md를 실행해 발견한 패턴을 즉시 기록하세요. - 주기적으로 "audit my CLAUDE.md files"를 입력해 품질 리포트를 받아보세요.
③ Serena — 코드 검색 방식 자체를 바꾼다
✅ 이런 분께 추천
- 규모가 큰 코드베이스에서 클로드 코드를 사용하는 개발자
- 리팩토링이나 함수 참조 작업이 많은 분
- 같은 코드 분석을 여러 번 반복하다 토큰이 소진되는 분
Serena는 파일 기반 코드 검색 대신 LSP(Language Server Protocol) 기반으로 코드 구조를 이해합니다. 클로드가 1,000줄짜리 파일 전체를 읽지 않고, 관련된 심볼 5개만 가져오는 방식입니다.
수치로 비교하면 차이가 명확합니다. 기존 방식으로 1,000줄 파일을 처리하면 약 8,000 토큰이 소모되지만, Serena를 사용하면 동일한 작업에 약 500 토큰만 필요합니다. 경우에 따라 70~80% 수준의 절약이 가능하다고 알려져 있습니다.
단순 텍스트 검색이 아니라 코드의 의미와 의존성을 이해하기 때문에 리팩토링 정확도도 높아집니다. 불필요한 재시도 자체가 줄어드는 효과입니다.
실용적인 팁 3가지:
- 파일 전체를 열지 말고 함수명이나 심볼 단위로 작업을 요청하는 습관을 들이세요.
- 대규모 프로젝트일수록 Serena의 효과가 커집니다. 소규모 스크립트에는 큰 차이가 없을 수 있습니다.
- GitHub
oraios/serena에서 설치하고 MCP 서버로 연결합니다.
④ Hookify — AI가 나쁜 습관을 반복하지 못하게 막는다
✅ 이런 분께 추천
- AI가 위험한 bash 명령을 실행하는 것이 걱정되는 분
- 같은 실수(프로덕션 파일에 console.log 등)를 반복적으로 수정하는 분
- 팀 프로젝트에서 코딩 컨벤션을 자동으로 강제하고 싶은 분
Hookify는 마크다운 파일로 AI의 행동 규칙을 정의하는 플러그인입니다. 코드 없이 YAML 프론트매터만으로 규칙을 만들 수 있습니다. bash 명령 실행, 파일 편집, 프롬프트 입력, 세션 종료 등 다양한 이벤트에 반응합니다.
예를 들어 /hookify rm -rf 명령은 항상 경고해줘를 입력하면 자동으로 규칙 파일이 생성되고, 다음 번 해당 명령이 감지되면 즉시 경고가 뜹니다. 재시작 없이 즉시 적용됩니다.
Hookify는 AI가 나쁜 패턴을 반복하는 것 자체를 차단해서 불필요한 수정-재시도 루프를 줄여줍니다. 간접적으로 토큰 절약 효과가 생깁니다.
실용적인 팁 3가지:
- 매번 수정하게 되는 AI의 행동 패턴이 있다면
/hookify를 인자 없이 실행하세요. 대화를 분석해 자동으로 규칙을 제안합니다. /hookify:list로 현재 활성화된 규칙 목록을 확인하고, 필요 없는 것은 정리하세요.- 팀 프로젝트에서는 규칙 파일을 버전 관리에 포함시키면 모든 팀원에게 동일한 가드레일이 적용됩니다.
4가지 플러그인 비교 한눈에 보기
| 플러그인 | 핵심 역할 | 절약 방식 | 난이도 |
|---|---|---|---|
| session-report | 세션 비용 분석 | 낭비 구간 파악 → 다음 세션 최적화 | ⭐ 쉬움 |
| claude-md-management | CLAUDE.md 품질 관리 | 로드 비용 감소 + 맥락 품질 향상 | ⭐ 쉬움 |
| Serena | LSP 기반 코드 검색 | 파일 전체 읽기 제거 (최대 80% 절약) | ⭐⭐ 보통 |
| Hookify | 행동 가드레일 설정 | 반복 실수·재시도 루프 차단 | ⭐ 쉬움 |
📦 플러그인 설치 방법
클로드 코드에서 /plugin을 입력하면 마켓플레이스 UI가 열립니다. Discover 탭에서 플러그인 이름을 검색하고 설치하면 됩니다. Serena는 별도로 MCP 서버 방식으로 연결합니다.
공식 마켓플레이스 추가 명령: claude plugin marketplace add anthropics/claude-plugins-official
이런 분께 특히 추천합니다
- Claude Pro/Max 플랜을 쓰면서 사용량 한도에 자주 걸리는 분
- 중대형 프로젝트에서 클로드 코드를 에이전트 방식으로 사용하는 개발자
- 팀 단위로 클로드 코드를 도입하고 있어 비용 관리가 필요한 분
- AI의 반복적인 실수 때문에 수정 루프가 길어지는 상황을 겪고 있는 분
직접 써보니 이랬습니다
저는 오늘 소개한 4가지 중 session-report와 claude-md-management, 이 두 가지를 먼저 설치했습니다. 나머지 두 개(Serena, Hookify)는 솔직히 말씀드리면 현재 제 작업 수준에서는 왜 필요한지 아직 잘 와닿지 않더라구요. 억지로 다 쓰기보다는, 필요성이 느껴질 때 하나씩 추가하는 게 맞다고 생각했습니다.
설치 전에 클로드에게 두 플러그인 화면을 스크린샷으로 보여줬더니, 어떤 기능인지 간단하게 설명해주면서 제가 하는 작업에 유용할 거라고 했습니다. 그 말을 듣고 바로 써봤는데요.
session-report를 실행해봤더니 캐시 히트율이 95.4% (우수)로 나왔습니다. 작업별로 토큰을 얼마나 썼는지가 한눈에 정리되니까, 막연하게 "많이 쓴 것 같다"는 느낌이 아니라 실제 수치로 확인이 돼서 훨씬 마음이 놓였습니다.
claude-md-management는 실행했더니 세션 관리 방법, inbox-watcher 충돌 방지, lib 경로 설정 등에 대해 compact 작업을 추천해줬습니다. 바로 적용해봤는데 CLAUDE.md가 한결 깔끔해진 느낌이었습니다. 저처럼 계속 배워가면서 쓰는 입장에서는 이런 것들을 하나씩 써보는 과정 자체가 꽤 즐겁습니다. 재밌고 유용한 게 생기면 계속 소개해 드릴게요!
마무리
토큰 절약의 핵심은 "적게 물어보는 것"이 아닙니다. 지금 작업에 필요한 것만 보여주고, 불필요한 반복을 사전에 차단하는 것입니다.
4가지 플러그인 중 바로 시작하기 좋은 것은 session-report와 claude-md-management입니다. 설치와 사용이 모두 간단하고, 기존 워크플로우를 크게 바꾸지 않아도 됩니다. 코드 작업 비중이 높다면 Serena를 추가하면 체감 효과가 확연히 달라질 것입니다.
플러그인 하나하나가 작아 보여도, 세션마다 쌓이는 낭비를 줄이면 같은 요금제로 훨씬 더 많은 작업을 처리할 수 있습니다.
📌 핵심 요약
- session-report: 세션별 토큰 흐름 분석 → 다음 세션 개선에 활용
- claude-md-management: CLAUDE.md 품질 점수화 + 세션 학습 자동 반영
- Serena: LSP 기반 코드 검색으로 파일 전체 읽기 대체 (최대 80% 절약)
- Hookify: 마크다운 규칙으로 AI 행동 가드레일 설정 → 재시도 루프 차단
자주 묻는 질문 (FAQ)
Q. 이 플러그인들은 Pro 플랜에서도 효과가 있나요?
네, 오히려 Pro 플랜 사용자에게 더 중요합니다. Pro는 사용량 한도가 상대적으로 낮기 때문에 토큰 낭비를 줄이는 것이 체감 효과가 크게 납니다. Max 플랜 사용자도 비용 효율화 측면에서 충분히 유용합니다.
Q. Serena는 어떤 언어를 지원하나요?
Serena는 LSP를 사용하기 때문에 LSP가 지원하는 대부분의 언어에서 사용할 수 있습니다. TypeScript, JavaScript, Python, Go, Java, Rust 등 주요 언어를 포함합니다. 언어별 LSP 서버를 별도로 설치해야 할 수 있습니다.
Q. Hookify 규칙은 어디에 저장되나요?
규칙은 .claude/hookify.{rule-name}.local.md 형태의 마크다운 파일로 저장됩니다. 팀에서 공유하려면 local이 아닌 경로에 저장하고 git에 커밋하면 됩니다.
Q. 플러그인을 많이 설치하면 오히려 토큰이 더 소모되지 않나요?
이 점은 실제로 주의할 필요가 있습니다. 플러그인 자체도 세션당 일정량의 토큰을 소모합니다. 불필요한 플러그인은 설치하지 않고, 소개된 4가지처럼 명확하게 비용 절감 효과가 있는 것만 선택적으로 사용하는 것이 좋습니다.
Q. claude-md-management와 직접 CLAUDE.md를 편집하는 것의 차이가 있나요?
직접 편집도 당연히 가능합니다. 이 플러그인의 장점은 AI가 실제 세션에서 발견한 패턴을 자동으로 포착해 수정을 제안한다는 점입니다. 수동으로 생각하기 어려운 환경 특이사항이나 반복 명령을 자동으로 기록해주는 것이 핵심 가치입니다.
📹 참고 영상
본 글은 아래 유튜브 영상의 내용을 바탕으로 작성되었습니다.
클로드 코드 공식 플러그인 4개로 토큰 절약 끝 (하네스 실무 포함)
클로드 코드를 더 효율적으로 쓰고 싶다면
오늘 소개한 4가지 플러그인 중 하나라도 지금 설치해보세요.
session-report → claude-md-management → Serena → Hookify 순서로 단계적으로 적용하면 부담 없이 시작할 수 있습니다.
