【2026年最新】CursorとClaude Codeの設定ファイル完全ガイド｜AIが生成するコード品質を劇的に向上させる方法
【2026年5月23日更新】
Cursor 3のBugBot・Background Agent対応、Claude CodeのOpus 4.7・Routines・Agent SDKなど2026年5月時点の最新情報を反映。設定ファイルの書き方と運用パターンを全面見直し。
CursorやClaude Codeの設定ファイルを書いていないプロジェクトで、Pages Routerのコードが出てきたり、SQLAlchemy 1.xの古い書き方が生成されたりする。原因は設定ファイルの不在だ。
AIコーディングツールはプロジェクトの文脈を知らなければ汎用的で古いパターンのコードを生成する。この問題を解決するのが、Cursorの.cursorrules/.mdcルールとClaude CodeのCLAUDE.mdだ。2026年5月時点ではCursor 3のBackground Agent対応やClaude Opus 4.7のAgent SDK連携など、設定ファイルの役割がさらに広がっている。この記事では、CursorとClaude Codeの設定ファイルの仕組みから書き方、即戦力になるおすすめの設定ファイル集まで実践的に解説する。
自分の場合、CLAUDE.mdを導入する前と後で手動修正の頻度が3割ほど減った。特にFastAPIプロジェクトでSQLAlchemy 2.0の非同期パターンが一発で出てくるようになったのが大きい。設定ファイルを書く30分の投資で、その後の数十時間分の修正コストが消える計算だ。
目次
1. なぜAIツールは「微妙な」コードを生成するのか
CursorもClaude Codeも、基盤となる大規模言語モデル（LLM）は膨大な量のコードで学習されている。学習データには古いバージョンのコードも大量に含まれており、明示的な指示がなければAIは「最も一般的なパターン」を採用する。設定ファイルなしでは、プロジェクト固有の技術スタックやバージョンを反映したコードは出てこない。
設定なしで起きる典型的な問題
- Next.js: App Routerではなく廃止予定のPages Router +
getServerSidePropsを生成 - SQLAlchemy: 2.0の非同期パターンではなく1.xの同期パターンを使用
- Pydantic: v2ではなくv1の
class Configパターンを生成 - TypeScript: strictモードの型注釈が抜ける、
any型を多用 - Stripe: Webhook署名検証やべき等性キーの実装が欠落
- Supabase: RLSポリシーの考慮が漏れ、セキュリティホールが発生
単にコードが動かないだけなら気付ける。厄介なのは、一見動くが本番では問題になるコードが生成されるケースだ。AI生成コードの修正に毎回20-30分取られているなら、設定ファイルの不備を疑ったほうがいい。
2. 設定ファイルがAI出力を変える仕組み
設定ファイルは、AIに対して「このプロジェクトではこのルールに従ってコードを書け」と事前に伝えるシステムプロンプトのようなものだ。CursorとClaude Codeでは、それぞれ異なる仕組みで設定ファイルを読み込む。
| 項目 | Cursor | Claude Code |
|---|---|---|
| 設定ファイル | .cursorrules + .cursor/rules/*.mdc |
CLAUDE.md |
| 読み込みタイミング | リクエスト時に自動付加 | 起動時に自動読み込み |
| 適用範囲 | グローバル / ファイルパターン別 | プロジェクト全体 |
| 形式 | YAML + Markdown（.mdc） | Markdown |
| バージョン管理 | Git対応（チーム共有可） | Git対応（チーム共有可） |
| 自律エージェント対応 | Background Agent / BugBot（Cursor 3〜） | Routines / Agent SDK / サブエージェント |
| 動的処理 | — | Hooks（settings.json）でツール実行前後にシェルコマンド |
ポイント
どちらのツールも、設定ファイルをGitで管理してチーム全員が同じルールでAIを使える。チーム全体のコード品質とスタイルの一貫性を高いレベルで維持できる点が最大の強みだ。
3. Cursor設定ファイル徹底解説｜.cursorrules・.mdcルール
2026年5月追記
Cursor 3（2026年4月リリース）ではBackground AgentとBugBotが追加された。設定ファイルはこれらの自律実行エージェントにも適用されるため、正確な.mdcルールの重要性が従来以上に高まっている。
.cursorrules（グローバルルール）
.cursorrulesはプロジェクトルートに配置するファイルで、全てのAIリクエストに自動的に付加される。プロジェクトの技術スタック、アーキテクチャルール、コーディング規約を定義する。
You are an expert in Next.js 15, TypeScript, Supabase, Tailwind CSS.
Key Principles:
- Always use App Router (app/, never pages/)
- Use Server Components by default
- TypeScript strict mode, no any types
- All database queries must respect RLS policies
.mdcルール（Project Rules）
.cursor/rules/ディレクトリに配置するモジュール式のルールファイルだ。YAML形式のメタデータ（フロントマター）とMarkdown形式の本文を組み合わせたハイブリッド形式で記述する。
---
description: Supabase database and auth rules
globs: **/*.{ts,tsx}
alwaysApply: false
---
# Supabase Rules
- Use createServerClient for server-side operations
- Always implement RLS policies for every table
- Use supabase.auth.getUser() not getSession()
.mdcルールの3つの適用モード
- alwaysApply: true - 全てのリクエストに常に適用
- globs指定 - 特定のファイルパターンにマッチした場合のみ適用
- description指定 - AIが関連性を判断して自動的に適用
Cursorは.cursorrulesから.mdcベースのProject Rulesへの移行を推奨している。.mdcルールはファイルパターンごとに適用を制御できるため、必要なルールだけをコンテキストに含め、不要なルールでAIを混乱させない。Cursor 3のBackground Agentは長時間の自律実行を行うため、設定ファイルの精度がそのまま出力品質に直結する。
4. Claude Code設定ファイル徹底解説｜CLAUDE.md
CLAUDE.mdはClaude Codeが起動時に自動的に読み込む設定ファイルだ。プロジェクトの文脈をAIに伝え、毎回の説明を不要にする「プロジェクトメモリ」として機能する。2026年5月時点では、グローバル（~/.claude/CLAUDE.md）・プロジェクトルート・サブディレクトリの3階層で設定ファイルを管理できる。
2026年5月追記
Claude Codeの設定ファイル体系は、静的ルール（CLAUDE.md）と動的処理（Hooks: settings.json）の2本立てになった。さらにRoutinesによる定期実行やAgent SDKでのカスタムエージェント構築にもCLAUDE.mdの設定が引き継がれる。
CLAUDE.mdに書くべき内容
技術スタック定義
使用するフレームワーク、言語バージョン、ORM、認証方式、決済システムを明記。
アーキテクチャルール
ディレクトリ構成、レイヤー構成、依存性注入パターン、エラーハンドリング方針。
コーディング規約
命名規則、型注釈ルール、インポート順序、禁止パターン（anyの使用禁止など）。
よく使うコマンド
テスト実行、ビルド、マイグレーション、デプロイのコマンドを記載しておくとAIが自動実行可能に。
注意: 書きすぎない
CLAUDE.mdに何でも詰め込むと、記載事項が多すぎてAIがコンテキストを無視する。必要な情報を端的に書くことが品質向上の鍵だ。プロジェクトに直接関係ない一般的なベストプラクティスは省略する。1ファイルあたり200行以内が目安。
スラッシュコマンドの活用
Claude Codeでは、.claude/commands/ディレクトリにMarkdownファイルを配置することで、カスタムスラッシュコマンドを定義できる。頻繁に行う操作をコマンド化しておくと、1回の入力で複雑なタスクが走る。
Supabase Authを使用した認証機能を追加してください。
要件:
- サーバーサイドミドルウェアでセッション検証
- getUser()を使用（getSession()は使わない）
- 保護ルートへの自動リダイレクト
- RLSポリシーの追加
5. Before/After実例｜設定ファイルでコードがこう変わる
設定ファイルの有無でAIの出力がどう変わるか。具体例で見る。
例1: Next.jsのデータフェッチ
設定なし（Before）
export async function getServerSideProps() {
const res = await fetch('...')
return { props: { data } }
}
設定あり（After）
export default async function Page() {
const supabase = await createClient()
const { data } = await supabase
.from('posts').select('*')
}
例2: FastAPIのエンドポイント
設定なし（Before）
@app.get("/users")
def get_users(db = Depends(get_db)):
return db.query(User).all()
設定あり（After）
@router.get("/users")
async def get_users(
session: AsyncSession = Depends(get_session),
) -> list[UserResponse]:
result = await session.execute(select(User))
return result.scalars().all()
ポイント
設定ファイルがあるだけで、AIは最新バージョンのAPI、適切な非同期パターン、正しい型注釈を自動的に使う。手動修正にかかる時間が目に見えて減る。
6. 自作 vs 既製品｜どちらが効率的か
設定ファイルは自作できる。ただし、フレームワークのベストプラクティス、セキュリティパターン、エッジケースを網羅した設定ファイルを一から作るには相当な時間と知識がいる。
| 比較項目 | 自作 | 既製品を活用 |
|---|---|---|
| 初期コスト | 無料（時間コスト大） | $19〜$29（即日利用） |
| 構築時間 | 数日〜数週間 | 数分（ドロップイン） |
| 網羅性 | 知識に依存 | 実プロジェクトで検証済み |
| セキュリティ考慮 | 見落としのリスク | Webhook検証・RLS等カバー |
| メンテナンス | 自己責任 | フレームワーク更新時に無料アップデート |
| カスタマイズ性 | 完全に自由 | 土台として活用 + 追記可能 |
おすすめのハイブリッドアプローチ
最も効率的なのは、既製の設定ファイル集を土台として導入し、その上にプロジェクト固有のルール（API設計方針、命名規則、特殊な要件など）を追記する方法だ。フレームワークのベストプラクティスは既製品に任せ、自分はプロジェクト固有のカスタマイズに集中する。
7. おすすめ設定ファイル集3選｜スタック別に紹介
設定ファイルを一から構築する時間がない人向けに、実プロジェクトで検証済みの設定ファイル集を3つ紹介する。いずれも買い切り型で、既存プロジェクトにそのままドロップインできる。
AI Dev Config Kit: Next.js Edition
Next.js 15 + Supabase + StripeのSaaS開発に完全特化した設定ファイル集。Cursor用の.cursorrulesと7つの.mdcルール、Claude Code用の821行のCLAUDE.mdと7つのスラッシュコマンドを収録。さらに本番用SQLスキーマ（RLS付き）やStripe Webhookハンドラなどのテンプレートも付属しています。
29ファイル
13,216行
25+スニペット
Supabase / Stripe
$29
買い切り
AI Dev Config Kit: Python/FastAPI Edition
FastAPI + SQLAlchemy 2.0 + Supabase + Stripeのバックエンド開発に特化。Claude Code用の2,527行のCLAUDE.mdは、非同期パターン、Pydantic v2、JWT認証まで詳細にカバー。Dockerマルチステージビルド、Alembicマイグレーション、pytestフィクスチャなど本番デプロイに必要なテンプレートも一式付属。
39ファイル
16,356行
38スニペット
FastAPI / SQLAlchemy
$29
買い切り
Cursor Rules Mega Pack
10以上のフレームワークをカバーする幅広いCursorルール集。Next.js、React、Vue/Nuxt、FastAPI、Django、Express、Go/Gin、Rails、Laravelに加え、Supabase、Prisma、Drizzle、Stripe、Tailwind CSS、pytest、Playwright等の30の.mdcルールと5つのマスター.cursorrulesを収録。複数スタックで開発するフリーランスやエージェンシーに最適です。
37ファイル
13,500+行
30 .mdcルール
+ 5マスター設定
$19
買い切り
どれを選ぶべき？
- Next.js + Supabase + StripeでSaaS開発 → Next.js Edition ($29)
- FastAPI + SQLAlchemyでバックエンド開発 → Python/FastAPI Edition ($29)
- 複数のフレームワークを横断的に使う → Cursor Rules Mega Pack ($19)
- フルスタック（Next.js + FastAPI）で開発 → 両エディション購入がベスト
8. よくある質問（FAQ）
Q. 既存のプロジェクトにも使えますか？
使える。設定ファイルは既存プロジェクトにドロップイン（ファイルを配置するだけ）で動く。コードの変更は不要で、次のAIリクエストから即座に効果が反映される。
Q. CursorとClaude Code両方で使えますか？
AI Dev Config Kit（Next.js / Python両エディション）はCursorとClaude Codeの両方に対応した設定ファイルを収録している。Cursor Rules Mega PackはCursor専用だ。
Q. フレームワークのバージョンが上がったらどうなりますか？
いずれの製品もフレームワークのメジャーバージョンアップ時に無料アップデートが提供される。Gumroad経由で最新版をダウンロードできる。
Q. 商用利用（クライアントワーク）はできますか？
全ての製品で個人・商用プロジェクトでの無制限利用が許可されている。設定ファイル自体の再配布・転売は禁止。
9. まとめ
CursorやClaude Codeの設定ファイルは、AIコーディングツールの出力品質を劇的に向上させる最もコスパの高い投資だ。適切な設定ファイルがあるだけで、古いパターンやセキュリティの考慮漏れが解消され、手動修正の時間が目に見えて減る。
この記事のポイント
- AIツールが古いコードを生成するのは設定ファイルの不在が原因
- Cursorは
.cursorrulesと.mdcルール、Claude CodeはCLAUDE.mdで制御 - .mdcルールはファイルパターン別に適用を制御でき、今後の推奨形式
- 既製の設定ファイル集を土台にカスタマイズするハイブリッドアプローチが最も効率的
- 設定ファイルはGitで管理し、チーム全体のコード品質を統一できる
2026年5月時点では、Cursor 3のBackground AgentやClaude CodeのRoutinesなど、AIが長時間自律的にコードを書く場面が増えた。設定ファイルの精度がそのまま成果物の品質を決める時代だ。
この記事に関連するおすすめ書籍
この一冊で全部わかる ChatGPT & Copilotの教科書
生成AIツールを使いこなす
ChatGPTとCopilotの基本から応用まで、ビジネスパーソン向けに分かりやすく解説した入門書。
Amazonで詳細を見る※ 上記はAmazonアソシエイトリンクです