클로드 코드 플러그인 토큰 비용 — 상시 비용 재기와 안 쓰는 플러그인 찾기

플러그인을 켜 두기만 해도, 그 안의 스킬과 에이전트와 명령의 이름과 설명이 모든 세션에 실립니다. 쓰든 안 쓰든 내 사용량에서 빠지는 몫입니다. 이제 그 숫자를 플러그인별로 직접 잴 수 있습니다.

클로드 코드의 플러그인 문서가 개편되면서 비용과 사용량 측정만 다루는 쪽이 새로 생겼습니다. 한 달 전 변경 기록에서 설치 전에 예상 차지량이 보이기 시작했다는 소식을 전했는데, 이번 문서는 그 숫자가 무엇으로 이뤄지는지, 누구에게 보이고 누구에게 안 보이는지, 줄이려면 어디를 손대야 하는지를 구체적으로 적었습니다. 문서의 주 독자는 플러그인을 만드는 쪽이지만, 쓰는 쪽에게도 쓸모 있는 대목이 절반쯤 됩니다.

짧게 정리하면

• 플러그인 상세 보기 명령을 셸에서 돌리면 매 세션 붙는 상시 비용과, 스킬이나 에이전트가 실제로 불릴 때마다 드는 호출 비용이 따로 나옵니다.
• 상시 비용은 이름과 설명 문구로 정해지므로 설명을 줄이거나 플러그인을 쪼개면 내려가지만, 설명이 짧아지면 스킬이 안 불릴 수 있습니다.
• 클로드 코드는 플러그인 사용 여부를 만든 사람에게 알려 주지 않으며, 사용자는 자기 컴퓨터의 네 곳에서 안 쓰는 플러그인을 확인할 수 있습니다.

클로드 코드 공식 문서의 플러그인 비용과 사용량 측정 쪽을 처음부터 끝까지 대조했습니다. 문서의 토큰 숫자는 예시 플러그인의 값이라 그대로 옮기지 않고 구조만 설명했습니다.

상시 비용과 호출 비용

재는 방법은 플러그인 상세 보기 명령 하나입니다. 세션 안의 입력창이 아니라 셸에서 돌려야 하고, 플러그인이 불러올 수 있는 상태여야 합니다. 설치돼 있거나, 스킬 폴더에 있거나, 같은 명령에 플러그인 폴더를 지정해 넘긴 경우입니다. 만드는 중인 플러그인도 폴더를 지정하면 깔지 않고 잴 수 있습니다.

출력은 세 덩어리로 나옵니다. 먼저 구성 목록이 나오고, 이어서 예상 토큰 비용 한 줄, 마지막으로 구성 요소별 표가 나옵니다. 사용자 명령은 스킬과 함께 세기 때문에 스킬 칸에 들어갑니다.

공식 문서 기준, 상세 보기 명령이 보여 주는 비용의 종류

항목	무엇을 세나	언제 내나
상시 비용	스킬·에이전트·명령의 이름과 설명, 언제 쓸지 적은 문구	플러그인이 켜진 모든 세션, 아무것도 안 불려도
호출 비용	그 구성 요소의 본문	스킬이나 에이전트가 실제로 불릴 때마다
훅	모델 맥락에 안 들어감	토큰 비용 없음으로 표시
도구 서버	도구 정의는 실행 중에 정해짐	상세 보기에서는 안 셈, 세션 안 맥락 명령으로 확인

문서가 줄여야 할 숫자로 꼽는 건 첫 줄, 상시 비용입니다. 그 플러그인을 켠 사람 모두가 매 세션 지고 다니는 몫이기 때문입니다. 호출 비용은 쓸 때만 내니 쓴 만큼의 값이라고 볼 수 있습니다. 넷째 줄은 빈틈으로 알아 두면 좋습니다. 도구 서버가 딸린 플러그인은 상세 보기 숫자가 실제보다 작게 보이고, 서버가 주는 도구가 얼마나 차지하는지는 플러그인을 켠 세션에서 맥락 명령을 열어 해당 분류를 따로 읽어야 합니다. 표시되는 숫자는 모두 추정치이고 실제 사용량과 다를 수 있다고 출력에도 적혀 있습니다.

상시 비용을 줄이는 두 가지

