Cursor .mdc 도입 — 쓸데없는 토큰 70% 줄이는 에이전트 설정법

최근 Cursor나 Claude Code 같은 AI 코딩 도구를 쓰는 개발자들 사이에서 가장 뜨거운 화두는 바로 '토큰 세금'입니다. 아무리 간단한 질문 하나만 던져도 에이전트가 한 번 움직일 때마다 수만 개의 토큰이 순식간에 녹아내리기 때문이죠. 이제는 프로젝트 전체를 무겁게 짓누르던 단일 설정 파일 대신, 폴더마다 필요한 규칙만 콕 집어 활성화하는 '.mdc' 파일 기반의 스마트한 최적화가 대세로 자리 잡고 있습니다.

왜 질문 한 번에 28,000토큰이 날아갈까?

Cursor나 터미널 환경의 Claude Code 같은 코딩 에이전트를 쓸 때, 가벼운 대화 몇 마디만 나눠도 API 비용이 순식간에 쌓이는 경험을 해보셨을 겁니다. 왜 그럴까요? 에이전트가 동작할 때마다 사용자의 질문만 보내는 것이 아니라 전체 시스템 프롬프트, 활용 가능한 도구 목록, 연결된 서버 설정 등을 매번 통째로 묶어서 모델에 전달하기 때문입니다.

실제로 분석해 보면 아무런 코드 수정 없이 질문 하나만 던져도 기본적으로 약 28,000개의 토큰이 기본 세금처럼 날아갑니다. 한 조사에 따르면 에이전트 작동 과정에서 발생하는 비용의 96% 이상이 코드를 직접 작성하는 출력이 아니라, 매번 이처럼 불필요하게 반복해서 읽어 들이는 입력 데이터에서 발생합니다.

이 엄청난 토큰 낭비를 부추기는 가장 큰 주범이 바로 프로젝트 전체의 코딩 규칙을 한데 모아둔 거대한 .cursorrules 파일입니다. 질문의 맥락과 상관없는 방대한 규칙들을 매번 무조건 읽어야 하니 비용은 비용대로 터지고, 에이전트의 컨텍스트 집중력도 흐트러질 수밖에 없습니다.

해결책은 폴더 단위 분할, .mdc 규칙 활용하기

이 무시무시한 '토큰 세금'을 해결하는 가장 똑똑한 방법이 바로 폴더와 파일 단위로 개발 규칙을 쪼개어 관리하는 .mdc 규칙 설정법입니다.

기존의 무거운 단일 .cursorrules 대신, .cursor/rules/ 디렉터리에 각 역할에 맞는 규칙을 여러 개의 파일로 나누어 담는 방식이죠. 개발자가 작성 중인 특정 파일에 맞게 필요한 규칙만 에이전트가 알아서 불러오도록 자동 라우팅 설정을 해두는 것입니다. 이렇게 컨텍스트를 분할 관리하면 매 질문마다 의무적으로 소모되던 약 28,000토큰의 베이스라인 낭비를 최소화하여, 전체 입력 토큰 소모량을 50%에서 최대 70%까지 획기적으로 줄일 수 있습니다.

이 방식은 커서(Cursor)뿐만 아니라 클로드 코드(Claude Code) 같은 터미널 환경의 코딩 에이전트에서도 필수적인 비용 최적화 표준으로 자리 잡고 있습니다. 실제 .mdc 파일에 들어가는 메타데이터 구성 방식은 다음과 같이 JSON 구조로 명확하게 표현할 수 있습니다.

{
  "description": "TypeScript API routes and fetch standards",
  "globs": "src/api/**/*.ts",
  "alwaysApply": false
}

설정 항목을 살펴보면 크게 세 가지 매칭 패턴을 제공하는 것을 알 수 있습니다.

이처럼 필요한 순간에만 필요한 규칙을 동적으로 주입하면 에이전트가 불필요한 배경지식 때문에 머리를 싸매는 '정보 과부하' 현상을 방지해 추론 정확도까지 동시에 올라가게 됩니다.

AGENTS.md와 MDC의 영리한 하이브리드 조합

그렇다면 이 규칙들을 어떻게 설계하는 것이 가장 영리할까요? 현재 개발자들 사이에서 가장 권장되는 설계는 프로젝트 루트의 AGENTS.md 파일과 개별 폴더 단위의 .mdc 규칙을 결합하는 하이브리드 구조입니다.

