Cursor セットアップ — インストール・.cursorrules・MCP・Claude Codeとの分業

Cursor は AI を深く統合した VS Code フォークで、現在「エディタ内で AI を毎日のツールとして使う」への最速ルートだ。Claude Code と重複する部分もあるが、両者は補完的だ: Cursor は エディタ内のペアプログラマー、Claude Code は ターミナル側のエージェント。どちらかを選ぶのではなく、両者で作業を分担するのがポイントだ。

このガイドはmacOS/Linux/Windows共通だ: インストール → コア使用法 → .cursorrules → MCP → Claude Codeとの分業。

TL;DR

1. インストール: cursor.com → VS Codeの拡張機能/キーマップ/設定を自動インポート
2. モデル: Claude Sonnet/Opus · GPT-4.1 · Cursor Composer。デフォルト推奨: Claude Sonnet
3. 4つのショートカット: Tabオートコンプリート · ⌘Kインライン編集 · ⌘Lサイドチャット · ⌘I Composer
4. .cursorrules: 全呼び出しでsystem promptとして注入されるプロジェクトルール
5. Claude Codeとの分業: Cursor = 編集 + 即時フィードバック; Claude Code = 複数ファイル + 自律 + CLI

前提条件

• macOS 12+ / Windows 10+ / Linux（Ubuntu 22.04+）
• インターネット + アカウント（CursorまたはGitHub OAuth）
• VS Codeユーザー: インポートは自動

1. インストール

macOS

brew install --cask cursor

Windows

winget install -e --id Anysphere.Cursor

Linux

cursor.com/downloads でAppImageまたは.debを入手。

初回起動時にVS Codeの拡張機能・キーマップ・テーマをワンクリックでインポートする。新しいユーザーはデフォルトをそのまま受け入れて構いない。

2. モデルを選ぶ

Cursor → Settings → Models。推奨:

• Claude Sonnet 4 — 日常の編集とリファクタリング。高速。
• Claude Opus 4 — 難しいデバッグとアーキテクチャ。低速/高コストだが精度が高い。
• Composer（Cursorの独自モデル） — 複数ファイル、エージェント的。ベータ段階。
• GPT-4.1 / o1 — フォールバック/比較用。

Cursor Proにはモデルごとのリクエスト制限がある。Sonnetは制限が多く高速 — デフォルトにしておき、行き詰まったときだけOpusを使いましょう。

3. 覚えるべき4つのショートカット

Tabオートコンプリート

• シグネチャ補完、パターン繰り返し、自動インポート
• 盲目的に受け入れない — 存在しない API を補完することがある。Esc で積極的に拒否。
• 設定: Features → Cursor Tab → 「Disable preview」でノイズを減らす。

⌘K インライン編集

// 選択: 関数全体
// ⌘K: 「エラーハンドリングとZodの入力バリデーションを追加して」

選択部分のみ変更。大きなタスクには向かない。最速の「意図 → 結果」ループ。

⌘L サイドチャット

• @filename で特定ファイルを添付
• @Codebase でリポジトリ全体を検索（埋め込みベース、ベータ品質）
• @Web で最新情報を検索（Cursorが検索を実行）

⌘I Composer

複数ファイル作業（「認証フロー全体をリファクタリング」）。エージェントモードでは直接ファイルを編集。結果を一度に全部受け入れない — 差分ごとにレビューすること。

4. .cursorrules — プロジェクトルール

リポジトリルートの .cursorrules ファイルは、全てのチャット・編集・Composer 呼び出しで system prompt として自動注入 される。コードスタイル・スタック・禁止事項を一度書けば、毎回入力し直す必要がなくなる。

4.1 テンプレート

Next.js + TypeScriptプロジェクト用:

# Mac/Linux
curl -fsSL https://devalice.jaceclub.com/assets/ai-agents/cursor-setup/cursorrules-nextjs.txt -o .cursorrules
shasum -a 256 .cursorrules
# expected: 7f1ef76397375cae008ece09b46ddf91aa098dff5edaacebcd7e7e4dec92a21d

# Windows
Invoke-WebRequest -Uri https://devalice.jaceclub.com/assets/ai-agents/cursor-setup/cursorrules-nextjs.txt -OutFile .cursorrules

4.2 テンプレートの主要セクション

