メインコンテンツまでスキップ

Cursor Composer 2.5 でのトークン使用量の制御

Cursor Composer Token Control

Cursor Composer 2.5 は前身よりも大幅に高機能ですが、トークン消費量も増えています。限定プランのユーザーやコストを最適化したいユーザーにとって、トークン使用量を制御する方法を理解することは不可欠です。このガイドでは、生産性を犠牲にすることなくトークン消費を削減する実用的な戦略をカバーします。

Composer 2.5 のトークン仕組みを理解する​

トークンのカウント方法​

Composer 2.5 は、会話を通じて蓄積されるコンテキストウィンドウを使用します：

  • 入力トークン：プロンプト + ファイルコンテキスト + 会話履歴
  • 出力トークン：AI 生成のコードと応答
  • キャッシュトークン：以前送信されたコンテキストで、割引が適用される

Fast モードと Regular モード​

モード速度トークンコスト最適な用途
Fast即時トークンあたり高い迅速な反復、小さな変更
Regular遅いトークンあたり低い大規模なリファクタリング、複雑なタスク

戦略 1：新しい会話を開始する​

トークンを制御する最も効果的な方法は、長い会話チェーンを避けることです。

新しいチャットを開始するタイミング​

以下の場合に新しい Composer セッションを開始します：

  • 論理的なタスク単位が完了したとき
  • 会話が 20-30 回のやり取りを超えたとき
  • 応答が遅くなっていることに気づいたとき
  • 完全に異なる機能に切り替えるとき

コンテキストを保持する方法​

新しく始める前に、重要なコンテキストを保存します：

<!-- docs/composer-context.md として保存 -->
## 現在のタスクコンテキスト
- 作業中：ユーザー認証モジュール
- 重要なファイル：src/auth/login.ts, src/auth/register.ts
- 決定事項：JWT とリフレッシュトークンを使用
- 次のステップ：パスワードリセットの実装

次に、新しいチャットでこのファイルを参照します：

docs/composer-context.md を読み込んで、パスワードリセット機能の実装を続けてください。

戦略 2：重いタスクには Regular モードを使用する​

大規模な操作には、Regular モードに切り替えます：

  1. Composer を開く（Cmd/Ctrl + I）
  2. モデルセレクターをクリック（右上）
  3. "Fast" の代わりに "Regular" を選択
  4. 変更を適用

Regular モードを使用するタイミング：

  • 初期プロジェクトのスキャフォールディング
  • 大規模なリファクタリング操作
  • 複数ファイルのアーキテクチャ変更
  • 複雑なデバッグセッション

戦略 3：ファイルコンテキストを最小化する​

Composer は自動的に開いているファイルをコンテキストに含めます。これを積極的に管理します：

無関係なファイルを閉じる​

Composer タスクを開始する前に：

1. すべてのタブを閉じる（Cmd/Ctrl + K、次に W）
2. タスクに関連するファイルのみを開く
3. Composer を起動

@ 参照を選択的に使用する​

次の代わりに：

@codebase ユーザー認証を実装する

次を使用します：

@src/auth/login.ts @src/auth/register.ts これらのファイルの既存のパターンに従ってユーザー認証を実装する。

戦略 4：キャッシュトークンを理解する​

Cursor は、繰り返し操作のコストを削減するためにコンテキストをキャッシュします：

キャッシュの仕組み​

  • 最初のリクエスト：完全なコンテキストが送信される（最も高いコスト）
  • 同じセッションでのフォローアップ：新しいコンテンツのみが送信される（割引適用）
  • 新しいセッション：完全なコンテキストが再度送信される

キャッシュヒットを最適化する​

関連するタスクを同じセッションに保持します：

// 良い：1 つのセッションでの関連タスク
"ログインフォームコンポーネントを作成する"
"ログインコンポーネントにフォーム検証を追加する"
"Tailwind でログインフォームにスタイルを適用する"

// 効率が低い：それぞれ別のセッション

戦略 5：ターゲットを絞ったプロンプトを使用する​

曖昧なプロンプトは、不必要な探索にトークンを浪費します：

非効率なプロンプト​

認証システムを修正する

効率的なプロンプト​

src/auth/login.ts で、validatePassword 関数が空の文字列に対して true を返します。空/空白のみのパスワードのチェックを追加し、false とエラーメッセージ "Password is required" を返してください。

トークン使用量の監視​

Cursor 設定で使用量を確認する​

  1. Cursor 設定を開く（Cmd/Ctrl + ,）
  2. "Usage" または "Account" に移動
  3. 現在の期間のトークン消費を確認

メンタルバジェットを設定する​

タスクタイプ推奨トークンバジェット
小さなバグ修正2K-5K トークン
機能実装10K-30K トークン
大規模なリファクタリング50K+ トークン
初期プロジェクトセットアップ100K+ トークン

高度な設定：カスタムトークン制限​

Cursor はネイティブのトークン制限を提供していませんが、独自のワークフローを実装できます：

タスクタイマーの使用​

Composer セッションに 15 分のタイマーを設定します。タイマーが鳴ったら：

  1. タスクが完了したかどうかを評価する
  2. 完了していない場合、決定する：続行するか、新しく始めるか？
  3. 続行する前に進捗を記録する

「チェックポイント」方式​

重要な Composer 出力のたびに：

  1. 変更をレビューする
  2. 問題なければコミットする（git add -A && git commit -m "checkpoint"）
  3. これにより、進捗を失うことなく新しく始めることができる

クイックリファレンス：トークン節約チェックリスト​

  • 新しいタスクには新しいチャットを開始する
  • Composer を使用する前に無関係なファイルを閉じる
  • 大規模な操作には Regular モードを使用する
  • 具体的で詳細なプロンプトを書く
  • 可能な場合は @codebase の代わりに @ でファイルを参照する
  • 関連するタスクを同じセッションにグループ化する
  • 頻繁に進捗をコミットする
  • 設定で使用量を監視する

関連リソース​