無料相談する

カテゴリー / VS Code・Git・ツール連携

Claude CodeをCursorで連携する方法｜拡張機能とCLIの使い分け

NO WAVE公開 更新 読了目安 12分

この記事の目次

Claude CodeとCursorのエディタ連携は、公式に用意された2つの経路のどちらかで行います。1つはCursorにClaude Codeの拡張機能を入れる方法で、Anthropicの公式ドキュメントにはCursor用のインストールリンクが載っています。もう1つはCursorの統合ターミナルでCLIの claude を起動する方法で、拡張機能が有効ならCLIはエディタと自動でつながり、差分表示や診断情報の共有が使えます。どちらの経路でも、~/.claude/settings.json の設定と会話履歴は共通です。

ツール自体の違いを比べたい場合はClaude CodeとCursorの比較を参照してください。

Claude CodeとCursorを連携すると何がつながるのか？

つながるのは「Claude Codeの実行環境」と「Cursorのエディタ画面」です。アカウント同士を連携させる仕組みではありません。

公式ドキュメントによると、拡張機能が有効なあいだ、拡張機能はローカルにMCPサーバーを立て、CLIはそこへ自動で接続します。このサーバー（名前は ide）を通じて、CLIは次のことを行います。

  • エディタのネイティブな差分ビューアで変更内容を開く
  • 選択中のテキストを @ メンションの材料として読む

接続中は、エディタで選択している範囲とアクティブなファイルのパスが、プロンプトを送るたびに文脈としてClaudeに渡されます。Claudeは mcp__ide__getDiagnostics というツールで、Problemsパネルのエラーと警告も読めます。

もう1点、Cursor上では拡張機能とCLIが同じ会話履歴を共有しています。拡張機能で始めた会話をCLIで続けるには、ターミナルで claude --resume を実行します。

Cursorに拡張機能を入れる手順は？

公式の「Use Claude Code in VS Code」ページには、VS Code用と並んで「Install for Cursor」というリンクがあり、拡張機能のIDは anthropic.claude-code です。リンクを使わない場合は、拡張機能ビューを開いて「Claude Code」で検索し、インストールします。公式はVS Codeのフォーク向けに、Open VSXレジストリの掲載ページも案内しています。

インストール前に確認したい前提条件は次の2つです。

  • 公式ページに書かれた要件（VS Code 1.94.0 以降）
  • Anthropicアカウントがあること（Pro、Max、Team、Enterpriseのいずれかの有料プラン、またはClaude Consoleアカウント。APIキーは不要）

Cursor連携のインストール後の流れは次のとおりです。

  1. エディタ右上のツールバーにあるSparkアイコンをクリックしてパネルを開く（ファイルを開いているときだけ表示されます）
  2. 初回はサインイン画面が出るので「Sign in」を押し、ブラウザで認可する
  3. 拡張機能ビューに表示されるバージョン番号を確認する。公式によると、この番号は拡張機能が同梱しているClaude Codeのバージョンと同じです

インストールしても拡張機能が見えないときは、エディタを再起動するか、コマンドパレットから「Developer: Reload Window」を実行します。拡張機能単体の画面操作やショートカットはClaude Code VS Code拡張機能ガイドで扱っています。

CursorのターミナルでCLIを使うには？

拡張機能はチャットパネル用にCLIのコピーを同梱していますが、シェルのPATHには claude を追加しません。統合ターミナルで claude と打って使うには、単体のCLIを別途インストールします。公式のクイックスタートに載っているコマンドは次のとおりです。

macOS、Linux、WSLの場合:

curl -fsSL https://claude.ai/install.sh | bash

WindowsのPowerShellの場合:

irm https://claude.ai/install.ps1 | iex

他の入れ方はClaude Codeのインストールガイドにまとめています。

