ToolArc

CursorのRules・CLAUDE.md・AGENTS.md|どれを使うか

Series:Cursor 開発シリーズ

Cursorを使い始めてしばらくすると、プロジェクトの中に.cursor/rules、AGENTS.md、CLAUDE.mdという似た名前のファイルが並ぶことがあります。どれもAIへの指示ファイルに見えるため、最初は何をどこに書けばいいのか迷うはずです。

わからないまま作業を進めると、同じ指示を複数のファイルにコピーしてしまいがちです。結果として内容が少しずつ食い違ったり、読み込ませるtoken(トークン)の量が余計に増えたりする。読み込む範囲やファイルの選び方は利用ツールによって異なるため、使っているツールの条件から確認します。

.cursor/rulesの具体的な書き方やテンプレートは、別記事のRules Tipsで扱っています。本記事の役割はそこではない。3ファイルの立ち位置を比較し、どれを先に置くべきかを決めることです。

今日の結論

  • 利用ツールと、指示ファイルの適用範囲を先に確認します
  • Cursorだけで効かせたい手順やパスの制約は、Project Rules(.cursor/rules/)に書きます
  • リポジトリ横断の方針・禁止事項・委譲の入口は、AGENTS.mdに寄せます
  • Claude Codeでは、使う版と設定、既存のAGENTS.mdに応じてCLAUDE.mdの必要性を確認します
  • 書き方が次の課題ならRules Tips、読む順が曖昧ならHubへ進んでください

3ファイルの役割比較|Rules・CLAUDE.md・AGENTS.md

CursorのProject Rules(プロジェクトのルールファイル。実体は.cursor/rules/)、CLAUDE.md、AGENTS.mdは、それぞれ効く範囲と役割が異なります。まずは表で全体像を押さえます。

ファイル名役割向く状況向かない状況
Project Rules(.cursor/rules/)Cursor向けの前提指示。常時・パス指定・手動など、効かせ方を分けやすいCursorだけで守らせたい手順やファイル種別の制約リポジトリ全体の方針の正本にする、他ツールと共有したいルールの唯一の置き場にする
AGENTS.md複数ツールが参照しうる共通ルールの入口。詳細を他ファイルへ委譲しやすい方針・禁止事項・「どこを正本とするか」を1か所にまとめたいCursor固有のパス指定ルールをすべてここに書く、同じ長文をRulesと二重に持つ
CLAUDE.mdClaude Code向けの指示ファイル。AGENTS.mdとの選択・併用には版と設定の条件がありますClaude Codeを常用し、Cursor用とは分けて管理したいCursorしか使わない、AGENTS.mdと同じ文言のコピー置き場にする

Cursor公式のRulesは、Project RulesとAGENTS.mdそれぞれの配置・適用範囲を説明しています。Claude Codeでどの指示ファイルを読むかは、Claude Code公式の案内で別に確認します。

Claude Codeはv2.1.277以降、条件を満たすセッションでAGENTS.mdを直接読み取れます。既定では、作業ディレクトリや上位にプロジェクト用のCLAUDE.md、.claude/CLAUDE.md、CLAUDE.local.mdがあればCLAUDE.md側を読み、なければAGENTS.md側を読みます。ユーザー用の~/.claude/CLAUDE.mdは、この切り替え判定には含まれません。

Project instructions設定では両方を読む選択もできます。ただし、版や組み込みプラグインの状態によってはAGENTS.mdを直接読めないため、使っている版と設定、実際に読み込まれたファイルを確認してください。

筆者がToolArcの公開リポジトリで実装した範囲では、方針の入口をAGENTS.mdに置き、Cursor固有の指示は.cursor/rules/へ分け、CLAUDE.mdはClaude固有の指示が必要な場合に用意しています。この分け方は実務例であり、どの環境でも同じファイルが自動で読まれるという意味ではありません。

向く人/向かない人|どれを先に置くか

