Claude Media
CursorとClaude Codeの併用はできる?入れ方と指示ファイルの共有

CursorとClaude Codeの併用はできる?入れ方と指示ファイルの共有

CursorとClaude Codeは併用できます。拡張機能の入れ方、AGENTS.mdでの指示ファイル共有、権限モードの固定、二重起動の注意を手順で示します。

CursorとClaude Codeを併用する場面とは

結論は、併用できます。Cursorの拡張機能ビューからClaude Codeを入れ、指示ファイルはAGENTS.mdに寄せるのが基本の形です。

CursorとClaude Codeは、どちらか一方を選ぶ道具ではありません。CursorはVS Codeフォークで、Claude Codeの拡張機能をそのまま入れられます。指示ファイルのAGENTS.mdも両方が読めます。Claude Codeには、承認するまで編集が始まらないPlanモードがあります。同じリポジトリで両方を立ち上げたままにしても、指示と承認の置き場を決めておけば混線しません。

典型的な併用は3つです。

  • Cursorで書き進め、大きな機能追加だけClaude CodeのPlanモードに渡す
  • Cursorのエージェントで試作し、レビューと仕上げをClaude Codeに任せる
  • Cursorをメインのエディタにしたまま、Claude Code拡張機能をサイドパネルに置いておく

Cursorを手放してClaude Codeへ移行する道もあります。Cursorを使い続けたいなら併用です。併用で最初に決めるのは、Claude Codeをどの形で動かすかです。

拡張機能とCLI、Cursorではどちらを入れるか

CursorのようなVS Codeフォークには、Claude Codeの拡張機能をそのまま入れられます。インストール用のディープリンクはcursor:extension/anthropic.claude-codeで、拡張機能ビュー(Cmd+Shift+X / Ctrl+Shift+X)で「Claude Code」を検索しても入ります。Open VSXレジストリ経由のインストールにも対応しています。

ここに1つ落とし穴があります。拡張機能が内部に持つのはチャットパネル用のCLIの同梱コピーだけで、統合ターミナルでclaudeと打てるようにはなりません。ターミナルからも使うなら、拡張機能とは別にCLIを入れます。

npm install -g @anthropic-ai/claude-code

入れたあとのバージョンは、手元(v2.1.287で確認)では次のように出ます。

claude --version
2.1.287 (Claude Code)

拡張機能のパネルとターミナルのclaudeは別のプロセスです。同じ会話を2か所で開こうとすると、パネルに「This conversation is still open somewhere else. Using it in two places at once can mix up its messages.」という注意が出ます。続けるには、先に片方を閉じます。そのまま「Open here anyway」を押すと、両方で開いた状態になります。

セッション一覧のほうは、ターミナルで動いているプロセスも「開いている」として数えます。Cursorのパネルで始めた作業をターミナルに持ち出す前に、パネル側を閉じる習慣をつけておくと混線しません。

役割分担は「依頼の粒度」で決める

分担の線は、変更前に内容を確認してから着手させたいかどうかで引けます。確認を挟みたい大きめの変更はClaude Codeに渡し、数行の書き換えはエディタ側で済ませる、という分け方です。

Claude CodeのPlanモードでは、変更前に内容が示され、承認するまで編集は始まりません。VS Code系の拡張機能ではプランが全画面のMarkdown文書として開き、インラインコメントで修正を入れてから着手させられます。プロンプト欄に/planと打ってもPlanモードに入れます(v2.1.280以降)。Planモード中に/plan openと打つと、プランファイルをエディタで開きます。

大きな変更を勢いで確定させたくないとき、承認の関門だけをClaude Code側に置く使い方ができます。

指示ファイルを二重管理しない — AGENTS.mdの扱いは条件で変わる

Cursorは.cursor/rules/配下の.mdcファイルをプロジェクトルールとして読みます。Claude Codeが読むのはCLAUDE.mdです。両方に同じ指示を書くと、片方だけ更新されて食い違います。

