Skip to main content

Command Palette

Search for a command to run...

Agent

エージェントへのプロンプト

チャット入力欄でテキストプロンプトを使ってエージェントに指示できます。コンテキスト、画像、音声を添付し、いつでもモデルを切り替えられます。

@メンション

チャット入力欄で @ を入力すると、特定のコンテキストをプロンプトに追加できます。@ の後に入力すると、Cursor が一致する候補を表示します。

  • ファイルとフォルダー: @auth.ts または @src/components/ でファイルやフォルダーを追加します (フォルダーを選択後、/ を入力するとさらに下の階層に移動できます)
  • ターミナル: @Terminals でターミナル出力をコンテキストに追加します
  • チャット: @Chats で以前の会話のコンテキストを参照します
  • Git の差分: 未コミットの変更には @Commit (Diff of Working State)、ブランチ全体の差分には @Branch (Diff with Main) を使用します
  • ブラウザ: @Browser で組み込みブラウザのコンテキストを追加します

関連するファイルがわかっている場合は、@メンションを使用します。どのファイルが重要かわからない場合は、使わないでください。エージェントが独自に検索して関連ファイルを見つけます。

カスタムモード

チャット入力欄で / を入力して、スキルを呼び出します。Enter を押すとスキルが1つのメッセージに適用され、会話が進むにつれて効果が薄れます。エージェントの作業中もスキルに集中させ続けるには、任意のスキルをカスタムモードとして使用します。

代わりに / メニューからスキルを選択し、Mac では Option+EnterAlt+Enter、Windows では Alt+Enter を押します。スキル項目から モードとして使用 を選択することもできます。モード内では、モードを終了するまで、エージェントが何時間作業していても、スキルは毎ターンコンテキストに保持されます。

カスタムモードは、1回限りのタスクではなく、作業方法を説明するスキルに適しています。複数のファイルを確認する間、コードレビューのチェックリストを有効にしておいたり、/tdd のようなチームのプレイブックを機能全体で有効にしておいたりできます。

カスタムモードは、Agents Window と CLI で利用できます。有効なフロントマターブロックを持つスキルはどれでもモードの基盤として使用でき、任意の icon および color フロントマターフィールドでモードのバッジのスタイルを設定できます。スキルをカスタムモードとして使用するを参照してください。

画像入力

プロンプトに画像を添付すると、UI作業、デバッグ、デザイン実装に必要な視覚情報を提供できます。

  • 画像ファイルをチャット入力欄にドラッグ＆ドロップ
  • スクリーンショットを含め、Cmd+VCtrl+Vでクリップボードから貼り付け

デザインモックアップの実装、視覚的な問題のデバッグ、エラーメッセージやスタックトレースの参照を手入力なしで行う際に役立ちます。

音声入力

チャット入力欄のマイクアイコンをクリックすると、入力する代わりにプロンプトを音声で入力できます。自然に話し、ファイル名や関数名などの技術的な詳細も含めて、送信前に文字起こしを確認してください。

コンテキストの利用

各チャットは、モデルの固定されたコンテキストウィンドウを使用します。ファイルを追加し、ツールを実行し、メッセージをやり取りすると、トークンが蓄積されていきます。ウィンドウがほぼ埋まると、Cursor は会話の古い部分を要約に圧縮し、新しい会話のための空き容量を確保します。

プロンプト入力欄の横にあるコンテキストリングで、ウィンドウの使用状況を一目で確認できます。リングをクリックすると内訳トレイが開き、使用中のトークン総数がカテゴリ別に表示されます。

  • システムプロンプト: モデルに対する Cursor の組み込み指示
  • ツール: エージェントが利用できるすべてのツールの定義
  • ルール: プロンプトに含まれるプロジェクトルールとユーザールール
  • スキル: システムコンテキストに挿入されるスキルの説明
  • MCP: 接続済みの MCP サーバーからの指示とカタログ
  • サブエージェント: エージェントが起動できるサブエージェントタイプのドキュメント
  • 要約された会話: 以前のターンを圧縮した要約
  • 会話: あなたのメッセージ、エージェントの応答、ツールの結果

バーのセグメントまたはリストの行にカーソルを合わせると、そのカテゴリが強調表示されます。

モデルの変更

チャット入力欄上部のモデルピッカーのドロップダウンでモデルを切り替えるか、Cmd /Ctrl / を押してモデルを順番に切り替えます。変更は以降、現在の会話に適用されます。デフォルトモデルは Cursor の設定 > モデル で設定します。

  • 高速なモデルは、簡単な編集や定型的なタスクに適しています
  • より高性能なモデルは、複雑な推論や複数ファイルにまたがるリファクタリングに適しています

会話の途中でモデルを切り替えることもできます。たとえば、高速なモデルで調査を行った後、実装にはより深い推論が必要になる場合です。完全な一覧はモデルと料金を参照してください。