インストール後は、Cursorの統合ターミナルでプロジェクトのフォルダを開いて claude を起動します。CLI自体はどのターミナルでも動くため、拡張機能を入れられない環境でもこの方法は使えます。公式ドキュメントでは、統合ターミナルから起動したCLIはIDEと自動で連携し、差分表示や診断情報の共有が使えると説明されています。この連携は、拡張機能が有効なときに拡張機能が立てるローカルのMCPサーバーへCLIが接続する仕組みです。エディタの外のターミナルで起動した場合は、Claude Codeの中で /ide を実行するとエディタに接続できます。/ide はIDE連携の管理と接続状態の表示を行うコマンドです。

Cursorの統合ターミナルで最初にやっておくとよいのが /terminal-setup です。公式ドキュメントでは、Cursorに対して次の変更を行うと説明されています。

  • Shift+Enterのキーバインドを追加する（公式の表では、CursorでShift+Enterによる改行を使うには /terminal-setup を1回実行すると書かれています）
  • terminal.integrated.gpuAcceleration を "off" にして、統合ターミナルの文字化けを防ぐ
  • terminal.integrated.mouseWheelScrollSensitivity を設定して、フルスクリーンモードでのスクロールを滑らかにする

GPUアクセラレーションの変更を元に戻したいときは、値を "auto" に戻してウィンドウを再読み込みします。

拡張機能とCLI、どちらを選べばよいか？

画面上で計画や差分を確認しながら進めたいなら拡張機能、CLIにしかない機能を使いたいならCLIが向いています。公式ドキュメントの比較表のうち、判断に関わる部分を抜き出すと次のようになります。

項目 CLI 拡張機能
コマンドとスキル すべて使える 一部（/ を入力して確認）
MCPサーバーの設定 使える 使える（チャットパネルで /mcp）
チェックポイント 使える 使える
! によるBashショートカット 使える 使えない
Tab補完 使える 使えない

2つは併用できます。公式ドキュメントも、CLIにしかない機能が必要なときは統合ターミナルで claude を実行するよう案内しています。拡張機能を入れたままCLI風の画面で使いたい場合は、拡張機能の設定 useTerminal（既定は false）をオンにするとターミナルモードで起動します。

権限と機密ファイルの設定はどこに書けばよいか？

Cursor連携の設定の置き場所は2つあります。公式ドキュメントの区分は次のとおりです。

置き場所 開き方 何を決めるか
拡張機能の設定 設定画面の Extensions > Claude Code パネルの開き方、初期の権限モードなど、エディタ内の挙動
~/.claude/settings.json ファイルを直接編集 許可するコマンド、環境変数、hooks、MCPサーバー。拡張機能とCLIで共有

拡張機能の設定のうち、権限設定に関わるのは次の2つです。

  • initialPermissionMode: 新しい会話の承認の扱いを default、plan、acceptEdits、bypassPermissions から選ぶ。公式によると、この値はユーザー設定からだけ読まれ、ワークスペースの設定は無視されます
  • allowDangerouslySkipPermissions: 既定は false。オンにするとモード選択にBypass permissionsが加わります。公式は、インターネットにつながらないサンドボックスでだけ使うよう注意しています

機密ファイルの扱いにも注意が要ります。IDE接続中は選択範囲と開いているファイルのパスがClaudeに渡るため、.env のようなファイルは settings.json に Read のdenyルールを書いて除外します。公式によると、一致するdenyルールがあれば、そのファイルの選択テキストも開いているファイルの通知もClaudeに届きません。

Problemsパネルの診断情報を渡したくない場合は、Read のdenyルールでは止まらないため、ツール名を指定して拒否します。公式の例は次のとおりです。

{
  "permissions": {
    "deny": [
      "mcp__ide__getDiagnostics",
      "mcp__claude-vscode__getDiagnostics"
    ]
  }
}

settings.json に "$schema": "https://json.schemastore.org/claude-code-settings.json" を書いておくと、Cursorでも補完と入力チェックが効きます。ここで扱った設定はすべてClaude Code側のものです。CursorのAI機能の自動実行に関する設定は、Cursor側で確認してください。権限モードの考え方はClaude Codeの権限モード、設定ファイルの書き方はsettings.jsonの設定ガイドで扱っています。