플러그인을 만드는 쪽이라면 방법은 둘입니다. 스킬과 에이전트의 설명을 짧게 쓰는 것, 그리고 큰 플러그인을 나눠서 사용자가 필요한 부분만 깔게 하는 것입니다. 구성 요소별 표의 상시 비용 칸을 보면 어느 스킬이 가장 많이 차지하는지 바로 보이니, 그 줄부터 손대면 됩니다. 그냥 쓰기만 하는 쪽이라면 선택지는 끄거나 지우는 것뿐이라고 문서는 적고 있습니다.

설명을 줄이면 스킬이 안 불릴 수 있습니다. 스킬의 설명은 비용이기 전에 클로드가 요청과 맞춰 보는 기준이기도 합니다. 문서도 짧아진 설명 때문에 스킬이 발동하지 않을 수 있다고 경고하고, 설명을 다듬은 뒤에는 평가 묶음에 스킬 호출 여부를 보는 채점기를 넣어 확인하라고 안내합니다. 토큰 조금을 아끼려다 정작 필요한 순간에 스킬이 안 뜨면 손해가 더 큽니다.

평가 명령을 한 번 붙여 두면 이 확인이 어렵지 않습니다. 플러그인 평가 명령의 채점기와 기준선 대조를 정리한 글에 설정 방법이 있으니, 설명을 고친 전후로 같은 평가를 돌려 호출률이 떨어지지 않았는지 보시면 됩니다.

사용자에게 보이는 쪽도 알아 둘 만합니다. 공식 마켓플레이스의 플러그인은 설치 전 상세 창에 맥락 비용 항목이 뜨고, 매 턴에 드는 몫과 호출될 때 드는 몫이 한 줄씩 나옵니다. 상시 비용이 2,000토큰 이상이면 매 턴 줄이 강조 표시됩니다. 반면 내가 만든 마켓플레이스의 플러그인에는 이 항목이 아예 없습니다. 사내 마켓플레이스로 배포한다면 사용자는 설치 전에 비용을 볼 수 없으니, 상세 보기 숫자를 설명 문서에 직접 적어 두는 편이 친절하겠습니다.

안 쓰는 플러그인은 어디서 보이나

문서가 먼저 못 박는 사실이 있습니다. 클로드 코드는 플러그인 사용 여부를 만든 사람에게 보고하지 않습니다. 사용 기록은 설치한 사람 각자의 컴퓨터에 남습니다. 그래서 만든 사람이 알 수 있는 범위는 사용자와의 관계에 달려 있습니다. 조직의 관리자라면 전사 측정을 할 수 있고, 물어볼 수 있는 동료라면 각자 확인해 달라고 하면 되고, 둘 다 아니라면 클로드 코드로는 알 방법이 없습니다.

사용자가 자기 컴퓨터에서 확인할 수 있는 네 곳

어디서	무엇이 보이나
플러그인 관리 창의 설치됨 탭	마켓플레이스에서 깐 플러그인이 14일 이상, 그리고 10세션 이상 안 쓰이면 「최근 사용 안 함」 아래로 이동, 상세에 마지막 사용일
스킬 진단 명령	스킬별 비용과 사용 빈도, 목록에는 있는데 한 번도 안 불린 스킬 표시
진단 명령	사용자가 깐 스킬·서버·플러그인 중 안 쓴 것을 끄라고 권함
사용량 명령	최근 사용량을 스킬·하위 에이전트·플러그인·서버별 비율로 표시, 프로·맥스·팀·엔터프라이즈 요금제

첫 줄은 조건이 둘 다 맞아야 합니다. 14일이 지나도 그 사이 세션을 열 번 열지 않았다면 아직 안 옮겨집니다. 그리고 이 표시가 아예 뜨지 않는 경우가 있습니다. 플러그인 폴더를 지정해 불렀거나 스킬 폴더에서 읽힌 플러그인, 관리 설정으로 켜졌거나 미리 채워 둔 폴더에서 올라온 플러그인, 그리고 테마·출력 스타일·감시·작업 흐름이 든 플러그인입니다. 마지막 경우는 호출로 셀 수 없이 늘 쓰이고 있는 것이라서입니다. 언어 서버 플러그인은 진단 결과를 주거나 코드 이동 요청에 답하면 쓴 것으로 칩니다. 조직이 설치 가능한 마켓플레이스를 엄격하게 묶어 두면 이 표시와 마지막 사용일 줄이 모두 사라집니다.

조직 전체에서 재기

