CursorでClaude Codeを使う連携のやり方｜入れ方・違い・使い分け

「Cursorを使っているが、Claude Codeも試してみたい」「CursorでもClaudeのモデルを選べるのに、Claude Codeを別に使う意味はあるのか」と迷っている方は多いのではないでしょうか。

Claude Codeは、Cursorの中でも使えます。Anthropicの公式ドキュメントにはCursor向けのインストールリンクが用意されていて、拡張機能を入れるとCursorの画面にClaude Codeのチャット欄が開きます。エディタの下にあるターミナルからClaude Codeを動かす使い方もできます。

この記事では、Cursorの中でClaude Codeを使う方法を3つの形に整理したうえで、必要な契約と料金、拡張機能とターミナル版の入れ方、基本の使い方、Cursor標準のAgentとの使い分け、うまく動かないときの対処までを順に解説します。内容は2026年10月15日時点の公式ドキュメントをもとにしています。どちらのサービスも更新が多いので、画面の細かな表示や料金は変わることがあります。

Cursorで使うClaude Codeとは

最初に、CursorとClaude Codeがそれぞれ何なのかを整理します。ここを押さえておくと、「連携」という言葉が指す内容を取り違えずに済みます。

Cursor・Claude Codeの関係

Cursorは、プログラムを書くためのエディタ（編集ソフト）です。公式ドキュメントでは、大きなソフトウェアのプロジェクトで、コードの理解・機能の計画と実装・不具合の修正・変更の確認を進めるコーディングエージェントとして紹介されています。Anthropic、OpenAI、Googleなど複数社のモデルと、Cursor独自のモデルから選んで使えます。

Claude Codeは、Anthropic社が提供する、Claudeにプログラムを読ませたり書かせたり直させたりする道具です。もともとはターミナルで動く道具（CLI）として始まり、いまはエディタの拡張機能、デスクトップアプリ、Web版などでも使えます。

Anthropicのドキュメントでは、Claude Codeの拡張機能は「VS Codeのフォーク（VS Codeをもとにしたエディタ）」にも入れられると説明されていて、Cursorは公式のインストールリンクが載っている代表的なエディタです。つまり、Cursorは「エディタ」、Claude Codeは「その中で動かせる別の道具」という関係になります。

「連携」の3つの形

「CursorとClaude Codeの連携」と言っても、実際には次の3つの形があります。名前が似ているので混同されやすいのですが、料金の請求先も、できることも違います。

この記事で「連携」と呼ぶのは、1と2です。3は、Cursorの機能の中でClaudeのモデルを選ぶ使い方で、Claude Codeそのものを動かしているわけではありません。3については、後半の「CursorのAgent・Tabとの使い分け」と料金の項目で、1・2との違いを説明します。

どんな人に向いているか

すでにCursorを使っている人が、Claude Codeを足すことを前提に、状況別の目安をまとめました。

VS Codeでの使い方は、別の記事で詳しく解説しています。画面や操作はCursorでもほぼ共通なので、あわせて読むと理解が深まります。

必要なもの・料金

使い始める前に、必要なものと料金の関係を整理しておきます。Cursorの契約とClaudeの契約は別々なので、どちらに何がかかるのかを先に押さえておくと、請求の見落としを防げます。

必要なもの

Claudeの無料プランでは、Claude Codeは使えません。公式の料金ページでも、Claude Codeは有料プランに含まれる機能とされています。

Claudeの料金

Claude Codeは、Claudeの有料プランに含まれています。追加の月額は発生せず、プランの使用量の枠を、Claudeのチャットなどと共有して使います。公式の料金ページに載っているプランは次のとおりです（2026年10月時点、ドル建て、税抜）。

Claude Codeの料金やプランの選び方は、別の記事で詳しく説明しています。

Cursorの料金

Cursorの料金は、公式の料金ページによると、2026年10月時点で次のとおりです（ドル建て、税抜）。Cursorは料金体系の変更が多いので、契約の前には必ず公式ページを確認してください。