AGENTS.md는 여러 에이전트 도구가 공통으로 인식하는 열린 표준입니다. 여기에 프로젝트의 핵심 아키텍처나 코딩 철학처럼 항상 기억해야 할 가벼운 글로벌 원칙을 담아둡니다. 반면, 데이터베이스 스키마나 복잡한 테스트 규칙처럼 무거운 가이드는 특정 폴더가 열릴 때만 동작하는 .mdc 파일로 분리해 관리합니다.

예를 들어, 데이터베이스 작업을 할 때만 아래와 같이 구성된 .mdc 규칙이 동적으로 활성화되도록 가볍게 설정하는 것입니다.

---
description: 데이터베이스 스키마 변경 및 Prisma 쿼리 작성 규칙
globs: "src/db/**/*.ts"
alwaysApply: false
---

# 데이터베이스 규칙
- 모든 스키마 변경 시 src/db/schema.ts 파일을 먼저 참조할 것.
- raw query 사용을 금지하고 반드시 Prisma Client를 활용할 것.

이렇게 하면 평소에는 에이전트의 컨텍스트를 최대한 가볍게 유지하다가, 개발자가 데이터베이스 폴더 안의 코드를 수정할 때만 관련된 무거운 규칙이 자동으로 로드됩니다. 에이전트가 매번 불필요한 정보까지 머릿속에 얹고 대답할 필요가 없으니 추론 정확도는 올라가고, 소중한 토큰은 극적으로 아낄 수 있습니다.

Minimize-Cursor-Cost로 확인된 실전 비용 절감 효과

이론만 솔깃한 것이 아닙니다. 오픈소스 커뮤니티에는 이미 에이전트의 쓸데없는 지출을 틀어막는 구체적인 설정 템플릿들이 등장했습니다. 대표적인 도구가 바로 깃허브에서 큰 주목을 받고 있는 오픈소스 유틸리티인 Minimize-Cursor-Cost입니다.

이 도구는 에이전트의 나쁜 습관을 교정하는 드롭인 규칙 파일들을 제공합니다. 실제로 복잡한 레포지토리 작업을 수행할 때 AI의 비용 분포를 분석해 보면, 전체 토큰 요금의 96% 이상이 불필요한 파일 전체 읽기 같은 '입력 토큰'에서 발생합니다. 정작 코드를 완성하는 '출력 토큰' 비중은 1% 미만에 불과하죠. 결국 입력으로 들어가는 컨텍스트를 줄이는 것만이 비용 최적화의 유일한 해법입니다.

Minimize-Cursor-Cost에 포함된 효율성 규칙 파일은 에이전트에게 다음과 같은 엄격한 행동 강령을 강제합니다.

---
description: 코드를 수정하거나 작성할 때 에이전트의 토큰 낭비를 방지하는 규칙
globs: *
---

# 에이전트 효율성 극대화 규칙
- 코드 전체를 다시 쓰지 마세요. 오직 변경되는 부분만 'diff' 형식으로 생성해야 합니다.
- 한 번 읽은 파일을 반복해서 다시 읽지 마세요.
- 파일 내용을 전체 분석하기 전에, 항상 필요한 키워드를 먼저 검색(grep)하세요.
- 무의미한 도구 호출을 반복하며 스스로 생각하는 루프에 빠지지 마세요.

이렇게 잘 짜인 규칙 하나만 추가해도 에이전트는 코드 전체를 지루하게 다시 출력하지 않고 바뀐 부분만 콕 집어 가볍게 생성합니다. 불필요한 파일 접근을 차단하고 검색을 강제하면서 전체 토큰 소비량이 50% 이상 줄어드는 놀라운 절감 효과가 실전에서 증명되었습니다.

지금 바로 코딩 에이전트 다이어트 시작하기

더 이상 무거운 단일 설정 파일 때문에 비용 고통을 겪을 필요가 없습니다. 지금 바로 프로젝트 루트의 무거운 설정 파일들을 기능과 도메인별 폴더의 .mdc 파일로 깔끔하게 쪼개보세요.

Cursor와 터미널 환경의 Claude Code 모두에서 작동하는 이 가벼운 하이브리드 설계는 에이전트의 불필요한 컨텍스트 낭비를 줄이고 API 비용을 획기적으로 낮춰줍니다. 더 빠르고 기민하게 반응하면서도 지갑은 가벼워지지 않는 스마트한 개발 루프를 직접 경험해 보시기 바랍니다.