Cursorで書いてきたルールをClaude Codeに引き継ぐには？

/init を使います。公式ドキュメントによると、/init は他のツールの指示ファイルを読み、関係する部分を生成する CLAUDE.md に取り込みます。対象にはCursorのルールである .cursor/rules/ と .cursorrules が含まれます。

また、Claude Code v2.1.213以降には /import があり、対応するコーディングエージェントの設定を一度だけコピーして取り込めます。指示ファイルに加えて、MCPサーバー、コマンド、サブエージェント、スキルも引き継ぎます。

取り込んだ後の CLAUDE.md の整え方はCLAUDE.mdの書き方を参照してください。

CursorのAIとClaude Codeが同じファイルを同時に書き換えないようにするには？

同じ作業フォルダで2つのAIに並行して編集させると、片方の変更をもう片方が上書きしやすくなります。Claude Code側の作業を別の作業フォルダに切り出すには、git worktreeを使う --worktree オプションがあります。

claude --worktree feature-auth

公式によると、worktreeは既定ではリポジトリ直下の .claude/worktrees/<name>/ に作られ、worktree-<name> という新しいブランチになります。Cursorで元のフォルダを編集しながら、Claude Codeには別のファイルのコピーで作業させられるので、同じファイルの取り合いを避けられます。worktreeの運用はworktreeで並列作業する方法で詳しく扱っています。

連携がうまくいかないときはどこから確認すればよいか？

症状ごとに、公式ドキュメントが示している確認先を並べます。

症状 確認すること
拡張機能がインストールできない 公式の要件（VS Code 1.94.0以降）と、拡張機能をインストールする権限があるか
インストールしたのに表示されない エディタの再起動、または「Developer: Reload Window」
Sparkアイコンが出ない ファイルを開いているか、他のAI拡張を一時的に無効にする、ワークスペースが制限モードになっていないか
ターミナルで claude が見つからない 単体のCLIを入れたか（拡張機能はPATHを通さない）。入れた後も出ない場合はPATHの設定
外部ターミナルのCLIで差分がエディタに出ない Claude Codeの中で /ide を実行して接続する
統合ターミナルの文字が四角や崩れた字になる /terminal-setup を実行するか、terminal.integrated.gpuAcceleration を "off" にしてウィンドウを再読み込み
パネルが応答しない インターネット接続、新しい会話で再現するか、ターミナルで claude を起動して詳しいエラーを見る

Sparkアイコンが出ない場合でも、ウィンドウ右下のステータスバーにある「✻ Claude Code」からは、ファイルを開いていなくてもパネルを開けます。

公式は、VS Codeの統合ターミナルで claude を実行すると拡張機能が自動で再インストールされると説明しています。拡張機能を外したのにまた入ってくる場合は、これに当てはまらないか確認してください。自動インストールを止めるには、/config で「Auto-install IDE extension」をオフにするか、環境変数 CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL を 1 にします。この設定キー autoInstallIdeExtension はグローバル設定のもので、settings.json に書いても無視されます。

サインインやネットワークのエラーが残る場合は、Claude Codeのエラー対処ガイドの確認項目も参照してください。画面の表示が本記事と異なるときは、公式の「Use Claude Code in VS Code」ページと照らし合わせてください。

拡張機能とCLIの使い分けを自分の環境に合わせて決めるには

どちらの経路を使うか、権限をどこまで自動にするかは、扱うリポジトリやチームの決まりによって変わります。こうした設定を自分で判断して組み立てられるようになりたい場合は、月額1,980円から参加できる学習コミュニティ「AI駆動ラボ」（lab.no-wave.jp）で、設定例や運用の工夫を学びながら進める方法があります。

CONTINUE THE SESSION

関連記事