claude code 플러그인 — 7개 깔고 재 보니 매 턴 토큰의 87%가 안 쓰는 것이었다

플러그인Claude Code마켓플레이스hooks운영

claude code 플러그인, 무엇을 깔까. 저희 답은 깔아 둔 것부터 재 보라는 것입니다.

켜 둔 플러그인은 쓰지 않는 턴에도 컨텍스트를 씁니다. 저희가 깔아 둔 일곱 개를 재면 이렇습니다.

플러그인 매 세션 토큰 20세션 호출
vercel (공식) 4,219 0
vercel-plugin (외부) 2,830 0
understand-anything 970 0
superpowers (공식) 840 44
superpowers (외부, 중복) 720 0
codex 422 3
frontend-design 80 2
합계 10,081 49

매 턴 비용은 쓰는 플러그인이 아니라 깔아 둔 플러그인이 냅니다.

일곱 개 중 일을 한 것은 셋이고, 그 셋이 내는 토큰은 1,342입니다. 나머지 8,739, 즉 87%는 기록이 남은 스무 세션에서 한 번도 안 부른 플러그인이 냈습니다. 아래는 어떻게 골랐고 어디서 틀렸는지입니다.

환경

  • Claude Code 2.1.287. 측정은 claude plugin details 로 2026년 10월 5일에 했습니다
  • 마켓플레이스 넷. 공식 마켓플레이스에 315개가 있고, 외부 셋에서 각각 하나씩 더 깔았습니다
  • 설치 7개, 전부 사용자 범위. 가장 먼저 깐 것이 4월 8일, 가장 늦게 깐 것이 10월 1일입니다
  • 호출 수는 기록이 남은 세션 스무 개에서 셌습니다. 블로그 레포 6개, 리서치 레포 14개

플러그인은 세션에 무엇을 더하나?

공식 문서의 한 문장이 이 글의 전부입니다. 켜 둔 플러그인은 그것을 쓰는 세션뿐 아니라 모든 세션의 일부라는 것입니다.

더해지는 것은 넷입니다.

① 스킬과 에이전트의 이름과 설명 Claude가 존재를 알아야 부를 수 있으니 매 턴 컨텍스트에 실립니다. 본문은 부를 때만 읽힙니다. 이것이 위 표의 토큰입니다.

② 훅 세션 시작, 도구 호출 전후, 턴 종료 같은 지점마다 플러그인의 명령이 돕니다. 토큰은 안 쓰지만 프로세스가 돕니다.

③ MCP 서버 켜 둔 세션마다 같이 뜹니다. 툴 이름이 컨텍스트에 실립니다.

④ 권한 플러그인이 돌리는 것은 저희 권한으로 돕니다.

저희 일곱 개를 그 넷으로 펼치면 이렇습니다.

플러그인 스킬 에이전트 훅
vercel (공식) 37 0 3
vercel-plugin (외부) 31 3 7
understand-anything 8 9 2
superpowers (공식) 15 0 1
superpowers (외부) 14 0 1
codex 10 1 3
frontend-design 1 0 0

MCP 서버는 vercel 둘만 하나씩 둡니다. 훅 이벤트가 열일곱 개입니다. 세션 하나가 시작할 때 다섯 플러그인의 시작 훅이 돕니다.

무엇을 깔았고 왜인가?

고르는 기준은 하나였습니다. 저희가 실제로 하는 단계에 대응하는 것만.

운영자의 말을 그대로 옮기면 이렇습니다.

“버렸다기보다는 사용하지않아도 된다라고 판단해서 사용 안한거지”

그래서 공식 마켓플레이스 315개 중 다섯 개입니다. 설계와 실행의 순서를 강제하는 superpowers, 코드를 검토하는 codex, 레이아웃 작업 때 깐 frontend-design, 코드베이스 지도를 그리는 understand-anything, 그리고 대시보드 레포의 배포를 맡는 vercel 둘.

superpowers와 codex가 어떻게 일하는지는 superpowers 글과 codex vs claude code 글에 있습니다.

기록에 남은 스무 세션에서 무엇이 쓰였나?

호출을 셌습니다.