以前の料金体系のプラン（Pro・Pro+・Ultraなど）を契約している場合は、旧プランとして引き続き使えると、公式のページに書かれています。

料金はどこに請求されるのか

混乱しやすいのが請求先です。どの入口から使うかで、課金される先が変わります。

Cursorの公式ページによると、Claudeのような他社のモデルは、Cursorの月額に含まれる利用枠には入りません。Premium以上のプランで、最初のリクエストからAPIの定価で、前払いのクレジットから課金されます。Teams・Enterpriseでは、これに加えて100万トークンあたり0.25ドルの手数料がかかるとされています。

Cursorのモデル一覧には、これより古いClaudeのモデルも並びますが、多くは初期状態では非表示とされています。

拡張機能の入れ方

ここからは、いちばん手軽な「拡張機能」の入れ方を説明します。公式ドキュメントでは、拡張機能がVS CodeでClaude Codeを使うおすすめの方法とされていて、Cursorにも同じ拡張機能を入れます。

1. Claudeの契約を確認するPro以上のプラン（またはConsoleアカウント）があることを確かめます。無料プランでは、ログインしても使えません。
2. Cursorを最新版にして、拡張機能の画面を開くCursorを更新したうえで、拡張機能の画面（Extensions）を開きます。公式ドキュメントでは、拡張機能の画面を開くショートカットとして、VS CodeのCtrl+Shift+X（MacではCmd+Shift+X）が案内されています。
3. 「Claude Code」を検索して入れる検索欄に「Claude Code」と入力し、発行元がAnthropicのものを選んで「Install」を押します。公式ドキュメントには、Cursorを開いて直接インストールできるリンク（cursor:extension/anthropic.claude-code）も載っています。
4. 表示されないときは再読み込みする入れたあとに拡張機能が現れない場合は、コマンドパレット（Ctrl+Shift+P）から「Developer: Reload Window」を実行するか、Cursorを再起動します。
5. Claude Codeのパネルを開くファイルを1つ開き、エディタの右上にある火花のようなアイコン（Spark）を押します。右下のステータスバーの「✻ Claude Code」や、コマンドパレットで「Claude Code」と入力する方法でも開けます。
6. ログインする初めて開くと、サインイン画面が表示されます。「Sign in」を押し、ブラウザの画面で認可を進めると、Cursorに戻ってきます。ログイン後に「Learn Claude Code」というチェックリストが出るので、「Show me」で順に試すか、×で閉じます。
7. 最初の依頼を送るパネルの入力欄に、たとえば「このフォルダの構成を説明して」と入力して送ります。応答が返ってくれば準備は完了です。

拡張機能のバージョンについて

拡張機能のバージョン番号は、そこに同梱されているClaude Codeのバージョンと同じです。公式ドキュメントでは、新しい機能ごとに「Claude Code v2.1.xxx以降が必要」と書かれています。画面の機能が公式の説明と合わないときは、拡張機能の画面でバージョンを確認し、更新してください。

拡張機能が入らないとき

公式ドキュメントでは、次の順で確認するよう案内されています。

• エディタのバージョンが公式の条件を満たしているか（Cursorを最新版に更新する）
• エディタに、拡張機能をインストールする権限があるか
• Visual Studio Marketplaceから、直接インストールしてみる
• 拡張機能の画面に出てこない場合は、Open VSXという配布サイトから入れる

それでも入らない場合は、次の章で説明するターミナル版で、Cursorのターミナルから使えます。公式ドキュメントでも、拡張機能を入れられないエディタでは、CLIをインストールして統合ターミナルでclaudeを実行するよう案内されています。CLIはどのターミナルでも動きます。

ターミナル版の使い方

拡張機能のほかに、ターミナル版のClaude CodeをCursorの中で使う方法もあります。「画面のボタンより、文字で操作する方が早い」という方や、拡張機能にない機能を使いたい方向けです。

拡張機能・ターミナル版の違い