관리자라면 두 경로가 있습니다. 하나는 클로드 코드가 우리 회사 수집 서버로 보내는 사용 기록 이벤트이고, 다른 하나는 앤트로픽 쪽 기록을 조회하는 분석 API입니다. 이벤트 쪽은 설치, 세션 시작 때 켜진 플러그인, 스킬 발동, 훅이 보고한 지표, 그리고 비용 집계기에 붙는 플러그인 이름으로 질문마다 답을 찾게 돼 있습니다. 훅 지표는 공식 마켓플레이스 플러그인의 훅에서만 나옵니다. 사용 기록으로 비용을 스킬·플러그인별로 쪼개는 방법은 예전 글에 정리해 뒀고, 이번 문서로 플러그인 쪽 질문과 이벤트의 짝이 분명해졌습니다.

이름이 가려지는 규칙도 이어집니다. 공식 마켓플레이스가 아닌 플러그인은 사내 마켓플레이스 것까지 포함해 기본으로 이름이 가려지거나 빠지고, 어느 쪽인지는 마켓플레이스의 신뢰 등급이 정합니다. 도구 세부 정보를 기록하는 환경 변수를 켜면 실제 이름이 나오는데, 비용 집계기에서는 플러그인 이름만 살아나고 마켓플레이스 이름은 여전히 빠집니다. 세션 시작 이벤트에는 플러그인마다 식별용 해시 값이 기본으로 붙어서, 이름을 몰라도 서로 다른 제3자 플러그인이 몇 개인지는 셀 수 있습니다. 분석 API는 엔터프라이즈 요금제에서 수집 서버 없이 쓸 수 있고, 플러그인별·날짜별 설치와 호출 횟수를 클로드 코드와 코워크를 합쳐 돌려줍니다. 분석 조회 권한이 있는 키가 필요하고, 그 키는 최고 소유자가 만듭니다.

상시 비용을 줄인 새 판을 올렸는데 사내 사용자가 계속 옛 판을 쓴다면 갱신 쪽을 확인해 보세요. 비공개 마켓플레이스의 백그라운드 자동 갱신은 인증을 묻지 못하는 환경에서 조용히 실패하고, 기존 사본을 그대로 둡니다. 비공개 마켓플레이스의 깃 인증과 갱신 실패 조건을 정리했으니, 배포한 개선이 사용자에게 닿는지 함께 보세요.

자주 묻는 질문

훅만 있는 플러그인도 토큰을 먹나요

상세 보기 명령은 훅을 모델 맥락 비용이 없는 항목으로 표시합니다. 다만 훅이 무엇을 실행하는지는 비용과 별개로 따져 봐야 합니다.

사내 마켓플레이스 플러그인은 설치 전에 비용이 안 보입니다

맞습니다. 설치 전 맥락 비용 항목은 공식 마켓플레이스 플러그인에만 나옵니다. 설치한 뒤라면 상세 보기 명령으로 직접 잴 수 있습니다.

한 달 안 썼는데 「최근 사용 안 함」에 안 뜹니다

그 기간에 세션을 열 번 이상 열었는지, 관리 설정으로 켜진 플러그인은 아닌지, 테마나 출력 스타일이 든 플러그인은 아닌지 확인해 보세요. 이런 경우는 표시 대상에서 빠집니다.

내 플러그인을 몇 명이 쓰는지 알 수 있나요

클로드 코드는 만든 사람에게 사용 여부를 보고하지 않습니다. 사용자 조직의 관리자이거나, 사용자에게 직접 물어볼 수 있는 경우가 아니면 클로드 코드 쪽에서 얻을 신호는 없습니다.

이 문서를 읽으면 플러그인의 설명 한 줄이 두 가지 값을 동시에 지고 있다는 게 보입니다. 모든 사용자가 매 세션 내는 토큰이면서, 클로드가 그 스킬을 떠올리는 유일한 단서이기도 합니다. 그래서 설명을 줄이는 일은 비용을 깎는 작업이 아니라 호출률과 맞바꾸는 작업에 가깝습니다. 쓰는 쪽이라면 한 달에 한 번쯤 플러그인 관리 창의 「최근 사용 안 함」과 사용량 명령의 비율을 같이 보고, 둘 다에서 존재감이 없는 플러그인부터 꺼 두는 정도면 충분해 보입니다.

확인한 곳: 클로드 코드 공식 문서의 플러그인 비용과 사용량 측정(비용 재기, 상시 비용 줄이기, 설치 전 비용 표시, 사용 여부 확인, 조직 전체 측정, 가려진 이름, 분석 API). 2026년 9월 27일 기준이며 표시 조건과 요금제 범위는 판에 따라 바뀔 수 있습니다.