Claude を Cursor で使う完全ガイド｜インストール・操作・比較まで徹底解説
Cursor は VS Code をベースにした AI ネイティブな IDE として、世界中の開発者から支持を集めています。一方、Anthropic が提供する Claude Code は自律型のコーディング補助ツールとして急速に普及しています。この2つを組み合わせることで、IDE の快適さと Claude の強力な自律実行能力を同時に活かせます。本記事では、Cursor に Claude Code を導入する手順から、それぞれのツールの特徴・比較・最適な使い分けまでを詳しく解説します。
目次 (18)
- Cursor とは？AIネイティブな次世代 IDE
- Claude Code とは？自律型コーディングアシスタント
- Cursor に Claude Code をインストールする方法
- 方法1：公式リンクからワンクリックインストール
- 方法2：拡張機能パネルから検索してインストール
- 方法3：VSIX ファイルを使う手動インストール
- Cursor 内で Claude Code を使う基本操作
- プロンプトの送り方
- 権限モードの切り替え
- Claude Code と Cursor の機能比較
- 両ツールを組み合わせる最強ワークフロー
- よくある問題とトラブルシューティング
- スパークアイコンが表示されない
- 拡張機能が自動検出されない
- 応答がない・ログインを求められる
- IDEが接続されていないというエラー
- まとめ：Cursor ユーザーが Claude を使うメリット
- 出典
Cursor とは？AIネイティブな次世代 IDE
Cursor は VS Code をフォークして開発された統合開発環境（IDE）で、AI 支援機能を核心に据えています。通常の VS Code 拡張機能との最大の違いは、タブ補完によるリアルタイムのインライン編集予測です。コードを書きながら次の行や関数の補完候補がリアルタイムで表示され、Tab キー一発で採用できます。
また、Cursor は GPT や Gemini など複数の AI モデルを同一セッション内で切り替えて利用できる点も特徴的です。料金は個人プランが月額 $20 から始まり、使うモデルの量によって $60〜$200 程度になるケースも報告されています（builder.io による比較記事）。
Claude Code とは？自律型コーディングアシスタント
Claude Code は Anthropic が提供する CLI ベースの AI コーディングツールです。「エージェント優先」の設計思想を持ち、開発者がやりたいことを指示すると、Claude が自律的にファイルを横断しながら実装・テスト・コミットまでを行います。
Cursor が「開発者が運転し AI が助手席に座る」イメージなのに対し、Claude Code は「Claude が運転し開発者がナビゲートする」感覚に近いといえます。200K トークンのコンテキストウィンドウ（Opus 4.7 では 1M ベータ）により、大規模コードベース全体を把握したうえで処理できます。
公式ドキュメントによれば、Claude Code は VS Code だけでなく Cursor にも公式対応しており、拡張機能として直接インストールできます（code.claude.com/docs/en/vs-code）。
Cursor に Claude Code をインストールする方法
方法1：公式リンクからワンクリックインストール
最も簡単な方法は、公式ドキュメントに掲載されている Cursor 専用のインストールリンクを使う方法です。
cursor:extension/anthropic.claude-code
このリンクをブラウザや Cursor のアドレスバーで開くと、拡張機能のインストール画面が立ち上がります。
方法2：拡張機能パネルから検索してインストール
- Cursor を開き、
Cmd+Shift+X（Mac）またはCtrl+Shift+X（Windows/Linux）で拡張機能パネルを開く - 検索欄に「Claude Code」と入力
- Anthropic 製の拡張機能が表示されたら Install をクリック
- インストール完了後、Cursor を再起動
方法3：VSIX ファイルを使う手動インストール
上記2つの方法がうまくいかない場合、VSIX ファイルを直接インストールする方法が有効です（sotayamashita による GitHub Gist）。
cursor --install-extension ~/.claude/local/node_modules/@anthropic-ai/claude-code/vendor/claude-code.vsix
複数プロファイルを使用している場合は --profile "<プロファイル名>" オプションを追加します。または、.vsix ファイルを拡張機能パネルに直接ドラッグ＆ドロップする方法も確実性が高いと報告されています。
Cursor 内で Claude Code を使う基本操作
インストール後、Cursor の画面右上にスパークアイコン（✦）が表示されます。これをクリックすると Claude Code のパネルが開きます。
パネルが見つからない場合は、コマンドパレット（Cmd+Shift+P）から「Claude Code」と検索すると「Open in New Tab」などのオプションが現れます。ステータスバー右下の「✱ Claude Code」からも起動可能です。
プロンプトの送り方
テキスト入力欄にやりたいことを日本語で記述して Enter を押すだけです。@ファイル名 でファイルを参照できるほか、エディタ上でコードを選択した状態でパネルに質問すると、選択部分が自動でコンテキストに含まれます。Option+K（Mac）/ Alt+K（Windows/Linux）で選択範囲の @メンションを自動挿入できます。
権限モードの切り替え
プロンプトボックス下部のモード表示をクリックすると権限モードを切り替えられます。
- 通常モード：各操作の前に確認を求める
- プランモード：実行前に計画を提示してから作業開始
- 自動承認モード：確認なしで編集を進める
初めて使う際は通常モードかプランモードを推奨します。
Claude Code と Cursor の機能比較
| 観点 | Claude Code | Cursor |
|---|---|---|
| 操作スタイル | 自律実行（Claude が主導） | インライン補助（開発者が主導） |
| タブ補完 | なし | あり（独自機能） |
| マルチファイル編集 | 得意 | 可能だが手動確認が多い |
| 対応 IDE | VS Code, Cursor, JetBrains など | Cursor 本体（VS Code フォーク） |
| モデル選択 | Claude シリーズ | GPT, Claude, Gemini など複数 |
| 価格帯（個人） | 月額 $20〜 | 月額 $20〜 |
| トークン効率 | 高い（同一タスクで Cursor 比 5.5倍少ないという報告あり） | モデルにより異なる |
builder.io の比較記事 によると、Claude Code は同じタスクを Cursor と比べて約 5.5 倍少ないトークンで完了するケースが報告されています。
両ツールを組み合わせる最強ワークフロー
Cursor と Claude Code は「競合」ではなく「補完関係」にあります。多くのプロフェッショナルな開発者がすでに両方を組み合わせて使っています。
推奨ワークフロー：
- 日常的なコーディング：Cursor のタブ補完で素早く記述
- 大規模リファクタリング・機能追加：Claude Code パネルでまとめて依頼
- 変更の確認・微調整：Cursor のインライン diff ビューで精査
- テスト・コミット：Claude Code に「テストを書いてコミットして」と一括依頼
Cursor のターミナルを開いて claude コマンドを実行すれば、CLI 版 Claude Code を IDE 内から起動することもできます。これにより、IDE の視認性と CLI の柔軟性を両立できます。
よくある問題とトラブルシューティング
スパークアイコンが表示されない
スパークアイコンはファイルを開いた状態でないと表示されません。フォルダだけ開いている状態では非表示になります。ファイルを開いた後でも表示されない場合は、コマンドパレットから「Developer: Reload Window」を実行してみてください。
拡張機能が自動検出されない
Cursor が Claude Code を互換 IDE として自動検出しない場合は、前述の VSIX 手動インストール方法を試してください。ドラッグ＆ドロップ方式が最も成功率が高いと複数のユーザーが報告しています（sotayamashita の GitHub Gist）。
応答がない・ログインを求められる
初回起動時はサインインが必要です。パネルに「Sign in」が表示されたらクリックし、ブラウザで Anthropic アカウントの認証を完了します。シェルで ANTHROPIC_API_KEY を設定している場合は、Cursor をターミナルから cursor . で起動すると環境変数が引き継がれます。
IDEが接続されていないというエラー
cursor + claude code: IDE is not connected というエラーが出る場合は、Claude Code の CLI 側から /ide コマンドを実行することで Cursor との接続を手動で確立できます。
まとめ：Cursor ユーザーが Claude を使うメリット
Cursor は AI 補助を重視した IDE として完成度が高く、日常的なコーディングの生産性を大幅に向上させてくれます。そこに Claude Code を組み合わせることで、大規模な変更や自律的なタスク実行という Cursor が苦手とする部分を補えます。
インストール自体は数分で完了します。まずは Cursor の拡張機能パネルから「Claude Code」を検索して、実際に試してみてください。Cursor のリアルタイム補完と Claude の深い理解力を組み合わせた開発体験は、一度使うと手放せなくなるはずです。