中身は同じClaude Codeですが、画面の操作方法と、使える機能の範囲が少し異なります。公式ドキュメントでは、次のように比べられています。

設定ファイル（~/.claude/settings.json）と会話の履歴は、拡張機能とターミナル版で共通です。迷ったら拡張機能から始めて、必要な機能が足りなくなったらターミナル版を足す、という順番が無理がありません。

インストールのコマンド

ターミナル版は、お使いのOSに合わせたコマンドを1回実行して入れます。公式ドキュメントに載っている「ネイティブインストール」の方法は次のとおりです。

インストールが終わったら、新しいターミナルを開き直してclaude --versionと入力します。バージョンの数字が表示されれば成功です。「claudeが見つかりません」と表示される場合は、PATH（コマンドの置き場所の設定）が反映されていない可能性があるので、Cursorを一度閉じて開き直してみてください。

Windowsでは、管理者権限は不要です。Git for Windowsは、入れておくとBashツールが使えますが、必須ではありません。入っていない場合は、PowerShellが代わりに使われます。なお、PowerShellとコマンドプロンプトでコマンドが違うので、プロンプトの表示（PS C:\で始まるか）で、どちらを開いているかを確認してから入力しましょう。

インストール手順の全体は、次の記事でも詳しく解説しています。

Cursorのターミナルで起動する

Cursorの統合ターミナルは、エディタの下側に開きます。公式ドキュメントでは、VS Codeでの開き方として、WindowsとLinuxはCtrl+`、MacはCmd+`と案内されています。ターミナルが開いたら、作業したいフォルダであることを確かめて、次のように入力します。

claude

初めて起動すると、ブラウザでログインする画面が開きます。ログインが終わると、ターミナルの中でClaude Codeとの会話が始まります。公式ドキュメントでは、VS Codeの統合ターミナルで起動すると、エディタの変更確認画面や診断情報の共有といった機能が自動で連携すると説明されています。Cursorでの動作の細部は、公式には書かれていません。

会話を引き継ぐ

拡張機能とターミナル版は、会話の履歴を共有しています。拡張機能で始めた会話の続きを、ターミナルで続けたいときは、次のコマンドを実行します。

claude --resume

会話の一覧が表示されるので、検索して選べば、続きから再開できます。同じ会話を2か所で同時に開いていると、「この会話は別の場所でも開かれています」という注意が表示されます。メッセージが混ざる原因になるので、片方を閉じてから続けてください。

外部のターミナルから接続する

Cursorの外にある、ふだん使っているターミナルでClaude Codeを動かしたいときもあるでしょう。公式ドキュメントには、外部のターミナルを使う場合は、Claude Codeの中で/ideを実行してエディタに接続すると書かれています。ただし、この説明はVS Codeを前提にしたものです。Cursorで同じ操作が使えるかは、公式のドキュメントに明記されていません。うまく接続できないときは、Cursorの統合ターミナルで起動するのが確実です。

基本の使い方

ここでは、拡張機能での基本の使い方を紹介します。操作は公式ドキュメントの説明にもとづいています。ターミナル版でも、考え方は同じです。

ファイルや選択範囲を渡す

Claudeに作業を頼むとき、対象のファイルを伝える方法はいくつかあります。

• @でファイルやフォルダを指定する入力欄に@と入力し、ファイル名やフォルダ名を続けます。名前の一部だけで候補が出ます。フォルダは、最後に/を付けます（例：@src/components/）。
• エディタで範囲を選択するコードの範囲を選ぶと、Claudeに自動で見えます。入力欄の下に、選んだ行数が表示されます。Alt+K（MacはOption+K）を押すと、ファイル名と行番号の参照（@app.ts#5-10のような形）が入力欄に入ります。
• 開いているファイル何も選んでいなくても、いま開いているファイルの名前はClaudeに伝わります。選択範囲だけを渡したいときは、拡張機能の設定「Attach Open File」をオフにします。
• 画像やファイルを貼り付ける画像は、クリップボードから入力欄に貼り付けられます。ファイルは、Shiftキーを押しながら入力欄へドラッグします。