共有の置き場として使えるのがAGENTS.mdです。CursorはAGENTS.mdを.cursor/rulesの簡易な代替として読み、サブディレクトリに置いたAGENTS.mdも、そのディレクトリ内のファイルを扱うときに適用します。

Claude Code側は、v2.1.277以降ならAGENTS.mdを直接読めます。ただしAmazon Bedrockやテレメトリ無効のセッションでは、v2.1.281より前はCLAUDE.mdしか読まれません。アップグレード直後の最初のセッションでも読まれず、次のセッションから読まれます。さらに読まれるかどうかは、リポジトリにある指示ファイルの組み合わせで決まります。

読み込み条件

リポジトリの指示ファイルと、Claude Codeが読むもの

  • AGENTS.mdだけ

    AGENTS.mdがそのまま読まれます。CLAUDE.mdを足す必要はありません。

  • AGENTS.mdとCLAUDE.md

    CLAUDE.mdだけが読まれ、AGENTS.mdは既定では無視されます。

  • CLAUDE.mdが@AGENTS.mdを取り込む

    CLAUDE.mdが読まれ、取り込んだAGENTS.mdの内容も入ります。二重には読まれません。

注意したいのは、自分用のCLAUDE.local.mdを足した場合です。CLAUDE.local.mdも「CLAUDE.mdがある」と数えられるため、AGENTS.mdだけで運用していたプロジェクトでCLAUDE.local.mdを作ると、AGENTS.mdが読まれなくなります。両方読ませたいときは、セッション内で/configを開き、Project instructionsをclaude-md-and-agents-mdにします。

CLAUDE.mdを残す構成にするなら、先頭で取り込みます。

@AGENTS.md
 
## Claude Code
 
src/billing/配下の変更はPlanモードを使う

Claude Code固有の指示が要らなければ、ln -s AGENTS.md CLAUDE.mdのシンボリックリンクでも足ります。ただし2つ条件があります。シンボリックリンク越しの書き込みはEditツールとWriteツールが拒み、Claudeはリンク先のAGENTS.mdを編集するよう案内されます。Windowsではリンクの作成に管理者権限かDeveloper Modeが要り、コミットしたリンクがGitの設定次第で1行のテキストファイルとしてチェックアウトされます。Windowsのメンバーがいるなら@AGENTS.mdの取り込みが安全です。

どちらの構成でも、次のセッションで/contextを開き、Memory filesにCLAUDE.mdが出ていることを確かめます。AGENTS.mdだけの構成では、v2.1.280より前は/contextにも/memoryにも直接読んだAGENTS.mdが出ません。その場合はClaudeに「いま読んでいる指示の内容」を尋ねて確かめます。取り込み方式の@AGENTS.mdは、その後にCLAUDE.md側だけを直してもAGENTS.mdは変わりません。共通の指示はAGENTS.mdで直します。

Cursorの既存設定をClaude Codeへ移す

すでに.cursor/rules/や.cursorrulesを運用しているなら、手で書き写す必要はありません。取り込みの手段は2つあります。

手順

Cursorの設定を取り込む

  1. 1

    指示ファイルだけでよいなら /init

    /initは.cursor/rules/と.cursorrulesの内容を読み、必要な部分を生成するCLAUDE.mdに反映します。

  2. 2

    MCPやサブエージェントも持ち込むなら /import cursor

    /import cursorは、指示ファイルに加えて、MCPサーバー、コマンド、サブエージェント、Skillsまで引き継ぎます。Cursorからの取り込みにはv2.1.265以降が必要です(/import自体はv2.1.213以降)。

  3. 3

    書き込む前に --dry-run で見る

    /import cursor --dry-runなら何も書かずに一覧だけ出ます。--yesを付けると対話式の選択を省けます。-pでの非対話実行では、見つかった内容とその取り込みコマンドが表示されるだけです。