比較表の列をそのまま繰り返す代わりに、読者の状況で振り分けます。

Project Rules が向く人

  • Cursorの Agent にだけ、パス単位の制約を効かせたい人
  • 全体方針は別ファイルにあり、Cursor固有のルールだけ足したい人

Project Rules が向かない人

  • まだCursorを常用しておらず、先にリポジトリの入口方針だけ決めたい人
  • 書き方やテンプレートが主目的の人(その場合はRules Tipsが向いています)

AGENTS.md が向く人

  • Cursor以外のツール(Claude Codeなど)からも同じ禁止事項・委譲ルールを見たい人
  • 「正本はどこか」を1ファイルにまとめたい人

AGENTS.md が向かない人

  • Cursorのglob指定や手動ルールの置き場にしようとしている人
  • 入口ファイルに長文の手順を全部貼り、委譲先を持たない人

CLAUDE.md が向く人

  • このリポジトリでClaude Codeを使い、Claude固有の指示やAGENTS.mdの読み込み補助が必要な人
  • Cursor用の指示と文言を分けたい人(コピーではなく、入口+差分という形にしたい人)

CLAUDE.md が向かない人

  • Cursorのみを使っていて、ファイルを増やす理由がない人
  • 既存のAGENTS.mdだけで必要な指示が読み込まれており、Claude固有の追加指示もない人

迷ったときは、共通方針とCursor固有の指示を分け、Claude Codeを併用する場合は版・設定・既存ファイルに合わせてCLAUDE.mdの必要性を確認してください。

同じ指示を二重に書かない実務

Rules Tipsの失敗パターン集はここでは扱いません。本記事で足すのは、同じ意味の指示を2ファイルに置かない手順だけです。

  1. 正本を1つ決めます。方針はAGENTS.md、Cursor固有は.cursor/rules/、Claude Code向けの差分はCLAUDE.md、という分け方が一つの目安になります。
  2. 正本以外のファイルには、委譲であることが分かる1行だけを残します。本文をまるごと二重に貼りません。
  3. 指示を直したときは、同じ禁止事項や同じ手順が他のファイルに残っていないかを確認します。
  4. 確認は新規チャットで行うと、古い指示のキャッシュに引っ張られにくくなります。

ToolArcの公開リポジトリでは、ルートのAGENTS.mdを入口にし、記事ドメインの詳細は別ディレクトリへ委譲、Cursor向けの公開ルールは.cursor/rules/に置く、という分け方を採用しています。読者のリポジトリにそのままコピーする前提の型ではなく、あくまで分け方の一例です。

二重管理が起きると、指示の食い違いに加えて、読み込ませるtoken量が増えやすくなります。

次に読む|書き方(Rules Tips)かHubか

本記事は「どれを置くか」の判断を、表と向く人の整理だけで完結させています。次に読みたい記事は、目的によって分かれます。

  • .cursor/rulesの具体的な書き方やテンプレート、失敗パターンまで知りたい場合は、Rules Tipsが無料で読めます。本記事のテンプレートは繰り返さず、書き方はそちらに譲ります。
  • Cursorシリーズを読む順に迷っている場合は、Hub記事から入るとたどりやすくなります。
  • 拡張の入れすぎ判断は拡張機能のおすすめ、インデックスの詰まりはコードベースインデックスの確認へ。
  • Claude Codeをターミナル側で使う入口を知りたい場合は、Claude Codeガイドも参考になります。

本記事は2026-11-04にCursorとClaude Codeの公式文書を確認して更新しました。記載した条件を、すべての版・設定で実機検証したものではありません。仕様やUI名は変わるため、重要な判断は各ツールの公式文書と利用環境で確認してください。

  • Cursor
  • Cursor Rules
  • AGENTS.md
  • CLAUDE.md
  • 比較
  • cursor-free-series

※記事により広告・アフィリエイトリンクを含む場合があります。