Cursorの .cursorrules ファイルとClaude Codeの CLAUDE.md は同じ問題を解決します——AIアシスタントに永続的なプロジェクトコンテキストとコーディング規約を与えること——ですが、異なる前提で作られています。移行はほぼ機械的ですが、直接コピー&ペーストしても期待通りに動作しない箇所がいくつかあります。
このガイドでは完全な移行手順を説明します：直接変換できるもの、書き直しが必要なもの、そして両ツールをサポートする必要がある場合に両方で動く設定の作り方まで。
始める前に：現状を把握する
.cursorrules ファイル（または新しいMDCフォーマットに移行済みであれば .cursor/rules/ ディレクトリ）を開き、内容を4つのカテゴリに分類します：
- ロール定義 — 「あなたはTypeScriptの専門家開発者です…」
- コードスタイルルール — インデント、命名規約、インポート順序
- プロジェクト固有のコンテキスト — アーキテクチャの決定、主要ファイル、ドメインコンセプト
- 行動指示 — 「ファイルを削除する前に必ず確認する」「関数型スタイルを好む」
4つのカテゴリすべてが CLAUDE.md に変換できます。主な違いは、CLAUDE.md が .cursorrules ファイルでよく見られる自由な段落スタイルよりも、構造化された具体的な指示を好む傾向があることです。
Step 1: CLAUDE.md を作成する
まだ CLAUDE.md がなければ、プロジェクトルートに作成します：
touch CLAUDE.mdClaude Codeで最もよく機能する構造：
# プロジェクト名
このプロジェクトが何であるかの1文説明。
## テックスタック
- ランタイム: Node.js 22
- フレームワーク: Next.js 15（App Router）
- 言語: TypeScript 5.4
- データベース: PostgreSQL via Prisma
- テスト: Vitest + Playwright
## アーキテクチャ
プロジェクトの構成についての簡単な説明。主なエントリポイントはどこか？主要な抽象化は何か？
## コードスタイル
具体的で実施可能なルール。曖昧な好みは書かない。
## 主要ファイル
変更を加える前に理解することが重要なファイル。
## 一般的なタスク
テストの実行方法、ビルド方法、デプロイ方法。
## 規約
コードを読んだだけでは明らかではないプロジェクト固有の決定事項。Step 2: ロール定義を変換する
.cursorrules ファイルはロールプロンプトで始まることが多いです：
You are an expert TypeScript developer with deep knowledge of React and Next.js best practices. You write clean, maintainable code and always consider performance implications.CLAUDE.md では、ロールの枠組みは削除します。Claude Codeは、IDEアシスタントと同じ方法でペルソナの割り当てに反応しません。代わりに、直接的な指示を書きます：
変換前（cursorrulesスタイル）：
You are an expert TypeScript developer who always uses proper types and never uses `any`.変換後（CLAUDE.mdスタイル）：
## コードスタイル
- TypeScript: `any` 型禁止。型が本当に不明な場合は `unknown` を使って絞り込む。
- すべての関数に明示的な戻り値の型が必要。
- リテラル値には `const` アサーションを好む。行動上の結果は同じです。2番目のバージョンは何を求めているかについてより直接的です。
Step 3: コードスタイルルールを変換する
コードスタイルルールはほぼそのまま変換できます。主な変更点は、フラットリストではなく明確なヘッダーの下に整理することです。
変換前：
Always use 2-space indentation.
Use single quotes for strings.
Add trailing commas in multi-line expressions.
Use async/await instead of .then() chains.
Prefer named exports over default exports.変換後：
## コードスタイル
### フォーマット
- 2スペースインデント
- 文字列にはシングルクォート
- 複数行の式にはトレーリングカンマ（ES5互換）
### JavaScript/TypeScriptパターン
- `async`/`await` のみ——`.then()` チェーン禁止
- デフォルトエクスポートより名前付きエクスポートを好む
- ネストを減らすためにearly returnを使う整理することで、Claudeが特定のルールを参照する必要があるときに役立ちます。40個のルールのフラットリストは、グループ化されたカテゴリより扱いにくくなります。
Step 4: プロジェクト固有のコンテキストを変換する
このセクションが移行で最も恩恵を受ける部分です。CLAUDE.md は、Claude Codeがコードベースで自律的に作業するために必要なコンテキストを与える場所です——そしてそれには、CursorがリアルタイムのIDEファイルツリーアクセスを持っているため通常必要とするより多くの詳細が必要です。
変換前（cursorrules）：
This is a SaaS application for managing construction projects.
The main data model is organized around Projects, which contain Tasks and Documents.変換後（CLAUDE.md）：
## アーキテクチャ
これは建設プロジェクト管理のためのマルチテナントSaaSアプリケーションです。
### ドメインモデル
- **Workspace**: 最上位のテナントコンテナ
- **Project**: ワークスペース内の建設プロジェクト
- **Task**: プロジェクト内の作業アイテム（ステータス、担当者、期限日あり）
- **Document**: プロジェクトまたはタスクにリンクされたファイル添付
### 主要ファイル
- `src/lib/db/schema.prisma` — 完全なデータベーススキーマ
- `src/lib/auth/` — 認証・認可ロジック
- `src/app/api/` — すべてのAPIルート
- `src/components/ui/` — 共有UIコンポーネント（使用箇所を確認せずに変更しない）
### マルチテナンシー
すべてのデータベースクエリは `workspaceId` でフィルタリングする必要があります。`withWorkspace()` ヘルパーがこれを強制します。テナントをまたいでクエリしないこと。明示的なファイルパス、マルチテナンシーへの警告、主要な抽象化——これがClaude Codeをあなたのプロジェクトで常に明確化の質問をせずに作業させるためのコンテキストです。
Step 5: 行動指示を変換する
「削除する前に確認する」や「イミュータブルパターンを好む」などの行動指示もそのまま変換できますが、スコープについて具体的に書きます：
変換前：
Always ask before making large refactors.
Never modify the database schema without discussion.変換後：
## 作業規約
- 3ファイル以上をリファクタリングする前に、計画を説明して確認を求める。
- `schema.prisma` への変更は明示的な承認が必要。他の作業の副作用としてスキーマを変更しないこと。
- `src/lib/` へのすべての変更後に `npm test` を実行する。テストを失敗したまま残さないこと。2番目のバージョンは実行可能です。「大規模なリファクタリング」は曖昧です；「3ファイル以上」はそうではありません。
Step 6: Cursor固有の指示を処理する
.cursorrules の一部の内容はCursor固有であり、変換できません：
削除するもの：
- Cursorのインライン提案への参照（「コードを提案するときは、ゴーストテキストスタイルを使う」）
- CursorのUI固有の動作（「チャットパネルでは、簡潔な回答を好む」）
- Cursor固有の @ メンション（「@fileを使ったとき、何をしているか説明して」）
これらはClaude Codeには意味がありません。削除してください。根本的な意図が重要な場合は、一般的な行動指示として言い直してください。
見直すもの：
- diffの表示対フルファイルについての指示——Claude Codeにはここで独自の動作がある
- リクエスト外のファイルを変更しないことについての指示——Claude Codeはすでにこれに従う傾向があるため、繰り返す必要がないかもしれない
完全な変換例
典型的なReactプロジェクトの変換前後：
変換前（.cursorrules）：
You are an expert React developer who writes clean, accessible, and performant code.
Always use TypeScript. Never use `any`.
Use functional components only. No class components.
Use React hooks for state management. Avoid Redux unless the project already uses it.
Follow WCAG 2.1 AA accessibility standards.
Use Tailwind CSS for styling. No CSS modules or styled-components.
Write tests for all components using React Testing Library.
Always handle loading and error states.
Import from '@/' using the configured alias.
Do not use default exports for components.変換後（CLAUDE.md）：
# Reactダッシュボード
マーケティングチーム向けの社内分析ダッシュボード。
## テックスタック
- React 19 + TypeScript 5.4
- Tailwind CSS v4
- React Testing Library + Vitest
- パスエイリアス: `@/` → `src/`
## コンポーネントルール
- 関数コンポーネントのみ（クラスコンポーネント禁止）
- 名前付きエクスポートのみ（デフォルトエクスポート禁止）
- Propsインターフェースはインラインではなくコンポーネントの上に定義
## TypeScript
- `any` 禁止。本当に不明な値には `unknown` + 型絞り込みを使う。
- すべてのコンポーネントのPropsは明示的に型付けする。
## スタイリング
- Tailwind CSSのみ。CSSモジュール、styled-components、インラインスタイル禁止。
- 条件付きクラスには `src/lib/utils` の `cn()` ユーティリティを使う。
## 状態管理
- ローカル状態にはReactフック
- サーバー状態にはReact Query
- Reduxなし（このプロジェクトには含まれていない）
## テスト
- すべてのコンポーネントにReact Testing Library
- ローディング状態、エラー状態、空状態を明示的にテストする
- テストはコンポーネントと同じ場所に配置: `Button.tsx` → `Button.test.tsx`
## アクセシビリティ
- WCAG 2.1 AA必須
- すべてのインタラクティブ要素にアクセシブルな名前が必要
- ARIAに頼る前にセマンティックなHTML要素を使う
## 規約
- ローディング状態とエラー状態は必ず処理する。データが常に存在すると仮定するコンポーネントを作らない。
- インポートには常に `@/` を使う。1つ以上の上位ディレクトリを移動する相対インポートなし。CLAUDE.md バージョンの方が長いですが、すべての行が機能しています。
両ツールのサポート：AGENTS.mdアプローチ
チームがCursorとClaude Codeの両方を使っている場合、プロジェクトルートの AGENTS.md にシングルソースオブトゥルースを維持します。両方のツールがこのファイルを読みます。
# agents
## default
description: このプロジェクトの汎用コーディングアシスタント
tools: read, write, bash, edit次に、CLAUDE.md と同じ構造を使って共有プロジェクトコンテキストを AGENTS.md に入れます。CursorがコンテンツをReadし、Claude CodeもコンテンツをReadします。2つのファイルを管理する代わりに1つで済みます。
統合できないツール固有の動作については、別ファイルを維持します：
AGENTS.md— 共有コンテキスト、アーキテクチャ、コードスタイルCLAUDE.md— Claude Code固有の設定（サブエージェント設定、フックスクリプト、ツール権限）.cursor/rules/— Cursor固有のルール（インライン提案の動作、パネルの設定）
移行後
実際のタスクでテストしましょう。Claude Codeにプロジェクト構造の理解が必要な小さな機能を実装するように依頼します。以下を確認してください：
- 思い出させなくても命名規約に従っているか
- 正しいインポートパスを使っているか
- あなたが文書化したエッジケースを処理しているか
- 規約が要求するときに確認を求めるか
何か間違えた場合は、CLAUDE.md に明示的に追加します。移行が機能している状態は、Claude Codeの最初の試みがあなた自身が書いたものと一致しているときです。