• プロジェクトコンテキスト — スタック・パッケージマネージャー・言語バージョン
• コードスタイル — strict TS・ファイル名規約・パスエイリアス
• ルーティング/データ — App Routerパターン・ISR・env分離
• セキュリティ — シークレット禁止・入力バリデーション・SQLバインディング
• スコープ — リクエスト外のリファクタリング禁止
• 出力形式 — diff形式・トレードオフ付きの代替案1つ

4.3 変化する点

.cursorrulesなし vs あり:

❌ 「ここにReactコンポーネントを作って」→ クラスコンポーネント、JS、ランダムな追加依存関係 ✅ 「ここにReactコンポーネントを作って」→ strict TSサーバーコンポーネント、@/*エイリアス、Tailwind

良いrulesファイルがあれば、毎プロンプトから3〜4行のコンテキスト設定を省ける。

5. .cursorignore

.gitignore と同じ構文。AI がコンテキストとして取り込まないファイルを指定する。

# 依存関係 / ビルド
node_modules
.next
dist

# 大きなフィクスチャ
fixtures/large/

# 生成コード
src/generated/

省略すると @Codebase 検索にビルド出力が混入し、回答品質が下がる。

6. MCP（Model Context Protocol）

Cursor 0.42+ は MCP をサポート。Claude Code と同じ標準なので、サーバー定義はポータブルだ。

Settings → Features → MCP → Add Server:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/me/projects"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_..." }
    }
  }
}

7. プライバシーモード

Settings → General → Privacy Mode:

• OFF（デフォルト） — Cursor がログ/リクエストをモデル改善に使用する可能性あり
• ON — 学習利用なし。業務コードには必須。

プライバシーONの場合、一部機能（インデックス）はローカル専用になる。パフォーマンスへの影響は小さいだ。

8. Claude Codeとの作業分担

最強のセットアップ: 両方使う。役割:

実践パターン

1. 小さな編集 → Cursor ⌘K — 変更が1つの関数に収まる。すぐに受け入れる。

2. 複数ファイル → Claude Code — 「4つのルートにISRを追加」。変更とビルド検証をCLIから実行。

3. デバッグ → 両方 — 素早い仮説にはCursor; より深いコンテキストと自律実行が必要な場合はClaude Code。

4. PR作成 → Claude Code — gh pr createで自動化。

5. レビュー → Cursor ⌘L — 差分をインラインで読んで1行ずつ質問。

確認

1. 空の index.tsx でCursorを開いてTabでReactコンポーネントのスケルトンを提案させる
2. 関数を選択 → ⌘K 「エラーハンドリングを追加」→ try/catchが追加される
3. @package.json を添付して ⌘L サイドチャット → 依存関係について質問
4. リポジトリルートに .cursorrules を置く → 新しいチャット → ルールに従って動作が変わる
5. Settings → Privacy → ON → 正常動作を確認

トラブルシューティング

Tabオートコンプリートがうるさすぎる

Settings → Features → Cursor Tab → 「Trigger more accurately」、または一時的に無効化。頻繁に拒否するなら、オフにするだけでいいだ。

@Codebase の結果がおかしい

.cursorignoreにビルド出力と生成コードを追加。コードベースの再インデックスをトリガー（Settings → Indexing）。

Cursor独自モデルがよくハルシネーションする

デフォルトをClaude Sonnetに強制。Settings → Models → Default Model = Claude Sonnet。

.cursorrules が無視されているようだ

• ファイル名は正確に: .cursorrules（先頭にドット、拡張子なし）
• サブフォルダではなくリポジトリルートに配置
• 新しい チャットで確認（既存チャットはコンテキストが蓄積されており変化が反映されない場合がある）

Proのクォータがすぐ減る

Composerの使いすぎだ。小さな編集には ⌘K を使い、本当に複数ファイルが必要な作業のためにComposerを取っておきましょう。

Claude Codeとのキーマップ競合

CursorはIDEに、Claude Codeはターミナルにある — 物理的な衝突はほぼないが、一部セットアップでは両方が ⌘L を使う。どちらか一方をリマップしてください。

参考リンク

• Claude Code セットアップ — ターミナルエージェントのセットアップはCursorと相性が良い
• マルチエージェントワークフロー — 複数ツールの組み合わせ
• Cursor ドキュメント
• Cursor MCPガイド

変更履歴

• 2026-05-12 — 初版英語翻訳（devAlice M2 i18n シード）