Claude Code의 MCP 및 스킬 라이브러리 토큰 비용 최적화 가이드

커뮤니티 반응

사용자들은 새로운 토크나이저 도입 이후 체감되는 비용 상승에 공감하며, 제시된 문서 분할 전략이 실질적인 토큰 절약(10k+ 이상)에 도움이 된다는 반응을 보였다.

주요 논점

01찬성다수

시스템 리마인더를 분할하여 claude.md에서 포인터로 관리하는 것이 비용 효율성과 일관성 측면에서 가장 우수하다.

02중립소수

개별 문서를 별도의 스킬로 만드는 것도 가능하지만, 시스템 리마인더 부채가 누적될 위험이 있어 주의해야 한다.

합의점 vs 논쟁점

합의점

새로운 토크나이저와 시스템 리마인더 구조로 인해 이전보다 토큰 비용이 상승했다.
claude.md는 시스템 내에서 가장 권위 있는 설정 파일로 작동하며 일관성 유지에 핵심적이다.

논쟁점

개별 문서를 독립된 스킬로 분리하는 것이 관리 효율성 면에서 나은지, 아니면 토큰 부채 면에서 불리한지에 대한 선택의 문제.

실용적 조언

시스템 리마인더 내용을 작은 .md 파일들로 쪼개고 claude.md에 '이 MCP를 쓸 때는 해당 .md를 읽으라'는 지침을 추가하여 토큰을 절약하라.
새로운 토크나이저 적용 이후 훅(Hooks) 비용이 얼마나 부풀려졌는지 확인하고 불필요한 컨텍스트를 제거하라.

섹션별 상세

대규모 MCP나 스킬 라이브러리를 보유한 경우 시스템 리마인더가 컨텍스트를 대량으로 점유하여 비용이 급증한다. 시스템 리마인더는 MCP와 스킬에 대한 정보를 컨텍스트에 덤프하는 방식으로 작동하며, 특정 업데이트 이후 비용이 이전 대비 최대 2배까지 상승할 수 있다. 특히 새로운 토크나이저 적용으로 인해 훅(Hooks)의 비용도 함께 증가했으므로 사용자는 자신의 토큰 사용량을 점검해야 한다.

시스템 리마인더의 컨텍스트 부하를 줄이기 위해 대형 문서를 작은 .md 파일로 분할하고 claude.md에서 포인터로 연결하는 방식을 권장한다. 모든 정보를 한 번에 주입하는 대신 특정 MCP 서버를 사용할 때만 해당 .md 파일을 읽도록 지시하는 문구를 claude.md에 추가하여 작동 효율을 높인다. 이 방식은 컨텍스트 윈도우를 절약하면서도 모델이 필요한 정보에 접근할 수 있는 경로를 유지한다.

주요 스킬의 경우 리소스 폴더 내에 .md 문서를 배치하거나 skill.md 자체에 포인터를 추가하는 대안이 존재한다. 다만 claude.md가 대부분의 상황에서 더 높은 권위를 가지며 일관된 성능을 제공하므로 이를 중심점으로 활용하는 것이 유리하다. 개별 문서를 독립적인 스킬로 만드는 방법도 있으나, 이 경우 각 스킬이 고유의 시스템 리마인더 부채를 축적하게 되므로 주의가 필요하다.

용어 해설

모델 컨텍스트 프로토콜(MCP): — Anthropic에서 개발한 오픈 표준으로, AI 모델이 로컬 데이터 소스나 외부 도구와 안전하게 연결될 수 있도록 돕는 인터페이스 규격이다. 이를 통해 모델은 실시간 데이터나 특정 도구의 기능을 활용할 수 있게 된다.
시스템 리마인더(System Reminder): — AI 모델의 컨텍스트 윈도우 내에서 MCP나 특정 스킬에 대한 정보를 지속적으로 상기시키기 위해 주입되는 텍스트 데이터이다. 라이브러리가 커질수록 이 데이터가 차지하는 토큰 비중이 높아져 비용 상승의 원인이 된다.
토크나이저(Tokenizer): — 텍스트를 AI 모델이 이해할 수 있는 토큰 단위로 분할하는 도구이다. 새로운 토크나이저 적용 시 동일한 텍스트라도 더 많은 토큰으로 계산될 수 있어 API 호출 비용에 직접적인 영향을 미친다.

언급된 도구

Claude Code추천

Anthropic의 AI 코딩 에이전트 및 CLI 도구

MCP중립

모델 컨텍스트 프로토콜을 통한 외부 도구 및 데이터 연결