Claude Code Memory完全ガイド|6種類のメモリ設計と企業活用法【2026年版】

Claude Code memory機能のイメージ画像

Claude CodeのMemory機能を活用すると、プロジェクトのルールや知見をセッションをまたいで自動継承できます。

  • 要点1: メモリには6種類の階層があり、Enterprise > Project > User > Localの優先順位で管理される
  • 要点2: CLAUDE.mdに命令形でルールを記述すると、セッション開始時にClaude Codeが自動的に読み込む
  • 要点3: Auto Memory(MEMORY.md)はv2.1.32以降で利用でき、Claude Codeがビルドコマンドや開発パターンを自動蓄積する

対象: Claude Codeを業務・チーム開発に本格導入したいDX推進担当者・開発者

今日やること: プロジェクトルートにCLAUDE.mdを作成し、コーディング規約を5項目記述する

Claude CodeのMemory(メモリ)機能を正しく設計すれば、プロジェクトのルール・コーディング規約・チームの知見をセッションをまたいで自動継承でき、毎回同じ説明を繰り返す手間を省けます。

「Claude Codeを使い始めたが、セッションが変わるたびにルールの説明からやり直している」——こうした声は、Claude Codeを導入したチームから頻繁に聞かれます。Claude Codeはデフォルトではセッションをまたいで情報を保持しないため、適切なメモリ設計が必要です。

この記事では、Claude Codeが持つ6種類のメモリの仕組みと優先順位、CLAUDE.mdの具体的な書き方、そして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の6種類のメモリを理解する

Claude Codeには、用途と適用範囲が異なる6種類のメモリがあります。この階層構造を理解することが、効果的なメモリ設計の出発点です。

メモリ階層の優先順位(Enterprise > Project > User > Local)

6種類のメモリは、以下の優先順位で適用されます。上位のメモリほど優先度が高く、下位の設定を上書きします。

優先順位 メモリの種類 説明 保存場所
1 Enterprise Memory 組織全体のルール。管理者が設定し、全メンバーに適用 Enterprise管理者が設定
2 Project Memory プロジェクト固有のルール(CLAUDE.md) プロジェクトルートの CLAUDE.md
2 Project Rules グロブパターンで条件付き適用できるルール /.claude/rules/ 配下
3 User Memory 個人の設定・好み(全プロジェクト共通) ~/.claude/CLAUDE.md
3 User-level Rules 個人の条件付きルール ~/.claude/rules/ 配下
4 Local(Auto Memory) Claude Codeが自動で学習・蓄積する知見 ~/.claude/projects/[プロジェクトパス]/MEMORY.md

各メモリの役割と保存場所

Enterprise Memory(最優先)組織全体に適用する共通ルールです。セキュリティポリシー、コーディング標準、使用禁止ライブラリなど、すべてのプロジェクト・メンバーに強制適用したいルールを記述します。EnterpriseプランでのみClaude管理コンソールから設定できます。

Project Memory / Project Rules(第2優先)プロジェクトごとの固有ルールです。最もよく使うメモリ層で、プロジェクトルートに置いたCLAUDE.mdファイルがこれに相当します。GitリポジトリにコミットしてチームでClaude Codeへのルールを共有するのが一般的です。

User Memory / User-level Rules(第3優先)個人の設定です。~/.claude/CLAUDE.mdに記述し、全プロジェクトに横断して適用されます。「回答は必ず日本語で」「コメントは日本語で書く」といった個人的な好みや習慣を設定します。

Local / Auto Memory(補完的)Claude Codeがセッション中に学習した知見を自動で蓄積する層です。後述するAuto Memory機能がこれにあたります。

どのメモリに何を書くべきか——判断基準

どの層にルールを記述すべきかは、以下の基準で判断します。

記述内容 適切なメモリ層
全社共通のセキュリティポリシー Enterprise Memory
使用禁止の外部ライブラリ Enterprise Memory
プロジェクト固有のコーディング規約 Project Memory(CLAUDE.md)
ビルド・テストコマンド Project Memory(CLAUDE.md)
ディレクトリ構成のルール Project Memory(CLAUDE.md)
個人の応答スタイル設定 User Memory(~/.claude/CLAUDE.md)
個人で使うエイリアス・ショートカット User Memory

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設計について個別に相談したい方は、まずは無料相談からお気軽にお問い合わせください。

Claude Code活用の無料相談はこちら →

Auto Memory(MEMORY.md)——Claude Codeが自動で学習する仕組み

Auto Memoryは、Claude Code v2.1.32で追加され、v2.1.59以降でデフォルト有効になった機能です。開発者が明示的に何も書かなくても、Claude Codeがセッション中に学習した知見を自動的にMEMORY.mdというファイルに蓄積していきます。

Auto Memoryが記録するもの——ビルドコマンド、デバッグ知見、コードスタイル

Auto Memoryが自動で記録する主な内容は以下の通りです。

記録される情報 具体例
ビルド・実行コマンド 「このプロジェクトはnpm run devで起動する」
デバッグの知見 「〇〇のエラーは△△の設定を変更すると解消する」
コードスタイルの観察 「このプロジェクトはセミコロンなしのJavaScriptを使っている」
アーキテクチャの理解 「APIは/src/api/配下、DBの接続は/src/db/で管理されている」
繰り返し修正したパターン 「〇〇の書き方は毎回修正が入るため、△△形式で統一する」