플러그인 호출 무엇으로
superpowers (공식) 44 스킬 37, 명령 7
codex 3 명령 3. 정지 시점 리뷰 1,025회는 별도
frontend-design 2 스킬 2, 레이아웃 작업
understand-anything 0
vercel (공식) 0
vercel-plugin (외부) 0
superpowers (외부) 0 같은 스킬이라 공식 쪽이 먼저 잡힌다

codex의 3은 명령으로 부른 횟수입니다. 정지 시점 리뷰 1,025회는 Claude Code 세션 기록이 아니라 Codex 세션 기록에 남아서 따로 셉니다.

vercel 둘은 0인데 조용히 0은 아니었습니다.

세션이 시작하거나 압축 뒤 재개될 때마다 두 플러그인의 시작 훅이 Vercel 안내 블록 셋을 컨텍스트에 넣었습니다. 스무 세션에서 362번입니다. 그중 한 블록은 매번 Vercel CLI 를 업그레이드하라는 권고였고, 361번 나왔습니다. 그리고 MCP 서버의 툴 이름 249개가 매 턴 실렸습니다.

어디서 틀렸나?

고르는 데는 깐깐했고, 깐 뒤에는 보지 않았습니다.

① 설치 범위 vercel 둘은 대시보드 레포(Next.js)를 위한 것입니다. 그런데 사용자 범위로 깔아서 블로그 레포(Astro)와 리서치 레포에서도 돕니다. 이 블로그 레포에서 빌드를 돌리면 Next.js 스킬을 읽으라는 리마인더가 왔습니다. 공식 문서는 범위 셋을 둡니다. 사용자, 프로젝트, 로컬. 대시보드 레포에서만 쓸 것이면 그 레포에서 로컬 범위로 깔았어야 했습니다. 토큰으로 7,049, 전체의 70%입니다.

② 중복 superpowers를 공식 마켓플레이스와 원작자 마켓플레이스에서 같은 날 두 번 깔았습니다. 둘째 것은 한 번도 안 불리면서 720 토큰을 냅니다.

③ 안 쓰는 것 understand-anything은 5월 31일에 깔고 기록이 남은 세션에서 0번입니다. 공식 문서가 최근 사용 없음으로 분류하는 기준이 14일과 10세션인데 둘 다 넘었습니다. 970 토큰입니다.

셋을 합치면 8,739 토큰, 87%입니다.

이 글을 쓰는 시점에 셋은 그대로입니다. 고치는 길은 문서에 있습니다. 범위를 바꾸거나, claude plugin disable 로 끄거나, 지우는 것입니다. 무엇을 할지는 운영자가 정합니다.

어떻게 재나?

넷 다 공식 문서에 있는 길입니다.

매 턴 비용 셸에서 claude plugin details <이름> 을 치면 Always-on 줄이 나옵니다. 위 표가 그 값입니다. MCP 툴은 여기 안 잡히고, 세션 안에서 /context 의 MCP tools 항목으로 봅니다.

안 쓰는 플러그인 /plugin 의 Installed 탭에서 14일과 10세션을 넘긴 것이 Not used recently 아래로 내려갑니다. /doctor 도 안 쓴 것을 끄라고 권합니다.

안 불린 스킬 /skill-doctor 가 스킬마다 비용과 호출 횟수를 보여 줍니다.

비중 /usage 가 최근 사용량을 스킬, 서브에이전트, 플러그인, MCP 서버별로 나눕니다.

저희는 이 넷 중 어느 것도 10월 5일 전에 열어 보지 않았습니다.

남는 것

매 턴 비용은 깔아 둔 것이 냅니다. 쓰는 세션에만 드는 것이 아닙니다. 켜 둔 플러그인의 이름과 설명이 모든 턴에 실리고, 훅과 MCP 서버가 모든 세션에서 돕니다.

고르는 기준과 보는 습관은 다른 일입니다. 315개 중 5개만 골랐는데 87%가 안 쓰는 것이었습니다. 깔 때의 판단이 깐 뒤에도 맞는지는 재 봐야 압니다.

범위가 플러그인을 정합니다. 한 레포를 위한 플러그인을 사용자 범위로 깔면 모든 레포에서 돕니다. 로컬 범위가 있는 이유입니다.

