Cursor チートシート

基本操作

Agent起動

Cmd+I (Mac) / Ctrl+I (Windows)

インライン編集でコードを生成・修正

Agentチャット

Cmd+L (Mac) / Ctrl+L (Windows)

サイドバーでAgentと会話

Plan Mode切り替え

Shift+Tab

大規模変更の計画を立てる

モデル切り替え

Cmd+/ (Mac) / Ctrl+/ (Windows)

使用するモデルを素早く変更

---

@メンション（コンテキスト追加）

@ファイル名

@src/utils.ts

特定ファイルをコンテキストに追加

@フォルダ名

@src/components/

フォルダ全体をコンテキストに含める

@Docs

@Docs Next.js routing

外部ドキュメントを参照

@Past Chats

@Past Chats

過去の会話履歴を参照

@Code

@Code

現在のファイルやカーソル位置のコードを含める

---

Plan Mode（大規模変更）

使うべき場面

• 複数ファイルにまたがる変更
• アーキテクチャレベルの判断が必要
• 要件が曖昧で探索が必要

基本フロー

1. Shift+TabでPlan Mode起動
2. 要件を伝える
3. Agentが質問→回答
4. プラン作成→レビュー
5. 承認して実行

---

Debug Mode（バグ修正）

起動方法

モードピッカーから「Debug」を選択

使うべき場面

• 再現できるが原因不明のバグ
• レースコンディション
• パフォーマンス問題

プロセス

1. バグの症状を詳しく説明
2. Agentが仮説を立てる
3. ログコードを追加
4. バグを再現
5. ログ分析→修正

---

ルール（永続的な指示）

プロジェクトルール作成

/create-rule

チャットからルールを作成

ルールの種類

• Always Apply: すべてのセッションに適用
• Apply Intelligently: 関連時のみ適用
• Apply to Specific Files: glob パターンで指定
• Apply Manually: @メンションで手動適用

ルールの配置場所

.cursor/rules/

プロジェクト単位のルール

~/.cursor/

ユーザー単位のグローバルルール

AGENTS.md

# プロジェクトルートに配置
AGENTS.md

シンプルな指示ファイル（メタデータ不要）

---

チームルール（Team Rules）

適用優先順位

Team Rules → Project Rules → User Rules

強制ルール

管理者が「このルールを強制する」をONにすると、メンバーは無効化不可

Glob パターン例

**/*.py        # すべてのPythonファイル
src/**/*.ts    # srcディレクトリ内のTypeScriptファイル

---

Subagents（専門エージェント）

作成場所

.cursor/agents/debugger.md

プロジェクト単位

~/.cursor/agents/

ユーザー単位

ファイル形式

---
name: debugger
description: Debugging specialist for errors and test failures
---
[プロンプト内容]

よくあるSubagents

• debugger: バグ分析専門
• test-runner: テスト実行と修正
• security-reviewer: セキュリティチェック
• documentation: ドキュメント生成

---

Terminalツール

コマンド実行

Agentが自動的にターミナルコマンドを実行

• テスト実行
• ビルド
• 依存関係インストール

セキュリティ

リスクのあるコマンドは承認が必要

---

Browserツール

Web検索

Agentが自動的にWeb検索を実行して情報収集

Webページ閲覧

特定URLの内容を取得してコンテキストに追加

---

Parallel Agents（並列実行）

使い方

複数のタスクを同時に進める指示を出す

例：

次の3つのタスクを並列で実行してください：
1. ユーザー認証機能の実装
2. データベーススキーマの更新
3. APIエンドポイントの追加

---

Cloud Agents（クラウド実行）

起動方法（Slack）

@cursor [指示内容]

起動方法（Linear）

課題に@Cursorをメンションまたは課題を割り当て

設定構文（Linear）

[model=claude-sonnet-4-6]
[rules=@security-rules]

---

Cursor CLI

インストール

# ダウンロードしてインストール
curl -fsSL https://cli.cursor.com/install.sh | sh

ログイン

agent login

Agent起動

agent "コードをリファクタリングして"

Shell Mode

agent shell "すべてのPythonファイルを検索"

自然言語からシェルコマンドを生成

Plan Mode

agent --plan "認証機能を追加"

ACP（外部ツール連携）

agent acp

JSON-RPC 2.0経由でstdio通信

---

モデル選択ガイド

Claude Opus 4.6

• 最高品質
• 複雑な推論が必要なタスク
• コスト高め

Claude Sonnet 4.6

• バランス型（推奨）
• 日常的な開発タスク
• コストパフォーマンス良好

Claude Haiku 4.5

• 高速・低コスト
• シンプルなタスク
• 大量のリクエスト処理

GPT-4o

• マルチモーダル（画像入力可能）
• 外部ツール連携が強い

o1

• 深い推論タスク
• 数学・論理パズル
• アルゴリズム設計

---

料金プラン比較

Pro（$20/月）

• Auto + Composer: 500リクエスト/月
• API: $10のクレジット/月

Pro Plus（$60/月）

• Auto + Composer: 無制限（低速モード）
• API: $25のクレジット/月

Ultra（$200/月）

• Auto + Composer: 無制限（高速）
• API: $100のクレジット/月

Teams（$40/ユーザー/月）

• チーム管理機能
• Team Rules
• SSO対応

---

トラブルシューティング

Agentが期待通りに動かない

1. コンテキストに必要なファイルが含まれているか確認（@メンション）
2. 指示が具体的か確認
3. モデルを変更してみる
4. Rules が矛盾していないか確認

コマンドが実行されない

1. 権限設定を確認
2. サンドボックス設定を確認
3. 明示的に承認する

ルールが適用されない

1. ルールが有効化されているか確認
2. glob パターンが正しいか確認
3. 優先順位を確認（Team → Project → User）

---

ベストプラクティス

効果的なプロンプト

• 具体的に指示する
• 期待する結果を明確にする
• 制約条件を伝える
• 例を示す

コンテキスト管理

• 必要なファイルだけを@メンションで追加
• 不要なコンテキストは削減
• 長い会話は新しいセッションで開始

チーム運用

• Team Rules でコーディング標準を統一
• Subagents をリポジトリで共有
• 定期的にルールを見直す
• Analytics でチームの利用状況を把握

---

ショートカット一覧

操作	Mac	Windows
Agent（インライン）	Cmd+I	Ctrl+I
Agentチャット	Cmd+L	Ctrl+L
モデル切り替え	Cmd+/	Ctrl+/
Plan Mode	Shift+Tab	Shift+Tab
コマンドパレット	Cmd+Shift+P	Ctrl+Shift+P

---

参考リンク

• 公式ドキュメント: https://docs.cursor.com/
• 公式サイト: https://www.cursor.com/
• チーム管理: https://www.cursor.com/settings