これらの情報は~/.claude/projects/[プロジェクトの絶対パスをハイフン区切りにしたもの]/MEMORY.mdに保存されます。

MEMORY.mdの確認・編集方法(/memoryコマンド)

Auto Memoryの内容を確認・編集するには、Claude Codeのチャット内で/memoryコマンドを使います。

/memory

このコマンドを入力すると、現在蓄積されているメモリの内容が表示され、編集・削除も行えます。また、手動でメモリを追加したい場合は、チャット内で#(シャープとスペース)の後にメモリさせたい内容を書くことで追加できます。

# このプロジェクトのテストは必ずモックを使うこと

なお、MEMORY.mdはセッション起動時に先頭200行のみが自動で読み込まれます。200行を超えた情報は自動ではロードされないため、重要な情報は上部に配置するか、定期的に整理することをおすすめします。

CLAUDE.mdとAuto Memoryの使い分け

CLAUDE.mdとAuto Memoryはどちらも「Claude Codeに情報を記憶させる」機能ですが、役割が異なります。

項目 CLAUDE.md(手動設定) Auto Memory(自動蓄積)
記述者 人間が手動で記述 Claude Codeが自動で記録
対象情報 プロジェクトルール・規約(確定した事項) 作業中に発見された知見・パターン
チーム共有 Gitでコミットして共有できる 個人の~/.claudeに保存(共有不可)
優先順位 Project Memoryとして高い優先度 Localとして補完的な位置づけ
管理 人間が定期的にメンテナンス Claude Codeが自動更新

推奨の使い分け: チームで共有すべきルール・規約はCLAUDE.mdに手動で記述し、個人の開発セッションで発見したパターンや知見はAuto Memoryに任せるのが効率的です。

チーム・企業でのメモリ設計戦略

Claude CodeをTeamまたはEnterpriseプランで使う組織にとって、メモリ設計は「AIツールの恩恵を最大化するための基盤」です。適切に設計することで、チーム全体の開発生産性と品質を向上させられます。

Enterprise Memoryで組織共通ルールを一元管理する

EnterpriseプランのEnterprise Memoryは、管理者がすべてのユーザーに強制適用できる組織共通のルールを設定できます。主な活用例を示します。

セキュリティポリシーの統一

# セキュリティポリシー(全プロジェクト共通)
- APIキーや認証情報を絶対にコードに含めない
- 外部への機密情報送信を行うコードを生成しない
- 〇〇社の内部システムのURLをコードにハードコードしない

コーディング標準の強制

# 全社コーディング標準
- 変数名・関数名は英語で統一する
- コメントは日本語で記述する
- セキュリティ上のリスクがある処理には必ず警告コメントを付ける

Enterprise Memoryはプロジェクト単位の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に蓄積され、チームの資産になります

なお、Team・Enterpriseプランではいずれも、Claude CodeへのMemory機能へのアクセスが含まれています。プランの詳細については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.mdファイルを直接削除することでリセットできます。

Q. Auto Memoryをオフにしたい場合の方法は?

Claude Codeの設定(/settingsコマンドまたはsettings.jsonファイル)からAuto Memoryをオフにできます。セキュリティポリシー上、Claude Codeへの自動学習を望まない場合や、開発環境を完全にクリーンな状態で使いたい場合に活用してください。

詳細な設定方法はClaude Code 設定完全ガイドをご参照ください。

まとめ——メモリ設計がClaude Code活用の鍵

Claude Codeのメモリ機能について整理しました。

  • 6種類のメモリ階層: Enterprise > Project > User > Localの優先順位で管理。自分の用途に合った層を選ぶことが重要
  • CLAUDE.mdの書き方: 命令形で簡潔に、200行以内を目安に記述。Gitでコミットしてチームで共有するのが基本
  • Auto Memory(MEMORY.md): Claude Codeが自動で学習・蓄積する機能。/memoryコマンドで確認・編集が可能
  • チーム・企業での活用: Enterprise Memoryで組織共通ルールを統一し、CLAUDE.mdでプロジェクト固有のルールを管理する

まずは~/.claude/CLAUDE.mdに個人設定(応答言語・コメント言語等)を書き、次にプロジェクトルートのCLAUDE.mdにプロジェクトルールを追加するところから始めてみてください。

CLAUDE.mdの書き方についてはClaude Code CLAUDE.md完全ガイドで詳しく解説しています。また、Claude Codeをさらに使いこなしたい方はClaude Code ベストプラクティス15選も参考にしてください。

Claude Codeの活用、何から始めればいい?

無料でClaude Codeの活用について相談に乗ります。お気軽にお問い合わせください。

無料相談はこちら →




この記事の監修者

川島陸

株式会社Nexa 代表取締役

川島 陸

一橋大学経済学部卒業後、フォーティエンスコンサルティング株式会社(旧 株式会社クニエ)にて法人向けAI導入支援等を経験。独立後、AI系メディア運営やDify/n8nの導入支援を経て、株式会社Nexaを創業。法人向けAI研修・AI導入支援・AI関連メディア運営を手掛ける。

関連記事

AIの力で、ビジネスを次のステージへ

まずはお気軽にご相談ください。貴社に最適なAI活用プランをご提案します。