/importは指示ファイルを、対応するCLAUDE.mdに1回限りの複製として追記します。その後にCursor側のルールを直しても、CLAUDE.mdには反映されません。同期を続けたいなら、前の節のAGENTS.md方式のほうが向いています。Amazon BedrockやMicrosoft Foundryなどのサードパーティ基盤では/importは使えません。

MCPサーバーを/importで持ち込んだあとに同じサーバーを足す前には、claude mcp listで登録済みかを確認できます。claude mcp add --helpの例では、HTTPサーバーをclaude mcp add --transport http <名前> <URL>で追加する形が示されます。Cursor側の設定手順はCursorのMCP設定にあり、接続方式ごとの認証の違いはそちらで確認できます。

CLAUDE.mdそのものの書き方はCLAUDE.mdの設計パターンにまとめています。

権限モードを片方に固定する

併用中に困るのが、どちらが今のファイル変更を出したのか分からなくなる場面です。対策は、Claude Code側の承認の出方を固定することです。

VS Code系の拡張機能では、権限モードの表示ラベルと内部名が違います。

表示ラベル設定値
Manual設定値default(manualも同じ意味)
Edit automatically設定値acceptEdits
Plan設定値plan
Auto設定値auto
Bypass permissions設定値bypassPermissions

CLIの--permission-modeが受け付ける値も、手元(v2.1.287で確認)のclaude --helpで見られます。

claude --help | grep -A4 "permission-mode"
  --permission-mode <mode>              Permission mode to use for the session
                                        (choices: "acceptEdits", "auto",
                                        "bypassPermissions", "manual",
                                        "dontAsk", "plan")

CLI側の選択肢にはdefaultではなくmanualが並びます。設定ファイルのpermissions.defaultModeはdefaultもmanual(v2.1.200以降)も受け付けます。

拡張機能が新しい会話をどのモードで始めるかは、次の順に最初に当てはまったものが採用されます。

  1. VS Codeのユーザー設定claudeCode.initialPermissionMode
  2. モード表示から最後に選んだモード(Manual・Edit automatically・Autoのいずれか。Planは選んだ会話だけに効く)
  3. 管理設定または~/.claude/settings.jsonのpermissions.defaultMode
  4. プランやプロバイダーで決まる組み込みの既定値

v2.1.283以降は、Autoが使える状態なら組み込みの既定値はAutoです。settingsでオフにしている場合、非対応のモデルの場合、サーバー側で停止されている場合は、Manualで始まります。Autoは分類器が操作を確認する方式で、ファイル編集のたびに許可を聞かれる状態ではありません。必ず差分を見てから適用したいなら、claudeCode.initialPermissionModeをdefaultに固定します。

落とし穴が3つあります。

  • 拡張機能はプロジェクトの.claude/settings.jsonと.claude/settings.local.jsonを、起動時の権限モードに使いません。claudeCode.initialPermissionModeはユーザー設定の値だけが読まれ、ワークスペース設定の値は無視されます
  • initialPermissionModeにautoは指定できません。Autoで始めたいなら、設定を未設定のままにして、モード表示から一度Autoを選びます
  • bypassPermissionsは、拡張機能の設定で「Allow dangerously skip permissions」を有効にしていないと、Manualで始まります

まとめ

指示を同期し続けるならAGENTS.md、1回だけ移すなら/import cursorが軸になります。どちらを選んでも、承認の出方はclaudeCode.initialPermissionModeで固定しておくと、併用中のファイル変更の出どころが追いやすくなります。

参照した一次ソース

この記事の記述は、次の一次ソースと照合しています。更新時に参照先が変わった場合は一覧も更新します。

  1. code.claude.com/docs/ja/vs-code
  2. code.claude.com/docs/ja/memory
  3. code.claude.com/docs/ja/permission-modes
  4. code.claude.com/docs/en/commands
  5. code.claude.com/docs/en/settings-reference
  6. code.claude.com/docs/en/sessions
  7. cursor.com/docs/context/rules
この記事を共有:XはてブLinkedIn