ターミナルの出力を伝えたいときは、@terminal:ターミナル名と書くと、エラーメッセージやログをコピーして貼り付けなくても、Claudeに見せられます。

変更の確認・権限モード

Claudeがファイルを書き換えるとき、どこまで確認を挟むかは、入力欄の下にある権限モードで選びます。

起動時にどのモードになるかは、Claude Codeの版や設定で変わります。安全のため、使い始めはManualか、Planにしておくのがおすすめです。画面下のモード表示をクリックすれば、いつでも切り替えられます。

Manualでは、Claudeがファイルを書き換えようとするたびに、元の内容と変更案を左右に並べた比較画面が開きます。内容を見て、受け入れる・断る・別の指示を出す、のいずれかを選べます。比較画面の中で、変更案を直接書き換えてから受け入れることもできます。変更が複数ある場合は、1か所ずつ「Accept this change」「Reject this change」のボタンで確認できます。

計画を先に確認する

大きな変更では、いきなり書き換えさせるより、計画を先に見てもらう方が安全です。Planモードにするか、入力欄で/planと入力すると、Claudeは進め方を示して承認を待ちます。公式ドキュメントでは、計画がMarkdownの文書として開き、文書の中にコメントを書いて修正を伝えられると説明されています。

変更を巻き戻す

思ったのと違う変更が入ったときは、チェックポイントで戻せます。会話のメッセージにマウスを合わせると、巻き戻しのボタンが出て、次の3つから選べます。

チェックポイントは便利ですが、Gitの代わりにはなりません。大きな作業の前には、Gitでコミットしておく習慣をつけると、いちばん確実に戻せます。

よく使うショートカット

Cursorには、Cursor自身のショートカットもあります。同じキーが重なって、思った動きにならないときは、キーボードショートカットの設定画面で、「Claude Code」と検索して、割り当てを変えます。

会話の履歴・複数の作業

パネルの上部にある「Session history」から、過去の会話を検索して再開できます。会話は、別のタブや別のウィンドウで複数同時に進められます。新しい会話には、最初のメッセージをもとにした題名が自動で付き、名前の変更や、使っていない会話のアーカイブもできます。使っていない会話は、14日間動きがないと、自動でアーカイブに移ります。

CursorのAgent・Tabとの使い分け

Cursorには、Claude Codeと似たことをする機能が最初から入っています。「両方あるなら、どちらを使えばよいのか」と悩むところなので、公式ドキュメントで確認できる範囲で比べてみます。

機能の比較

見た目の機能は、似ているところが多くあります。違いが出るのは、契約と、中で動くモデル、そして設定ファイルの置き場所です。

使い分けの考え方

どちらが優れているかは、使う人と仕事で変わります。公式ドキュメントから言えるのは機能の違いまでなので、ここでは判断の軸を整理します。

実際には、「入力中の補完はCursorのTab、まとまった変更の依頼はClaude Code」のように、場面で分けて併用する人も多いようです。ただし、これは一般的な使い方の例で、公式ドキュメントが推奨している分け方ではありません。まずは1つの仕事を両方で試して、手に合う方を選ぶのが確実です。

併用するときの注意

CursorのAgentとClaude Codeを同じプロジェクトで使うときは、次の点に気をつけてください。

• 同じファイルを同時に書き換えさせない片方の変更をもう片方が上書きすることがあります。依頼する作業の範囲を分けるか、片方が終わってから次を頼みます。
• 作業の前にGitでコミットする両方のチェックポイントは、Gitの代わりになりません。Cursorの公式ドキュメントでも、チェックポイントはGitとは別にローカルに保存され、永続的な管理はGitで行うよう書かれています。
• 使用量の枠が別であることを意識するClaudeの枠が足りなくなったら、Cursor側のクレジットを使うことになります（請求先が変わります）。
• 指示を2か所に書き分けない同じ内容を、CLAUDE.mdと.cursor/rules/の両方に書くと、あとで食い違います。次の項目の方法で、1つにまとめましょう。

