MCP 도구는 Claude Code의 입력 토큰 비용을 줄이는 것이 아니라 오히려 늘립니다. 클리닝 도구를 통해 보내는 모든 프롬프트는 결국 더 많은 토큰을 소모하며, 결과적으로 더 많은 비용이 발생합니다. API 비용 절감을 목표로 하는 개발자들은 MCP 기반 클리너가 모델이 프롬프트를 확인하기 전에 크기를 줄여줄 것이라고 가정하고 이를 사용하곤 합니다.
토큰 측정기가 중요한 이유
Claude Code는 텍스트가 모델의 컨텍스트 윈도우에 도달하는 즉시 토큰을 계산합니다. 모델은 원본 프롬프트를 먼저 읽은 다음, MCP 도구를 호출할지 여부를 결정합니다. 클리닝 도구는 원본 텍스트가 이미 대화의 일부가 된 후에 실행되므로, 측정기에는 이미 해당 토큰이 기록된 상태입니다.
일반적인 흐름은 다음과 같습니다:
- 원본 프롬프트가 제출됩니다 – 토큰 카운터가 올라갑니다.
- 모델이 프롬프트를 읽고 클리닝 도구를 호출하기로 결정합니다.
- 도구가 다듬어진 버전을 반환합니다.
- 이제 컨텍스트에는 세 가지 요소가 포함됩니다: 원본 프롬프트, 도구 호출 메타데이터, 그리고 클리닝된 프롬프트입니다.
이 세 가지 항목 모두에 대해 비용이 청구됩니다. "클린" 버전은 원본을 대체하는 것이 아니라, 단지 원본 옆에 나란히 놓일 뿐입니다.
MCP 클리닝이 도움이 되는 경우
MCP 도구는 원본 텍스트가 Claude Code의 메인 컨텍스트에 아예 들어가지 않을 때만 토큰을 절약할 수 있습니다. 이는 다음과 같은 다운스트림 호출의 경우에 해당합니다:
- 모델이 검색 엔진이나 데이터베이스로 전달하는 검색 증강 생성(RAG) 쿼리.
- 기본 대화와 독립적으로 작동하는 서브 에이전트(sub-agents)에게 전달되는 지침.
이러한 경우 모델은 클리닝된 페이로드를 외부 시스템으로 직접 전달하므로, 원본 사용자 텍스트가 기본 토큰 카운트에 포함되지 않습니다.
입력 토큰을 실제로 줄이는 방법
Claude Code에 전달되는 토큰 수를 줄이려면, 텍스트가 모델에 닿기 전에 클리닝해야 합니다. 현재 바로 적용 가능한 세 가지 실질적인 방법은 다음과 같습니다:
- 시스템 레벨 단축키 – Windows에서는 AutoHotkey 스크립트를, macOS에서는 Automator를 사용합니다. 스크립트가 전송하려는 텍스트를 선택하고, 이를 클리닝된 버전을 반환하는 외부 API로 전달(pipe)한 다음, 에디터의 텍스트를 교체합니다. 원본 버전이 기기를 벗어나지 않으므로, 클리닝된 버전만 제출됩니다.
- CLI 파이핑(piping) – 터미널에서 Claude Code를 실행하고, 불필요한 공백, 주석 또는 중복된 문구를 제거하는 bash 필터(예:
sed또는 Python 스크립트)를 사용하여 프롬프트를 사전 처리합니다. 필터링된 결과물이 모델에 전달됩니다. - 다운스트림 호출에만 MCP 사용 – MCP 도구는 앞서 설명한 RAG 또는 서브 에이전트 단계용으로 남겨두십시오. 모델이 초기 사용자 프롬프트를 직접 처리하게 하고, 클리닝 도구는 메인 대화를 벗어나는 페이로드에 대해서만 작동하도록 합니다.
피해야 할 일반적인 실수
- MCP 도구가 원본 프롬프트를 다듬어줄 것이라고 가정하는 것 – MCP 도구는 도구 호출 토큰 블록을 추가하고 원본 텍스트를 보존하므로, 전체 토큰 수가 늘어납니다.
- Claude Code 훅(hooks)에 의존하는 것 – 훅은 추가 컨텍스트를 주입하거나 프롬프트를 차단할 수는 있지만, 이미 대화에 포함된 텍스트를 덮어쓸 수는 없습니다.
- 인라인 클리닝이 포함된 슬래시 명령 사용 – 명령어가 클리닝 스크립트를 실행하더라도, 원본 인자(arguments)는 모델이 기록하는 커맨드 라인의 일부로 남기 때문에 이에 대해서도 비용을 지불해야 합니다.
토큰 측정은 문자가 모델의 API 엔드포인트에 도달하는 즉시 시작됩니다. 그 이후에 수행되는 모든 클리닝 작업은 오버헤드만 추가할 뿐입니다.
개발자에게 주는 시사점
토큰 가격은 대부분의 AI 서비스 청구서에 항목으로 나타납니다. "클리너"가 숨겨진 토큰을 추가하여 비용을 과다 지불하게 되면, 기대했던 비용 절감 효과가 빠르게 사라질 수 있습니다. 토큰 수를 정확하게 유지하고 예산을 예측 가능하게 만들려면 클리닝 단계를 클라이언트 측으로 옮기십시오.
핵심 요약: MCP 도구는 다운스트림 페이로드에는 유용하지만, 사용자가 입력하는 프롬프트의 토큰을 줄여주지는 못합니다. Claude Code의 토큰 비용을 진정으로 줄이고 싶다면, 전송하기 전에 클리닝하거나 클리닝 작업을 메인 컨텍스트에 나타나지 않는 호출로 제한하십시오.