この記事で紹介する Cursor / Claude Code × MCP 連携をさらに活用するなら pay-per-call-mcp もチェックしてください。Web検索・メール調査・請求書検証を Claude / Cursor が自律で実行できます。

npm: https://www.npmjs.com/package/pay-per-call-mcp
Discord: https://discord.gg/JBekn3EF

この記事でわかること

Cursor Rules（.cursor/rules/）と CLAUDE.md の根本的な違い
Cursor Rules の 3 種類（Always / Auto Attached / Agent Requested）の使い分け
「なぜか Cursor の精度が落ちてきた」を解決する Rules 設計のコツ
CLAUDE.md から Cursor Rules に移行するときの変換パターン
両ツールを併用するチームが採用している共通ルール管理の実例

はじめに

「CLAUDE.md を整理したら Claude Code の精度が上がった」という記事を書いたところ、「Cursor でも同じことをやりたい」という声を多くいただきました。

しかし Cursor Rules は CLAUDE.md とかなり設計思想が違います。同じノリで書くと期待通りに動かないことが多いです。

この記事では、両者の違いを整理した上で、Cursor Rules の効果的な設計方法を解説します。

Cursor Rules と CLAUDE.md の根本的な違い

	CLAUDE.md	Cursor Rules
読み込みタイミング	毎ターン常に読む	ルールの種類によって変わる
適用スコープ	ファイル単位（グローバル / プロジェクト）	ルールの種類で制御
ファイル形式	Markdown	`.mdc`（Markdown + メタデータ）
条件分岐	できない	ファイルパターンで自動適用できる
最大推奨サイズ	60行以下	ルールあたり 500 行以下

最大の違いは「Cursor Rules は場面によって自動的に切り替わる」点です。

Cursor Rules の 3 種類

1. Always（常時適用）

.cursor/rules/always.mdc

---
alwaysApply: true
---

# 絶対ルール

1. `any` 型禁止。`unknown` + type guard を使う
2. コミット前に `npm test` を通す
3. 外部 API 呼び出しには必ずリトライ処理を入れる

使い所: プロジェクト全体で守るべき最重要ルール。3〜5個まで。

2. Auto Attached（ファイルパターンで自動適用）

.cursor/rules/react-components.mdc

---
globs: ["src/components/**/*.tsx", "src/app/**/*.tsx"]
---

# React コンポーネントルール

- Props は interface で定義（type は使わない）
- `use client` は必要な場合のみ（デフォルトは Server Component）
- スタイルは Tailwind のみ（styled-components 禁止）
- コンポーネント名はファイル名と一致させる

.cursor/rules/api-routes.mdc

---
globs: ["src/app/api/**/*.ts", "src/server/**/*.ts"]
---

# API ルールール

- 全エンドポイントで zod バリデーションを使う
- レスポンスは `{ data, error }` 形式に統一
- 認証チェックは middleware で行う（個別ルートでしない）
- エラーログは logger.ts を使う（console.error 禁止）

使い所: フロントエンドとバックエンドで異なるルールがある場合。ファイルを開いた瞬間に自動で適用される。

3. Agent Requested（エージェントが必要と判断したときだけ）

.cursor/rules/database-patterns.mdc

---
description: "Prisma や SQL を使うタスクのときに参照するDB操作ルール"
---

# データベース操作ルール

- N+1 クエリ禁止。`include` / `select` で関連データを一括取得
- トランザクションは `prisma.$transaction` を使う
- マイグレーションは `prisma migrate dev` のみ（直接 SQL 禁止）
- 本番 DB への直接 write は禁止。必ず確認を求める

使い所: 特定の技術領域のルール。DB、認証、決済など。Cursor が「今これが必要」と判断したときだけロードされる。

よくある失敗パターン

❌ 全部 Always に入れてしまう

---
alwaysApply: true
---

# ルール（300行）

## TypeScript
...（50行）

## React
...（80行）

## API
...（70行）

## DB
...（100行）

毎ターン 300 行が丸ごとコンテキストに入るため、精度が落ちます。

✅ 正しい分割

.cursor/rules/
├── critical.mdc          （alwaysApply: true、10行以内）
├── typescript.mdc        （globs: **/*.ts, *.tsx）
├── react.mdc             （globs: src/components/**）
├── api.mdc               （globs: src/app/api/**）
├── database.mdc          （description: DB操作時に参照）
└── commit.mdc            （description: コミット時に参照）

CLAUDE.md からの移行パターン

Before（CLAUDE.md）

## コーディングルール
- TypeScript の any 禁止
- React は Server Component デフォルト
- API は zod バリデーション必須
- DB は Prisma 使用

## コミット規約
- feat: / fix: / docs: を使う
- 50文字以内

## 禁止事項
- console.log を残さない
- magic number 禁止

After（Cursor Rules）

critical.mdc（alwaysApply: true）
→ any 禁止、console.log 禁止の2つだけ

typescript.mdc（globs: **/*.ts）
→ TypeScript 固有ルール

react.mdc（globs: src/**/*.tsx）
→ React / Server Component ルール

api.mdc（globs: src/app/api/**）
→ zod・レスポンス形式

commit.mdc（description: コミット作成時）
→ コミット規約

両ツール併用チームの構成例

Claude Code と Cursor を両方使うチームでよく見られる構成：

project/
├── CLAUDE.md                    ← Claude Code 用（共通最重要ルール）
├── .cursor/
│   └── rules/
│       ├── critical.mdc         ← Cursor 用必須ルール
│       ├── frontend.mdc         ← フロントエンド専用
│       └── backend.mdc          ← バックエンド専用
└── .claude/
    └── rules/
        ├── coding-style.md      ← @include でCLAUDE.mdから参照
        └── commit.md

共通ルールは .claude/rules/shared.md に書いて、CLAUDE.md と Cursor Rules の両方から参照する形にすると管理コストが最小になります。

まとめ

やること	CLAUDE.md	Cursor Rules
全体の最重要ルール	✅	`alwaysApply: true`
ファイル種別ごとのルール	`@include` で分割	`globs` で自動切替
特定技術のルール	`@include`	`description` で Agent Requested
ルールの優先度	書く順序	`alwaysApply` > `globs` > `description`

Cursor Rules の設計ポイントは「常に読ませるルールを最小限にして、必要なときだけ読み込む」です。CLAUDE.md と同じ原則ですが、Cursor は globs という強力な自動振り分け機能があるため、より細かく制御できます。

よくある質問（FAQ）

Q. .cursorrules（旧形式）と .cursor/rules/ はどちらを使うべきですか？
A. .cursor/rules/ を推奨します。旧形式の .cursorrules は単一ファイルで Always 相当の動作のみです。新形式は複数ファイルに分割でき、Auto Attached / Agent Requested が使えます。

Q. Cursor Rules は .gitignore に入れるべきですか？
A. チームで共有するルールはコミット推奨です。個人設定（フォント・テーマなど）は .gitignore に入れてください。

Q. CLAUDE.md と Cursor Rules に同じルールを二重管理するのは辛いです。
A. 共通ルールを独立したファイル（例: .ai-rules/common.md）に書き、CLAUDE.md は @include、Cursor Rules は globs: [".ai-rules/**"] で参照する方法があります。

Q. Cursor Rules の文字数制限はありますか？
A. 公式の制限はありませんが、1ファイルあたり 500 行以下を推奨します。それ以上になるとコンテキスト消費が増え精度が落ちます。