指示ファイルを共有する

プロジェクトのルール（使う言語、コードの書き方、やってはいけないこと）を書いておく指示ファイルは、Cursorと Claude Codeで読むファイルが違います。公式ドキュメントで確認できる範囲は、次のとおりです。

両方で使うなら、AGENTS.mdにルールを書いておくのが、いちばん単純な方法です。CursorがAGENTS.mdを読み、Claude CodeもCLAUDE.mdが無ければAGENTS.mdを読みます。すでにCLAUDE.mdがある場合は、その中に次の1行を書くと、AGENTS.mdの内容が読み込まれます。

@AGENTS.md

公式ドキュメントでは、CLAUDE.mdがAGENTS.mdをこの形で取り込んでいれば、Claude CodeはCLAUDE.mdに、AGENTS.mdの内容を含めて読むと説明されています。

スキル（決まった作業の手順をまとめたもの）については、Cursorの公式ドキュメントに、互換のために.claude/skills/と~/.claude/skills/も読むと書かれています。Claude Code用に作ったスキルを、そのままCursorでも使える可能性があります。フックについても、Cursorの公式ドキュメントに、Claude Codeなどのサードパーティのフックを読み込めるとあります。ただし、読み込める範囲の詳細は別のページにあり、ここでは確認できていません。使う前に、実際の動作を小さな例で確かめてください。

CLAUDE.mdの書き方は、別の記事で詳しく解説しています。

うまく動かないとき

よくあるつまずきを、症状ごとにまとめました。対処は、公式ドキュメントに載っているものです。

表の内容で解決しない場合は、公式のGitHubに不具合を報告する窓口があります。拡張機能の画面の「Show Logs」からログを確認することもできます。

Cursor側の機能と干渉していないか

公式ドキュメントでは、火花のアイコンが出ないときに、ほかのAI拡張機能を一時的に無効にして確認するよう案内されています。CursorのAI機能と、Claude Codeの拡張機能が干渉する例について、公式には具体的な案内がありません。表示や動作がおかしいときは、一度Cursor側の同じ機能（たとえばTab）をオフにして、症状が変わるかを確かめると、原因を絞りやすくなります。

安全に使うために

Claude Codeは、ファイルを書き換えたり、コマンドを実行したりできます。Cursorの中で使うときも、次の点を決めておきましょう。

• 最初のうちは、権限モードをManualかPlanにして、変更を1つずつ確認する
• パスワードやAPIキーなど、秘密の情報が入ったファイルは、読ませないように設定する
• 作業の前にGitでコミットして、いつでも戻せる状態にしておく
• ターミナルでの操作や、外部へ送信するような操作は、内容を読んでから許可する

拡張機能をアンインストールする

拡張機能の画面で「Claude Code」を検索し、「Uninstall」を押します。注意点として、Claude Codeを統合ターミナルで実行すると、拡張機能が自動で入り直される場合があります。公式ドキュメントでは、これを止めるには、/configの「Auto-install IDE extension」をオフにする、または環境変数CLAUDE_CODE_IDE_SKIP_AUTO_INSTALLを1にするよう案内されています。この動作はVS Codeの統合ターミナルについて書かれたもので、Cursorでの挙動は明記されていません。

よくある質問

まとめ

CursorとClaude Codeは、競合するというより、役割をずらして使える関係です。まずはClaudeの契約を確かめ、拡張機能を入れて、小さな仕事を1つ頼んでみてください。使い心地が分かれば、Cursor標準のAgentとの分担も決めやすくなります。

社内で複数人が使い始める段階では、契約の持ち方、渡してよいコード、指示ファイルの置き方など、決めることが増えます。INTERCREATE JAPANでは、Claude Codeの導入から、社内のルールづくり、業務ツールの開発までをお手伝いしています。