Cursor .mdc導入 — 不要なトークンを70%削減するエージェント設定術

最近、CursorやClaude CodeのようなAIコーディングツールを使う開発者の間で最もホットな話題は「トークン税」です。どんなに簡単な質問を1つ投げただけでも、エージェントが動くたびに数万トークンが瞬時に消費されてしまうからです。今やプロジェクト全体を重く圧迫する単一設定ファイルの代わりに、フォルダーごとに必要なルールだけをピンポイントで有効化する「.mdc」ファイルベースのスマートな最適化が主流になりつつあります。

なぜ質問1回で28,000トークンも飛んでいくのか？

Cursorやターミナル環境のClaude Codeといったコーディングエージェントを使う際、軽い会話を数回しただけでAPIコストが急激に積み上がる経験をしたことがあるはずです。なぜでしょうか？エージェントが動作するたびにユーザーの質問だけでなく、システムプロンプト全体、利用可能なツール一覧、接続されたサーバー設定などを毎回まとめてモデルに送信しているからです。

実際に分析してみると、コード修正を一切行わず質問を1つ投げただけでも、基本税のように約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
}

設定項目を見てみると、大きく分けて3つのマッチングパターンを提供していることがわかります。

このように必要な瞬間にだけ必要なルールを動的に注入することで、エージェントが不要な背景情報に悩まされる「情報過多」現象を防ぎ、推論の精度も同時に向上させることができます。

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で実証されたコスト削減効果

理論だけでなく、オープンソースコミュニティには、エージェントの無駄な支出を抑制する具体的な設定テンプレートが登場しています。その代表的なツールが、GitHubで大きな注目を集めているオープンソースユーティリティの Minimize-Cursor-Cost です。

このツールは、エージェントの悪癖を矯正するドロップイン・ルールファイルを提供します。実際に複雑なリポジトリ作業を行う際のAIのコスト分布を分析すると、全体のトークン料金の96%以上が、不必要なファイルの全読み込みのような「入力トークン」から発生しています。肝心のコードを完成させる「出力トークン」の割合は1%未満にすぎません。結局、入力されるコンテキストを減らすことこそがコスト最適化の唯一の解法です。

Minimize-Cursor-Costに含まれる効率化ルールファイルは、エージェントに次のような厳しい行動綱領を強制します。

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

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

このようにしっかり構成されたルールを1つ加えるだけでも、エージェントはコード全体を退屈に再出力せず、変更された部分だけをピンポイントで生成するようになります。不必要なファイルアクセスを遮断し検索を強制することで、全体のトークン消費量が50%以上減少するという驚きの削減効果が実戦で証明されています。

今すぐコーディングエージェントのダイエットを始めよう

もう重い単一設定ファイルのせいでコストに悩む必要はありません。今すぐプロジェクトルートの重い設定ファイルを、機能やドメインごとのフォルダー内にある .mdc ファイルに整理してみてください。

Cursorとターミナル環境のClaude Codeの双方で動作するこの軽量なハイブリッド設計は、エージェントの不要なコンテキスト浪費を減らし、APIコストを劇的に引き下げます。より速く、より機敏に反応しながらも財布を痛めない、スマートな開発ループをぜひ体験してみてください。