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 --version2.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
指示ファイルだけでよいなら /init
/initは.cursor/rules/と.cursorrulesの内容を読み、必要な部分を生成するCLAUDE.mdに反映します。 - 2
MCPやサブエージェントも持ち込むなら /import cursor
/import cursorは、指示ファイルに加えて、MCPサーバー、コマンド、サブエージェント、Skillsまで引き継ぎます。Cursorからの取り込みにはv2.1.265以降が必要です(/import自体はv2.1.213以降)。 - 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以降)も受け付けます。
拡張機能が新しい会話をどのモードで始めるかは、次の順に最初に当てはまったものが採用されます。
- VS Codeのユーザー設定
claudeCode.initialPermissionMode - モード表示から最後に選んだモード(Manual・Edit automatically・Autoのいずれか。Planは選んだ会話だけに効く)
- 管理設定または
~/.claude/settings.jsonのpermissions.defaultMode - プランやプロバイダーで決まる組み込みの既定値
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で固定しておくと、併用中のファイル変更の出どころが追いやすくなります。
参照した一次ソース
この記事の記述は、次の一次ソースと照合しています。更新時に参照先が変わった場合は一覧も更新します。