公開日: 最終更新:
公式ドキュメント・公式発表などの一次情報を確認したうえで、株式会社Nexaが執筆・更新しています。AIツールの仕様や料金は変わることがあるため、導入判断の前に各公式サイトの最新情報もご確認ください。運営会社について
Claude CodeのMemory機能を活用すると、プロジェクトのルールや知見をセッションをまたいで自動継承できます。
- 要点1: CLAUDE.mdは「組織管理ポリシー→ユーザー→プロジェクト→ローカル」の順に読み込まれる4つの保存場所を持つ
- 要点2: CLAUDE.mdに命令形でルールを記述すると、セッション開始時にClaude Codeが自動的に読み込む
- 要点3: Auto Memory（MEMORY.md）はCLAUDE.mdとは別の仕組みで、あなたの訂正や好みをClaude Codeが自動で書き残す
対象: Claude Codeを業務・チーム開発に本格導入したいDX推進担当者・開発者
今日やること: プロジェクトルートにCLAUDE.mdを作成し、コーディング規約を5項目記述する
Claude CodeのMemory（メモリ）機能を正しく設計すれば、プロジェクトのルール・コーディング規約・チームの知見をセッションをまたいで自動継承でき、毎回同じ説明を繰り返す手間を省けます。
「Claude Codeを使い始めたが、セッションが変わるたびにルールの説明からやり直している」——こうした声は、Claude Codeを導入したチームから頻繁に聞かれます。Claude Codeはデフォルトではセッションをまたいで情報を保持しないため、適切なメモリ設計が必要です。
この記事では、Claude Codeが持つCLAUDE.mdの4段階の階層と読み込み順、具体的な書き方、そしてAuto Memory（MEMORY.md）の仕組みと活用法まで、チーム・企業規模での導入を見据えた実践的な設計手順を解説します。
Claude Codeのメモリ機能とは？なぜ重要なのか
Claude Codeのメモリ機能とは、プロジェクトのルール・コーディング規約・開発の知見をClaude Codeに「記憶」させておく仕組みです。適切に設定することで、毎回のセッション開始時にClaude Codeが自動的に文脈を把握し、一貫した品質の支援を受けられます。
デフォルトの状態——セッション終了でリセットされる課題
Claude Codeを何も設定せずに使うと、各セッションは独立した会話として扱われます。つまり、前のセッションで伝えた「このプロジェクトはPython 3.12を使う」「コメントは日本語で書く」「テストはpytestで実行する」といったルールは、次のセッションでは引き継がれません。
この状態での問題点は以下の3つです。
| 問題 | 影響 |
|---|---|
| 毎回の説明コスト | 同じルールをセッションごとに説明する時間が発生 |
| 品質のばらつき | 説明の漏れによって、期待と異なる出力が生じる |
| チーム間の不統一 | メンバーごとに異なる指示をしていると、コードスタイルがバラバラになる |
メモリ機能が解決する3つの問題
Claude Codeのメモリ機能を適切に設定することで、上記の問題を解決できます。
1. 説明コストの削減: CLAUDE.mdにプロジェクトルールを一度書けば、以降は自動的に読み込まれます。「毎回同じことを伝える」手間がなくなります。
2. 品質の一貫性確保: セッションをまたいでも同じルールが適用されるため、Claude Codeの出力品質が安定します。
3. チーム開発の標準化: CLAUDE.mdをGitリポジトリで共有することで、チームメンバー全員が同じルールのもとでClaude Codeを使えるようになります。
Claude CodeのCLAUDE.md階層とAuto Memoryを理解する
Claude Codeには「CLAUDE.mdファイル」と「Auto Memory」という2つの補完的なメモリの仕組みがあります。CLAUDE.mdは保存場所によって4段階に分かれ、Auto MemoryはCLAUDE.mdとは別に、Claude Codeが会話の中から自動でメモを作成する仕組みです。まずCLAUDE.mdの階層から見ていきます。
CLAUDE.mdの読み込み順（組織管理ポリシー → User → Project → Local）
CLAUDE.mdは以下の4つの場所に置くことができ、下表の順（広い範囲から狭い範囲へ）で会話に読み込まれます。すべて上書きではなく連結され、より具体的な設定ほど後段（会話の中でより直前）に読み込まれます。強制的な設定ではなくClaudeへの指示なので、矛盾する内容があるとどちらに従うかはClaude任せになる点に注意してください。
| 読み込み順 | 種類 | 説明 | 保存場所 |
|---|---|---|---|
| 1 | 組織管理ポリシー（Managed policy） | 組織全体のルール。IT管理者が構成管理ツールで配布し、個々の設定では除外できない | macOS: /Library/Application Support/ClaudeCode/CLAUDE.md（Linux/WSL・Windowsは別パス） |
| 2 | User instructions | 個人の設定・好み（全プロジェクト共通） | ~/.claude/CLAUDE.md |
| 2 | User-level Rules | プロジェクトを問わず適用される個人の条件付きルール | ~/.claude/rules/ 配下 |
| 3 | Project instructions | プロジェクト固有のルール。チームで共有 | プロジェクトルートの CLAUDE.md（.claude/CLAUDE.md でも可） |
| 3 | Project Rules | グロブパターンでファイルの種類を絞って条件付き適用できるルール | .claude/rules/ 配下 |
| 4 | Local instructions | 自分専用のプロジェクト固有設定。.gitignoreに追加してコミットしない | プロジェクトルートの CLAUDE.local.md |
Auto Memoryはこの4段階のCLAUDE.md階層には含まれない、まったく別の仕組みです。詳しくは「Auto Memory（MEMORY.md）」の章で解説します。
各メモリの役割と保存場所
組織管理ポリシー（読み込み順1）組織全体に適用する共通ルールです。セキュリティポリシー、コーディング標準、使用禁止ライブラリなど、すべてのプロジェクト・メンバーに強制適用したいルールを記述します。IT管理者がMDMやGroup Policyなどの構成管理ツールで配布するか、管理設定ファイルのclaudeMdキーに直接記述して展開します。
User instructions / User-level Rules（読み込み順2）個人の設定です。~/.claude/CLAUDE.mdに記述し、全プロジェクトに横断して適用されます。「回答は必ず日本語で」「コメントは日本語で書く」といった個人的な好みや習慣を設定します。
Project instructions / Project Rules（読み込み順3・最もよく使う層）プロジェクトごとの固有ルールです。プロジェクトルートに置いたCLAUDE.mdファイルがこれに相当します。GitリポジトリにコミットしてチームでClaude Codeへのルールを共有するのが一般的です。ファイルが肥大化してきたら.claude/rules/配下にテーマ別で分割できます。
Local instructions（読み込み順4）自分専用のプロジェクト固有設定です。プロジェクトルートのCLAUDE.local.mdに記述し、.gitignoreに加えてコミットしないのが基本です。サンドボックスのURLやテスト用データなど、チームに共有したくない個人設定を書きます。
どのメモリに何を書くべきか——判断基準
どの層にルールを記述すべきかは、以下の基準で判断します。
| 記述内容 | 適切なメモリ層 |
|---|---|
| 全社共通のセキュリティポリシー | 組織管理ポリシー |
| 使用禁止の外部ライブラリ | 組織管理ポリシー |
| プロジェクト固有のコーディング規約 | Project instructions（CLAUDE.md） |
| ビルド・テストコマンド | Project instructions（CLAUDE.md） |
| ディレクトリ構成のルール | Project instructions（CLAUDE.md） |
| 個人の応答スタイル設定 | User instructions（~/.claude/CLAUDE.md） |
| 個人で使うエイリアス・ショートカット | User instructions |
| 自分のサンドボックスURL・テスト用データ | Local instructions（CLAUDE.local.md） |
CLAUDE.mdの書き方実践ガイド
CLAUDE.mdはClaude Codeメモリ機能の中心的な存在です。プロジェクトのルールを明文化し、チーム全員が同じ条件でClaude Codeを使えるようにするための設定ファイルです。
基本構造とテンプレート
CLAUDE.mdはMarkdown形式で記述します。以下は実務で効果的な基本構造のテンプレートです。
# [プロジェクト名] 開発ルール
## 技術スタック
- 言語: Python 3.12
- フレームワーク: FastAPI 0.110
- テスト: pytest
- パッケージ管理: Poetry
## コーディング規約
- コメントは日本語で記述する
- 関数名・変数名は英語（スネークケース）を使用する
- 型ヒントを必ず付ける
- docstringはGoogle形式で記述する
## よく使うコマンド
- テスト実行: `poetry run pytest`
- サーバー起動: `poetry run uvicorn main:app --reload`
- リント: `poetry run ruff check .`
## ディレクトリ構成
- `src/`: ソースコード
- `tests/`: テストコード
- `docs/`: ドキュメント
## 注意事項
- 本番環境の認証情報を絶対にコードに含めない
- PRを出す前に必ずテストを通す
効果的な記述ルール
CLAUDE.mdを効果的に書くための3つのポイントを押さえてください。
1. 命令形で書く「このプロジェクトでは関数型コンポーネントを使っています」ではなく、「関数型コンポーネントを使う」と命令形で記述します。命令形はClaude Codeが拘束力のある指示として解釈するため、より確実に従ってくれます。
2. 200行以内に収める公式推奨は最大200行です。肥大化したCLAUDE.mdはコンテキストを圧迫し、かえって応答品質を下げる可能性があります。重要なルールのみを簡潔に記述することが重要です。
3. 具体的かつ明確に「コードをきれいに書く」ではなく「1関数あたりの行数は50行以内に収める」のように、具体的な基準を示します。曖昧な表現はClaude Codeの解釈にばらつきが生じます。
チーム開発でのCLAUDE.md共有方法
プロジェクトルートに置いたCLAUDE.mdをGitリポジトリにコミットすることで、チームメンバー全員がClaude Codeに同じルールを適用できます。
# CLAUDE.mdをリポジトリに追加
git add CLAUDE.md
git commit -m "Claude Code用のプロジェクトルールを追加"
git push
チームでの運用ポイントとして、CLAUDE.mdをコードレビューの対象にすることをおすすめします。ルールの変更は通常のコード変更と同様にPRで議論し、チーム全体で合意した上で更新することで、誰もが納得した状態でClaude Codeを活用できます。
また、CLAUDE.mdに書くべき内容は「Claude Codeが知らないとミスを犯す可能性のある情報」です。フレームワークのデフォルト設定、広く知られた規約などは書かなくても構いません。プロジェクト固有の決まりごとにフォーカスしてください。
Claude CodeのMemory設計について個別に相談したい方は、まずは無料相談からお気軽にお問い合わせください。
Auto Memory（MEMORY.md）——Claude Codeが自動で学習する仕組み
Auto Memoryは、CLAUDE.mdの4段階の階層とは別に用意された仕組みです。開発者が明示的に何も書かなくても、あなたが会話の中で行った訂正や伝えた好みをもとに、Claude Codeが自動的にMEMORY.mdというファイルへメモを書き残していきます。既定で有効になっています。
Auto Memoryが記録するもの——4つのカテゴリ
Auto Memoryが記録するのは、コードやgit履歴から読み取れない情報に限られます。ディレクトリ構成やアーキテクチャ、デバッグの修正内容など、コードベースを読めば分かることは記録の対象外です。記録される情報は次の4カテゴリに分類されます。
| 分類（type） | 記録される内容 |
|---|---|
| user | あなたの役割・専門性・仕事の進め方の好み |
| feedback | あなたがClaude Codeに行った訂正、確認した進め方 |
| project | 進行中の作業、締め切り、コードやgit履歴からは分からない決定事項 |
| reference | Issueトラッカーやダッシュボードなど、プロジェクト外の参照先 |
これらの情報は、プロジェクトごとに作成される~/.claude/projects/<プロジェクト名>/memory/フォルダに保存されます。フォルダ内には一覧となるMEMORY.mdと、メモリごとの個別ファイルが置かれます。同じGitリポジトリのworktreeやサブディレクトリはこのフォルダを共有しますが、他のマシンやクラウド環境とは共有されません。
MEMORY.mdの確認・編集方法（/memoryコマンド）
Auto Memoryの内容を確認・編集するには、Claude Codeのチャット内で/memoryコマンドを使います。
/memory
このコマンドを入力すると、CLAUDE.mdやAuto Memoryの保存場所が一覧表示され、Auto Memoryのオン・オフ切り替えや、メモリフォルダを開く操作ができます。ファイルを選ぶとエディタで開き、そのまま編集・削除できます。また、チャット内でClaude Codeに「これを覚えておいて」のように直接伝えると、その内容をAuto Memoryとして保存してくれます。CLAUDE.mdに追記したい場合は「CLAUDE.mdに追加して」のように伝えるか、/memoryコマンドでファイルを直接編集します。
なお、MEMORY.mdはセッション起動時に先頭200行、または25KBのいずれか早い方までが自動で読み込まれます。それを超えた情報は自動ではロードされないため、重要な情報は上部に配置し、詳細は個別のファイルに分けて整理することをおすすめします。
CLAUDE.mdとAuto Memoryの使い分け
CLAUDE.mdとAuto Memoryはどちらも「Claude Codeに情報を記憶させる」機能ですが、役割が異なります。
| 項目 | CLAUDE.md（手動設定） | Auto Memory（自動蓄積） |
|---|---|---|
| 記述者 | 人間が手動で記述 | Claude Codeが自動で記録 |
| 対象情報 | プロジェクトルール・規約（確定した事項） | コードから読み取れない好み・訂正・進行中の作業 |
| チーム共有 | Gitでコミットして共有できる | プロジェクト単位でマシンに保存（他のマシン・メンバーとは共有されない） |
| 読み込まれ方 | CLAUDE.mdファイル全文をセッション開始時に読み込み | MEMORY.mdの先頭200行（または25KB）をセッション開始時に読み込み |
| 管理 | 人間が定期的にメンテナンス | Claude Codeが自動更新 |
推奨の使い分け: チームで共有すべきルール・規約はCLAUDE.mdに手動で記述し、個人の開発セッションで発見したパターンや知見はAuto Memoryに任せるのが効率的です。
チーム・企業でのメモリ設計戦略
Claude CodeをTeamまたはEnterpriseプランで使う組織にとって、メモリ設計は「AIツールの恩恵を最大化するための基盤」です。適切に設計することで、チーム全体の開発生産性と品質を向上させられます。
組織管理ポリシー（Managed policy）で組織共通ルールを一元管理する
組織管理ポリシーのCLAUDE.mdは、IT管理者がMDMやGroup Policyなどの構成管理ツールで配布し、個々のユーザー設定では除外できない組織共通のルールを適用できます。主な活用例を示します。
セキュリティポリシーの統一
# セキュリティポリシー（全プロジェクト共通）
- APIキーや認証情報を絶対にコードに含めない
- 外部への機密情報送信を行うコードを生成しない
- 〇〇社の内部システムのURLをコードにハードコードしない
コーディング標準の強制
# 全社コーディング標準
- 変数名・関数名は英語で統一する
- コメントは日本語で記述する
- セキュリティ上のリスクがある処理には必ず警告コメントを付ける
組織管理ポリシーはCLAUDE.mdの中で最初に読み込まれ、個々の設定では除外できないため、組織として譲れないルールを確実に適用できます。
プロジェクト別CLAUDE.mdの設計パターン
複数プロジェクトを持つ組織では、プロジェクトの性質によってCLAUDE.mdの内容を変えます。以下は代表的な設計パターンです。
パターン1: バックエンドAPI開発プロジェクト技術スタック（言語・フレームワーク・DB）、APIの設計規約（RESTfulルール、エラーレスポンス形式）、テスト方針（カバレッジ目標、モック方針）を中心に記述します。
パターン2: フロントエンド開発プロジェクトUIコンポーネントの規約（Atomic Design等）、スタイリングルール（CSS-in-JS or CSS Modules等）、状態管理の方針を記述します。
パターン3: データ分析プロジェクト使用するライブラリのバージョン、データの命名規則、ノートブックの構成ルール、可視化の標準フォーマットを記述します。
新メンバーのオンボーディングにメモリを活用する
CLAUDE.mdはプロジェクトの「ルールブック」として機能するため、新メンバーのオンボーディングにも有効です。
新メンバーがプロジェクトにアサインされたとき、CLAUDE.mdが整備されているプロジェクトでは以下のメリットがあります。
- Claude Codeが自動的にプロジェクトルールを適用する: 新メンバーがルールを覚えていなくても、Claude Codeがサポートしてくれます
- ルールの明文化によるレビューコスト削減: 「なぜこうなっているのか」の説明がCLAUDE.mdに記載されていると、レビュアーの負担が下がります
- チームのノウハウ蓄積: 長年の開発で培った知見がCLAUDE.mdとMEMORY.mdに蓄積され、チームの資産になります
なお、CLAUDE.mdとAuto Memoryそのものはプランを問わず使える機能ですが、組織全体への一元配布（組織管理ポリシー）はIT管理者による構成管理を必要とするため、主にチーム・組織規模の導入で効果を発揮します。プランの詳細についてはClaude Code Team Plan完全ガイドを参照ください。
よくある質問
Q. Claude（チャット版）のメモリとClaude Codeのメモリは何が違う？
Claude（チャット版）のメモリ機能は、会話の内容（好み・個人情報・過去のやりとり）を記憶してパーソナライズするためのものです。一方、Claude Codeのメモリ機能（CLAUDE.md・Auto Memory）は、開発プロジェクトのルール・技術スタック・コーディング規約を記憶させるためのものです。目的と用途が異なります。
Q. CLAUDE.mdとAuto Memoryはどちらを優先すべき？
チームで共有すべき確定したルールはCLAUDE.mdに手動で記述してください。Auto Memoryはあくまで補完的な機能です。チーム全員に適用させたいルールはCLAUDE.mdに書き、Gitでコミットして共有する運用が基本です。
Q. メモリの内容を削除・リセットするには？
CLAUDE.mdは通常のテキストファイルなので、直接編集・削除できます。Auto Memory（MEMORY.md）は/memoryコマンドで確認・編集・削除が行えます。また、~/.claude/projects/<プロジェクト名>/memory/配下のファイルを直接削除することでリセットできます。
Q. Auto Memoryをオフにしたい場合の方法は？
Claude Codeのチャット内で/memoryコマンドを開き、Auto Memoryのトグルをオフにします。特定のプロジェクトだけオフにしたい場合はそのプロジェクトの設定ファイルに"autoMemoryEnabled": falseを設定する方法もあります。セキュリティポリシー上、Claude Codeへの自動学習を望まない場合や、開発環境を完全にクリーンな状態で使いたい場合に活用してください。
詳細な設定方法はClaude Code 設定完全ガイドをご参照ください。
＼ AI活用の「次の一手」を一緒に考えませんか ／
AI顧問の無料相談はこちらまとめ——メモリ設計がClaude Code活用の鍵
Claude Codeのメモリ機能について整理しました。
- CLAUDE.mdの4段階: 組織管理ポリシー→User→Project→Localの順に読み込まれる。自分の用途に合った層を選ぶことが重要
- CLAUDE.mdの書き方: 命令形で簡潔に、200行以内を目安に記述。Gitでコミットしてチームで共有するのが基本
- Auto Memory（MEMORY.md）: CLAUDE.mdとは別に、Claude Codeが会話から自動でメモを蓄積する機能。/memoryコマンドで確認・編集が可能
- チーム・企業での活用: 組織管理ポリシーで組織共通ルールを統一し、CLAUDE.mdでプロジェクト固有のルールを管理する
まずは~/.claude/CLAUDE.mdに個人設定（応答言語・コメント言語等）を書き、次にプロジェクトルートのCLAUDE.mdにプロジェクトルールを追加するところから始めてみてください。
CLAUDE.mdの書き方についてはClaude Code CLAUDE.md完全ガイドで詳しく解説しています。また、Claude Codeをさらに使いこなしたい方はClaude Code ベストプラクティス15選も参考にしてください。
Claude Codeの活用、何から始めればいい？
無料でClaude Codeの活用について相談に乗ります。お気軽にお問い合わせください。
法人向けAI導入・活用の月額伴走サービス
AI導入の疑問を、週1回のMTGで相談できる「AI顧問」
株式会社Nexaでは、ChatGPT・Claude・Claude CodeなどのAI導入に関する質問や、社内活用・業務自動化の進め方を週1回相談できる 月額7万円（毎月3社限定で月額5万円）のAI顧問サービス を提供しています。
「自社では何から始めるべきか」「この業務はAI化できるか」「どのツールを選ぶべきか」を、無料相談で整理します。
AI導入を検討中の方へ
