最強神器「Cursor」の本当に使い方を徹底解説【知らないとヤバいレベルです】

Zenn 記事。著者:まさお(@AI_masaou)。Cursor を1500時間使い込んだ経験をもとに、Tab補完・Chat・Composer(Normal/Agent)の全機能を体系的に解説した入門〜実践ガイド。実践的な開発速度 6〜10倍 の達成実績を持つ著者による、機能紹介と運用ノウハウの網羅的な記事。

記事の核心メッセージ

  • 「コードを書く」から 「AIがコードを書き、開発者が補助する」 へのスタイル転換
  • Proプラン($20/月)で実質すべての機能が使える
  • 本命は Composer Agent — 0→1開発から大規模プロジェクトまで対応

章構成と主要ポイント

1. Cursorとは何か

  • VSCode互換エディタ — 拡張機能・キーバインド・テーマをそのまま移行可能
  • 競合(GitHub Copilot等)との差異:チャット・Composer・Agentモードによる「開発フロー全体」をAIが支える仕組み
  • 内部でプロジェクト全体をインデックス化し、RAG(Retrieval-Augmented Generation)でプロジェクト文脈に根ざした回答・生成を実現

2. Tab補完機能

  • 複数行補完・マルチライン一括リライト・カーソル予測が強み
  • Codebase Index の仕組み:tree-sitter でチャンク化 → OpenAI Embedding API でベクトル化 → リモートVector DBに保存
    • 自動同期あり(コード変更のたびにインデックス更新)
    • .gitignore / 独自除外設定でノイズ除去可能
    • ローカルモードでコードをサーバーに送らない設定可
  • GitHub Copilot との差:「複数箇所の同時修正提案」まで踏み込むUXの高さ

3. Composer(Normalモード)

  • Chat vs Composer の使い分け:ChatはQA・探索向き、ComposerはコードGeenration・リファクタ向き
  • ショートカット:⌘I → ⌘N で Composer 画面を開く
  • 生成フロー:要件記述 → AIがコード提案 → Diff確認 → Apply でファイルへ直接反映
  • @docs でドキュメント参照しながら実装(外部ライブラリ仕様・社内Wiki URLで指定可)

4. Composer Agent(Agentモード)★本命

  • マルチファイル横断でコードを自律生成・修正
  • エラー検知 → 自動で修正案を再提案
  • ターミナルコマンドまで提案・実行(確認プロンプトあり)
  • 0→1開発:新規ファイル自動生成、関連マイグレーションまで提案
  • 大規模プロジェクト:機能追加時に関連クラス・APIを自動修正
  • Yolo Mode:コマンドの自動実行許可/不許可の設定
  • ベストプラクティス:こまめなGitコミット・差分チェック→取り込み→テストのサイクル確立

5. RAGの仕組み(推測)

  • @codebase@docs@folders で明示的にコンテキスト指定可能
  • 汎用AIと違い「生のコード」へシームレスにアクセスできる点が高精度の源泉

6. 運用ノウハウ

  • Agentによるリファクタ前に必ずコミット
  • Composer Agent + ドキュメント生成の並行運用でドキュメント負債を削減
  • .cursorignore:不要ファイルをインデックスから除外
  • .cursorrules(現在は ProjectRules に進化):コーディング規約・出力スタイルをプロジェクト単位で定義

7. その他機能

  • Notepad:Markdown メモを AI に参照させる。@Notepad で呼び出し
  • Docs機能:外部ドキュメント・API仕様を登録してAIが参照
  • Gitコミットメッセージ自動生成 アイコンから起動
  • Privacyモード:SOC2認証取得。有効化でコードをクラウドに送信しない
  • MCPサーバー連携:よく使うワークフローとの連携

8. 料金プラン

プラン価格主な特徴
Hobby無料補完2000回/月、プレミアムモデル50回(slow)、Proトライアル2週間
Pro$20/月補完無制限、GPT-4o/Claude 3.5 Sonnetなど高速500回+低速無制限
Business$40/ユーザー/月ProにSSO・プライバシーモード強制・管理ダッシュボード追加
  • Composer Agentの真価を体感するには Pro以上 を推奨

キーインサイト

Cursor の本質は「プロジェクト全体を理解して動くAI参謀」。Tab補完とChatで止まっているユーザーには、Composer Agent こそが最大の価値提供源であり、開発者の役割を「実装」から「レビューと方向付け」にシフトさせる。コミット管理・テスト習慣・.cursorrules による規約明示の3つがAgentの破壊的変更リスクを抑えるガードレールとなる。

関連