재는 명령이 이미 있습니다. claude plugin details 한 줄이면 됩니다. 저희는 반년 동안 치지 않았습니다.


측정 명령은 누구나 자기 머신에서 돌릴 수 있습니다. 호출 수는 세션 기록이 있는 머신에서만 셀 수 있습니다.

# 깔아 둔 플러그인과 범위
claude plugin list
# 플러그인 하나의 매 턴 비용 — Always-on 줄
claude plugin details superpowers@claude-plugins-official
# 기록이 남은 세션에서 스킬 호출 수 — <프로젝트> 는 ~/.claude/projects/ 아래 폴더
cat ~/.claude/projects/<프로젝트>/*.jsonl | grep -o '"skill":"superpowers:[a-z-]*"' | wc -l
# 시작 훅이 넣은 블록 수 — 플러그인이 넣는 문구로 센다
cat ~/.claude/projects/<프로젝트>/*.jsonl | grep -o 'Vercel Plugin Session Context' | wc -l
# 공식 마켓플레이스 플러그인 수
node -e 'const j=require(process.env.HOME+"/.claude/plugins/marketplaces/claude-plugins-official/.claude-plugin/marketplace.json"); console.log(j.plugins.length)'

자주 묻는 질문

Q. claude code 플러그인 설치는 어떻게 하나요?

세션 안에서 한 줄입니다.

/plugin install superpowers@claude-plugins-official

이름 뒤의 @ 가 마켓플레이스입니다. 공식 마켓플레이스는 첫 세션에 자동으로 등록되고, 다른 마켓플레이스는 먼저 추가해야 합니다. 설치할 때 범위를 고르는 화면이 나오는데, 그 선택이 이 글의 주제입니다.

Q. claude code 마켓플레이스는 몇 개인가요?

저희 머신에는 넷입니다.

공식 마켓플레이스 하나와 외부 셋. 외부 셋은 각각 플러그인 하나씩을 위해 추가했습니다. 공식 마켓플레이스의 플러그인 수는 10월 5일 기준 315개였습니다.

Q. claude code hooks 는 플러그인마다 도나요?

켜 둔 플러그인의 훅은 전부 돕니다.

저희 일곱 개의 훅 이벤트가 열일곱 개입니다. 토큰은 안 쓰지만 세션 시작과 도구 호출마다 프로세스가 뜹니다. codex 플러그인의 Stop 훅이 그 예인데, 켜 두면 턴이 끝날 때마다 Codex 리뷰가 돌고 BLOCK 이면 턴이 끝나지 않습니다. 저희는 그 게이트를 넉 달 돌리고 리뷰 루프가 길어져서 꺼 두었습니다.

Q. 플러그인을 지우지 않고 끄려면?

셸에서 한 줄입니다.

claude plugin disable vercel@claude-plugins-official

범위가 여럿이면 가장 좁은 범위가 이깁니다. 로컬이 프로젝트를, 프로젝트가 사용자를 덮습니다. 한 레포에서만 끄고 싶으면 그 레포에서 로컬 범위로 끕니다.

참고 자료

  • Plugins overview 는 켜 둔 플러그인이 모든 세션의 일부라는 것, 더해지는 네 가지(컨텍스트, 프로세스, 권한, MCP), 범위 셋의 근거입니다.
  • Measure plugin cost and usage 는 claude plugin details 의 Always-on 이 무엇을 세는지, Not used recently 의 기준이 14일과 10세션이라는 것, /skill-doctor 와 /doctor 와 /usage 의 근거입니다.
  • Install and manage plugins 는 범위 셋이 어느 설정 파일에 쓰이는지, 좁은 범위가 넓은 범위를 덮는다는 것, claude plugin disable 의 근거입니다.
  • superpowers claude code 글 과 codex vs claude code 글 은 일을 한 두 플러그인이 무엇을 했는지의 기록입니다.

이 사이트의 수치는 주 1회 DB와 다시 대조하고, 판단이 바뀌면 지우지 않고 글 안에 덧붙입니다. 갱신은 RSS로 받을 수 있습니다.