# ClaudeのMemory：Memory、CLAUDE.md、Auto Memory

> Claudeの3つのメモリシステム：それぞれの動作環境、設定の管理方法、保存する内容、そしてよくある5つのミスを避ける方法。

Source: https://ailoot.ai/blog/ja/claude-memory-claude-md-auto-memory/
Canonical: https://ailoot.ai/blog/ja/claude-memory-claude-md-auto-memory/
Language: ja
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-064
Revision: sha256-61a829ea740065fbf47e53794748eb824a9ccc1f58021b922c144dd63f959c79


<div class="aside" data-semantic="key-takeaway" role="note" aria-label="このセクションの重要なポイント">

重要なポイント

2026年、Claudeには3つのメモリシステムがあります。Claude.aiのMemoryはクラウドベースで、2026年3月から無料です。Claude CodeのCLAUDE.mdは、あなたのルールを記したファイルです。Auto Memoryは、エージェントがプロジェクトについて記録するメモです。3つはそれぞれ異なる方法で、異なる製品内で機能します。MemoryはClaude Codeに引き継がれず、CLAUDE.mdはclaude.aiでは機能しません。この記事では、比較表、それぞれを有効にするタイミング、どこに何を記載するか、設定を台無しにする5つのミスを解説します。

</div>



<div class="aside" data-semantic="ailoot-docs-link" aria-label="Ailootのドキュメント">

Ailootを使うための実践的な手順は[ドキュメント](https://ailoot.ai/docs/)にあります。

</div>

## Claudeのメモリとは何か、なぜ3つの層があるのか？

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="このセクションの重要なポイント">

重要なポイント

2026年、Claudeには3つの異なるメモリ層があり、それぞれ別の製品にあります。MemoryはClaude.ai、つまりウェブ版とモバイル版のチャットで機能します。CLAUDE.mdとAuto MemoryはClaude Code、つまりターミナル経由でノートパソコン上で機能します。これらは同じものではありません。MemoryはClaude Codeに引き継がれず、CLAUDE.mdはClaude.aiでは機能しません。「Claudeがプロジェクトを忘れた」と言う人は、それぞれのメモリがどこにあるのかを混同していることがほとんどです。

</div>

火曜日にClaude.aiを開き、あなたの対象読者、回答形式、文章のスタイルについて伝えます。木曜日、新しいチャットで戻ってくると、Claudeはすでに覚えています。これがMemoryの働きです。

ターミナルでClaude Codeを開き、2週間かけてプロジェクトを把握し、フォルダー構成、デプロイルール、お気に入りのライブラリを説明します。セッションを終了し、1時間後にもう一度開くと、エージェントはまた一から始めます。ここではMemoryは機能しません。状況を変えるには、CLAUDE.mdが必要です。

2026年には、3つ目の層が登場しました。Claude CodeのAuto Memoryでは、エージェント自身がプロジェクトについてメモを書きます。どのコマンドが機能するか、どのテストが通るか、リポジトリのどのパスに注意が必要か、といった内容です。これらのメモはローカルのディスクに保存され、次のセッションで自動的に読み込まれます。

混乱の主な原因は、「Claudeが覚えるようになった」という話を聞き、どこでも自動的に機能すると考えてしまうことです。そうではありません。claude.aiのMemoryはClaude Codeに引き継がれません。公式の[Claude Codeドキュメント](https://code.claude.com/docs/en/memory)には2つのメモリ機構が記載されていますが、Chat Memoryはその中にありません。CLAUDE.mdとAuto MemoryはClaude Codeで機能する、まったく別のシステムです。Anthropic APIも同様に、チャットメモリとは無関係な独自のMemoryツールを備えています。

このガイドでは3つすべてを取り上げ、どこに何を入れるべきか、そして「メモリを設定した」はずなのにClaudeが突然プロジェクトを「忘れる」理由を説明します。

## Claude.aiのMemoryとは何か、2026年に無料で使えるのは誰か？

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="このセクションの重要なポイント">

重要なポイント

Claude.aiのMemoryは、アカウントにひもづくクラウドベースのメモリです。Anthropicは2026年3月から、Freeを含むすべてのプランで無料にしました。機能するのはclaude.aiとモバイルアプリだけです。Claudeは会話から長期的に役立つ情報（職業、回答のスタイル、仕事の背景など）を自動的に認識し、Memoryプロフィールに保存します。設定は「Settings → Capabilities → Memory」で管理します。

</div>

### Memoryが情報を収集する仕組み

Anthropicはこれを**Memory Synthesis**と呼んでいます。Claudeは1日1回ほど最近の会話を処理し、長期的に役立つ情報を特定して、Memoryプロフィールに短い要約ブロックを書き込みます。メッセージからの逐語的な引用ではなく、「ユーザーはマーケターで、オンラインプロジェクトを運営し、余計な言葉のない短い回答を好む」といった要約です。

次の会話では、これらの要約がコンテキストの冒頭に自動的に追加されます。Claudeは、あなたが誰で、何をしていて、どのような回答のスタイルを好むかを把握するため、チャットごとに繰り返し伝える必要がありません。

### Memoryに対応するプラン

AnthropicはMemoryを段階的に提供しました。2025年9月11日：TeamとEnterprise。2025年10月23日：ProとMax。2026年3月2日：**全プランで無料**。あわせて、ChatGPT、Gemini、Grokからのインポートツールも提供されました。

| プラン | Memoryの動作 | 機能 |
|----|----|----|
| **Free** | はい | Memory自体は2026年3月から利用できますが、Chat Search（履歴の検索）は引き続き有料プランのみで利用できます |
| **Pro**（\$20/月） | はい | Memory + Chat Search |
| **Max** | はい | Memory + Chat Search |
| **Team / Enterprise** | はい | チームアカウントにひもづく |
| **API** | **いいえ** | Chat Memoryは引き継がれません。エージェント開発者向けの別のMemoryツールがあります |
| **Claude Code** | **いいえ** | Claude CodeではCLAUDE.mdとAuto Memoryを使います |

重要なのは、Memoryが機能するのはClaude.aiのウェブインターフェースまたはモバイルアプリがある場所だということです。独自のコードやCLIを通してClaudeを使う場合、Memoryはありません。

### 表示と編集の方法

claude.aiでは「**Settings → Capabilities → Memory**」を開きます。直接のURL：`claude.ai/settings/capabilities?modal=memory`。Claudeがあなたについて保存した項目の一覧が開きます。ボタンは3つあります。

- **Pause（一時停止）** — Claudeは蓄積済みのメモリを保持しますが、それを使用したり、新たに追加したりしなくなります。
- **Reset memory（メモリをリセット）** — すべて消去します。
  <figure>
  <blockquote>
  このオプションを選択して「Reset memory」をクリックすると、取り消すことはできません。
  </blockquote>
  <figcaption>— Anthropic, https://support.claude.com/en/articles/11817273</figcaption>
  </figure>
- <strong>個別の項目を編集</strong> — 個々の項目を手動で削除できます。

チャット内で使える操作もあります。「Xを覚えて」や「Yを忘れて」とClaudeに伝えると、設定画面を開かなくてもMemoryが更新されます。

もう1つ重要な点があります。Claude.aiのProjectsには**個別のメモリ**があります。

<figure>
<blockquote>
Claudeはプロジェクトごとに個別のメモリを作成します。これにより、製品のローンチ計画をクライアントの仕事と分け、機密性の高い話し合いを一般的な業務から分離できます。
</blockquote>
<figcaption>— Anthropic, https://www.claude.com/blog/memory</figcaption>
</figure>

つまり、Project内の会話は全体のMemoryに漏れず、その逆も同様です。

### Claudeに直接尋ねる

どのチャットでも「私について何を覚えていますか？」と入力できます。Claudeはこの会話で覚えている内容を一覧表示します。Memoryプロフィールに何が保存されたかを確認する最も手早い方法です。

### プライバシー

Anthropicによると、あなたのメモリはアカウント内で非公開で、ほかのユーザーと共有されません。デフォルトでは、Anthropicはモデル改善のために会話（Memoryに取り込まれた会話を含む）を使用する場合があります。これは「Privacy」設定の「Data Controls」で無効にできます。

## Claude CodeのCLAUDE.mdとは何か、Memoryとの違いは？

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="このセクションの重要なポイント">

重要なポイント

CLAUDE.mdはプロジェクトのルートに置くテキストファイルで、Claude Codeが各セッションの開始時に読み込みます。どのツールを使うか、フォルダーをどう構成するか、何をしてはいけないかなど、ルールは自分で記述します。Memoryと違って、情報が自動的に取り込まれることはありません。何を入れるかは自分で決めます。また、アカウント全体で1つではなく、プロジェクトごとに別のファイルを用意します。

</div>

Memoryは、あなた個人のスタイル、好み、職業に関する情報を集めます。CLAUDE.mdは特定のプロジェクト、つまりこのリポジトリ、これらのコマンド、コーディングの進め方について記述します。この違いは根本的です。Memoryがまとめるのは「私の一般的な人物像」であり、CLAUDE.mdが示すのは「この作業の進め方」です。

### Claude CodeがCLAUDE.mdを探す場所

優先度の低い順から高い順に、次の4か所を同時に参照します。

| レベル | 場所 | 記載する内容 |
|----|----|----|
| **組織全体** | Macでは`/Library/Application Support/ClaudeCode/CLAUDE.md`、Linuxでは`/etc/claude-code/CLAUDE.md` | チームのすべてのプロジェクトに適用される会社のルール |
| **ユーザー** | `~/.claude/CLAUDE.md` | すべてのプロジェクトに適用される個人ルール |
| **プロジェクト** | プロジェクトのルートにある`./CLAUDE.md` | プロジェクト固有の主要ファイル。gitにコミットする |
| **ローカル** | `./CLAUDE.local.md` | gitにコミットしないプロジェクト用メモ |

4つのファイルはすべて同時に読み込まれ、**連結**されます。互いに上書きすることはありません。

<figure>
<blockquote>
検出されたすべてのファイルは、互いに上書きするのではなくコンテキストに連結されます。ディレクトリツリー全体では、ファイルシステムのルートから作業ディレクトリに向かって内容が並びます。
</blockquote>
<figcaption>— Anthropic, https://code.claude.com/docs/en/memory</figcaption>
</figure>

範囲の広いものから狭いものへと順に並びます。ProjectとLocalは最後に来るため、リクエストに近いコンテキストの末尾に置かれます。そのため、重要な内容はすべてプロジェクトのCLAUDE.mdに記載してください。

### よく記載される内容

- プロジェクトの技術スタック — Next.js / Prisma / PostgreSQL / Redis
- コマンド — テスト、ビルド、デプロイの実行方法
- 注意が必要なパス — 明示的な依頼なしに触れてはいけないフォルダー
- 規約 — コミットの形式、ファイル名の付け方
- ビジネスルール — プロジェクトで重視すること（たとえば、価格をハードコードしない）
- コンテキストへのポインター — 「ビジネスロジックは`docs/business/`、デザインシステムは`docs/design/`を参照」（フォルダー名は自由です。すべてを1つのファイルに詰め込まないことが大切です）

詳しくは、すぐ使えるテンプレートを掲載した[CLAUDE.mdのガイド](https://ailoot.ai/blog/ja/claude-md-template/)をご覧ください。

### MemoryとCLAUDE.mdの違い

| 項目 | Memory（Claude.ai） | CLAUDE.md（Claude Code） |
|----|----|----|
| 保存場所 | Anthropicのクラウド | リポジトリ内のファイル |
| 誰が書くか | Claudeが自動で作成 | あなた |
| ひもづく対象 | あなたのアカウント | 特定のプロジェクト |
| 動作する場所 | claude.ai + モバイルアプリ | ターミナルのClaude Code |
| 内容の確認方法 | Settings → Memory | エディターでファイルを開く |
| 更新方法 | 1日1回のMemory Synthesis | 手動で編集 |
| 更新コマンド | Claudeに頼むか、Settingsから削除 | Claude Codeの`/memory` |

一言でいうと、Memoryはあなたの頭、CLAUDE.mdはオフィスの壁に掲示したプロジェクトの指示書です。

## Claude CodeのAuto Memoryとは何か、どこに保存されるのか？

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="このセクションの重要なポイント">

重要なポイント

Auto Memoryは2026年に登場したClaude Codeの新機能です。エージェントがプロジェクトについて自分でメモを作成し、ローカルの`~/.claude/projects/[project-name]/memory/`フォルダーに保存します。機能するコマンド、リポジトリ内で注意が必要なパス、すでに遭遇した落とし穴などが記録されます。ルールを自分で書くCLAUDE.mdとは異なり、Auto Memoryの内容は自動的に追加されます。メモのファイルはローカルに保存され、選ばれた文章はモデルの文脈へ読み込まれます。CLAUDE.mdを補完するものであり、置き換えるものではありません。

</div>

### Auto MemoryとCLAUDE.mdの違い

CLAUDE.mdにはあなたの指示を記載します。Auto Memoryにはエージェントが自分向けに書いたメモが入ります。内容の種類が異なります。

「ユーザーの希望する言語で必ず回答する」「`npm run deploy`で公開する」「`legacy/`フォルダーに触れない」といった内容を、CLAUDE.mdに手動で書きます。これらはあらかじめ設定するルールです。

Auto MemoryにはClaudeが作業中に学んだことが記録されます。テストを実行して、パッケージ不足で失敗すると、Claudeは「このプロジェクトでは、テストの前に`npm install`を実行する」と書き留めます。次のセッションで同じミスを繰り返さなくなります。

### 保存場所

各プロジェクト専用のフォルダーに、ディスク上でローカルに保存されます。

```bash
~/.claude/projects/[project-name]/memory/
```

フォルダー内の主要ファイルは`MEMORY.md`です。重要な点として、Claude CodeはCLAUDE.mdを全文読み込みますが、MEMORY.mdには上限があり、先頭の**200行または25KB**のうち、いずれか早く達したところまでしか読み込まれません。これは、Claudeが数か月の作業で蓄積したメモに埋もれるのを防ぐためです。メモはプロジェクトのリポジトリ外にあるローカルディレクトリへ保存されます。読み込まれた文章は、設定したモデルサービスへ送る会話の文脈に含まれます。ローカル保存はオフライン処理の保証ではありません。秘密情報は書かないでください。

### 利用できる条件

Auto MemoryはClaude Codeの<strong>v2.1.59+</strong>から利用でき、新規インストールではデフォルトで有効です。状態の確認と管理には、次のコマンドを使います。

```bash
/memory
```

このコマンドを実行すると、CLAUDE.mdとMEMORY.mdの両方を含むすべてのメモリ層を編集する画面が開きます。Claudeがプロジェクトについてすでに記録した内容を確認し、編集したり消去したりできます。Auto Memoryを完全に無効にするには、`~/.claude/settings.json`で`autoMemoryEnabled: false`を設定するか、環境変数`CLAUDE_CODE_DISABLE_AUTO_MEMORY=1`を使います。

### 通常記録される内容

- 機能したコマンド、または失敗したコマンド
- エージェントが把握したプロジェクト構成
- 遭遇したアンチパターン
- 重要なファイルや関数の名前

Anthropicの公式Claude Codeドキュメントでは、この違いを次のように説明しています。

<figure>
<blockquote>
CLAUDE.mdファイル：Claudeに永続的なコンテキストを与えるために、あなたが書く指示。Auto memory：あなたの修正や好みに基づき、Claudeが自分で書くメモ。
</blockquote>
<figcaption>— Anthropic, https://code.claude.com/docs/en/memory</figcaption>
</figure>

つまり、CLAUDE.mdはあなたが書く指示で、Auto Memoryはあなたの修正や好みに基づいてClaudeが自分向けに書くメモです。

## MemoryとCLAUDE.md：どのシステムを何に使うか？

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="このセクションの重要なポイント">

重要なポイント

claude.aiのブラウザーで作業するなら、Claudeにユーザーとしてのあなたを覚えさせるためにMemoryが必要です。Claude Codeでプロジェクトに取り組むなら、Claudeにプロジェクトのルールを覚えさせるCLAUDE.mdが必要で、Auto Memoryは補助的な層として使えます。これらのシステムは競合するものではなく、異なる製品で異なる問題を解決します。MemoryはClaude Codeに引き継がれず、CLAUDE.mdはclaude.aiでは機能しません。

</div>

### 判断マトリックス

| シナリオ | 有効にするもの |
|----|----|
| さまざまな話題について、ブラウザーでClaudeとチャットする | **Memory** |
| ターミナルのClaude Codeで1つのプロジェクトに取り組む | **CLAUDE.md**（土台）+ **Auto Memory**（補助） |
| Claude Codeで複数のプロジェクトに取り組む | 各プロジェクトの**CLAUDE.md** + **Auto Memory** |
| コードでAPI経由のClaudeを使う | どちらも機能しません。システムプロンプトに手動でルールを追加してください |
| Claudeに自分の文章スタイルを覚えさせたい | Claude.aiの**Memory** |
| Claudeにプロジェクト構成を覚えさせたい | プロジェクトの**CLAUDE.md** |

MemoryとCLAUDE.mdは重複しません。異なる製品で機能し、異なる内容を保存します。個人のカレンダーと会社の規定のようなもので、どちらも役立ちますが、混同する人はいません。



## Memoryを有効にするタイミング：特に役立つ3つのシナリオ

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="このセクションの重要なポイント">

重要なポイント

claude.aiのMemoryは、主に3つの仕事の場面で役立ちます。さまざまな話題について頻繁に話し、そのたびに自己紹介するのを避けたい場合。同じスタイルの短い文章を多く作成する場合。Claudeに自分の役割の背景を覚えさせる必要がある場合です。主にClaude Codeで作業するなら、Memoryは必要ありません。そこで機能しないためです。

</div>

### シナリオ1。claude.aiを個人アシスタントとして使う

毎日Claudeに、メールの書き直し、スプレッドシートの分析、アイデア出しなどを頼みます。話題はさまざまでも、あなたは同じ人です。Memoryがあれば、「こんにちは、私はマーケターで、オンラインプロジェクトを運営しています。こんな回答のスタイルが好みです」と毎回伝えずにすみます。

1週間ほど使うと、Claudeはあなたの職業、回答形式、好みのフォーマット、長さ、口調を把握します。新しいチャットは毎回その情報を踏まえて始まります。会話ごとに30～60秒を節約できます。

### シナリオ2。同じスタイルのコンテンツを多く書く

広告、SNS投稿、メールマガジンなど、ブランドの語り口は共通です。Memoryは、使わない言葉、使う口調、段落の長さといった文章スタイルを学習します。

2週間ほどの間に一度、「私たちの文章では、emダッシュを使わず、親しみやすい口調にし、段落は3つ以内にして」とClaudeに伝えてください。その内容が記録されます。以降の文章は、リマインダーなしであなたのスタイルに沿ったものになります。

### シナリオ3。役割の背景が必要

あなたは、PhotoshopではなくFigma + Sketchを使うデザイナーです。eコマースではなく、SaaSのプロダクトマネージャーです。

Memoryは役割の背景を取り込み、それに合わせて自動的に回答を調整します。一般的な回答が減り、あなたの具体的な仕事に合った回答が増えます。

### Memoryが必要ない場合

主にターミナルでClaude Codeを使うなら、Memoryは役に立ちません。そこで機能しないためです。代わりにCLAUDE.mdを使い、両者を混同しないでください。

コードからAPI経由でClaudeを使う場合も、Memoryは機能しません。指示をシステムプロンプトに手動で追加してください。

タスクの種類が1つだけで、毎回チャットの冒頭で背景を伝えることが気にならないなら、Memoryは必須ではありません。便利な機能ですが、欠かせないものではありません。

## CLAUDE.mdには何を記載し、Auto Memoryは何を自動で記録するか？

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="このセクションの重要なポイント">

重要なポイント

セッションごとに変わらない安定したルール、つまり技術スタック、規約、注意が必要なパス、ビジネスロジックはCLAUDE.mdに記載します。Auto Memoryは、機能したコマンド、落とし穴、プロジェクト構成など、変化する詳細を自動的に収集します。ルールは簡単です。例外なく常に機能させなければならないことはCLAUDE.mdに書きます。Claudeが作業しながら学べることは、Auto Memoryに任せられます。

</div>

### CLAUDE.mdに必ず記載する内容

1. **プロジェクトの説明を1段落で** — 何のためのものか、誰のためのものか、なぜ作るのか。
2. **プロジェクトの技術** — 使用するフレームワーク、ライブラリ、データベース。
3. **コマンド** — テスト、ビルド、公開に使う正確なコマンド。
4. **注意が必要なディレクトリ** — 明示的な依頼なしに触れてはいけない場所。
5. **規約** — コミット形式、ファイル名の付け方、回答言語。
6. **コンテキストへのポインター** — たとえば、「ビジネスロジックは`docs/business/`、デザインは`docs/design/`にあります」。フォルダー名は自由です。

### Auto Memoryに任せる内容

1. **ローカル環境の詳細** — このマシンではPythonが`/usr/local/bin/python3.11`にあります。
2. **プロジェクトの変更** — 昨日どのコマンドが失敗したか、そしてその理由。
3. **途中で判明したこと** — 特定のモジュールのテストがどこにあるか。
4. **ワークフローのヒント** — どの手順の後にどのスクリプトを実行するか。

### どちらにも記載してはいけない内容

- APIキー、パスワード、トークン。メモリファイルではなく`.env`に保存します。
- クライアントの個人情報。
- すぐに古くなる可能性のある情報（価格、コホートの日付、一時的なキャンペーン）。
- 単発タスクのプロンプト。コンテキストを散らかします。

### 200行ルール

Anthropicはドキュメントで、CLAUDE.mdをおよそ100～200行にすることを推奨しています。200行を超えると、Claudeは内容を読み取りにくくなります。長いコンテキストはリソースを消費し、精度を下げます。ファイルが大きくなったら、セクションを別の`.md`ファイルに移し、CLAUDE.mdには短い参照を残します。たとえば、「コードスタイルは`docs/code-style.md`を参照してください」と記載します。

ファイル構成の詳しい説明は、[Claude CodeのSecond Brainガイド](https://ailoot.ai/blog/ja/claude-code-second-brain/)をご覧ください。CLAUDE.mdから5つのコンテキストフォルダーへと、構成をどのように広げるかを説明しています。

## Claudeのメモリを台無しにする5つのミスとは？どう防ぐか？

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="このセクションの重要なポイント">

重要なポイント

2026年にClaudeのメモリを使う際の主なミスは、MemoryとCLAUDE.mdを混同すること、ファイル名の大文字と小文字が区別されるのを忘れること、巨大なCLAUDE.mdを維持すること、秘密情報を記載すること、Auto Memoryが自分の頭の中にしかない情報を自動的に記録すると期待することです。それぞれのミスが異なる形で設定を壊し、原因は設定にあるのにClaudeが「頭が悪い」ように見えてしまいます。

</div>

### ミス1。MemoryとCLAUDE.mdを混同する

最もよくあるミスです。「Claudeが覚えるようになった」という話を聞いてclaude.aiでMemoryを有効にし、その後ターミナルでClaude Codeを開き、エージェントがまた「忘れた」と不思議に思います。

claude.aiのMemoryはClaude Codeに引き継がれません。アーキテクチャが異なる別の製品です。ターミナルでClaudeにプロジェクトを覚えさせたいなら、CLAUDE.mdを書きます。ブラウザーであなた自身を覚えさせたいなら、Memoryを有効にします。

**防ぎ方。** メモリを設定する前に、普段どこで作業するかを決めましょう。claude.aiならMemory、Claude CodeならCLAUDE.mdとAuto Memoryを使います。両方使うなら、組み合わせようとせず、両方のシステムを設定してください。

### ミス2。ファイル名の大文字と小文字が区別されるのを忘れる

CLAUDE.mdは大文字と小文字が区別されるファイル名です。大文字の`CLAUDE.md`はエージェントに読み込まれます。`claude.md`や`Claude.md`は読み込まれません。`CLAUDE.local.md`も同様です。初めてClaude Codeを設定する人によくある失敗です。ファイルを作って指示を書いたのに機能せず、原因はファイル名を小文字にしていたことだった、というケースです。

**防ぎ方。** 保存する前に大文字と小文字を確認します。Macでは、Finderでファイルを選択してEnterキーを押すと、完全な名前が表示されます。ターミナルでは`ls -la CLAUDE*`を実行します。`claude.md`と表示されたら、`mv claude.md CLAUDE.md`で名前を変更してください。

### ミス3。CLAUDE.mdが800行に膨らむ

既成のテンプレートを入手し、重要そうなルールをすべて追加すると、800行のファイルになってしまいます。Claudeが読み込む時間は長くなりますが、回答の質は低下します。長いコンテキストはモデルの注意力を消費します。

**防ぎ方。** CLAUDE.mdはおよそ100～200行に保ちます。200行を超えたらセクションを別の`.md`ファイルに移し、CLAUDE.mdには「コードスタイルは`docs/code-style.md`を参照してください」といった参照を残します。人間向けのドキュメントと同じ原則で、すべてを1つのファイルに詰め込まないでください。

### ミス4。CLAUDE.mdやAuto Memoryに秘密情報を保存する

APIキー、パスワード、トークンをメモリファイルに入れてはいけません。CLAUDE.mdは通常gitにコミットされるため、秘密情報がリポジトリに漏れます。Auto Memoryはローカルに保存されますが、スクリーンショットや共有された会話、ディスクにアクセスできるMCPサーバー経由の漏えいに含まれる可能性があります。

**防ぎ方。** 秘密情報は`.env`に保存し、`.env`を`.gitignore`に追加します。CLAUDE.mdには変数名だけを記載します。「APIキーは`STRIPE_KEY`にあります。`.env`から取得してください」などです。

### ミス5。Auto Memoryがビジネスロジックを自力で把握すると期待する

Auto Memoryはコマンド、エラー、構造といった技術的な情報を集めます。「不動産会社では一定額を下回る注文を受けない」「文章で特定の語彙を使わない」といったビジネスルールは自動的に学習しません。これらはCLAUDE.mdか、CLAUDE.mdから参照する別の`.md`ファイルに記載します。

**防ぎ方。** 分けて考えましょう。技術的な詳細はAuto Memoryに自動で記録させます。ビジネスルール、スタイル、規約は手作業でCLAUDE.mdに記載します。一方がもう一方を置き換えると期待しないでください。

## MemoryとCLAUDE.mdを一晩で設定する方法（手順ガイド）

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="このセクションの重要なポイント">

重要なポイント

全体の仕組みは30～40分で設定できます。Claude.aiでMemoryを有効にし、プロジェクトにCLAUDE.mdを作成し、Auto Memoryが機能するか確認します。その後は手作業で調整します。エージェントがミスをするたびに、「それはしないこと」とCLAUDE.mdに1行追加します。1か月後には、生きた「プロジェクト憲章」ができています。

</div>

1. **Claude.aiでMemoryを有効にする。** 「Settings → Capabilities → Memory」を開いて、切り替えスイッチをオンにします。すぐにPrivacy設定も確認し、Anthropicによる会話のモデル学習への利用を許可するか決めます。あなたの選択です。

2. **自分自身についてClaudeに話す。** 次の2～3回のチャットで、自分が誰で、何をしていて、どんな回答のスタイルを好むかを伝えます。Memory Synthesisは1日以内に記録します。

3. **翌日に記録を確認する。** どのチャットでも「私について何を覚えていますか？」と入力します。Claudeが記憶している内容を一覧表示します。気に入らない内容があれば、「Settings → Memory」で削除するか、Claudeに忘れるよう頼みます。

4. **プロジェクトにCLAUDE.mdを作成する。** メインプロジェクトのルートに、大文字のファイル名`CLAUDE.md`を作成します。[CLAUDE.mdのガイド](https://ailoot.ai/blog/ja/claude-md-template/)に掲載された既成のテンプレートを使いましょう。6つのセクションがあり、Anthropicによる推奨の長さはおよそ200行です。

5. **プロジェクトに合わせて各セクションを埋める。** 技術スタック、コマンド、注意が必要なパス、規約を記述します。200行以内にしてください。それを超えるとClaudeが内容を読み取りにくくなります。

6. **Auto Memoryを確認する。** Claude Codeで`/memory`コマンドを入力します。すべての層を編集する画面が開きます。Auto Memoryもその1つです。Claudeがプロジェクトについてすでに知っていることを読みます。

7. **CLAUDE.mdをgitにコミットする。** プロジェクトの一部です。チームで作業している場合は、全員がルールを確認できます。

8. **通常どおり作業を続ける。** エージェントがミスをするたびに、「それはしないこと」とCLAUDE.mdに1行追加します。1か月後にはルールが蓄積され、Claudeはお決まりの落とし穴にはまりにくくなります。

## 機能しないこと：Claudeのメモリが保持しない3つのパターン

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="このセクションの重要なポイント">

重要なポイント

3つのシステムのどれを使っても、モデルを切り替えた際の進行中セッション、エージェントに明示的に見せていないファイルのコンテキスト、音声やスマートフォンから伝えた個別の指示は、Claudeのメモリに保持されません。これはバグではなく、アーキテクチャ上の制限です。あらかじめ知っておけば、がっかりせずに済みます。

</div>

### モデルを切り替えるとセッションの状態は保持されない

Claude CodeでOpus 4.8を使った後、Sonnet 4.6に切り替えると、モデルごとにコンテキストウィンドウが異なるため、セッションのコンテキストがリセットされることがあります。新しいセッションではCLAUDE.mdとAuto Memoryが自動的に読み込まれますが、進行中の会話は引き継がれません。

### 見せていないファイルは読み込まれない

Claudeが把握するのは、`CLAUDE.md`、Auto Memory、そして現在のセッションで明示的に開いたものだけです。プロジェクトに500個のファイルがあり、「支払い処理の方法を見て」と伝えても、エージェントはどのファイルを調べるべきか分かりません。パスを明示するか、CLAUDE.mdに参照先を追加する必要があります。

### API経由の単発の会話ではMemoryは機能しない

Claude APIへの各リクエストは独立しています。メモリは読み込まれません。API経由でチャットボットを構築する場合は、システムプロンプトとメッセージ履歴を手動で渡します。Memory、CLAUDE.md、Auto Memoryは役に立ちません。

## 次の段階：Second Brainへの入り口としてのメモリ

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="このセクションの重要なポイント">

重要なポイント

Claudeのメモリは、プロジェクトを中心にSecond Brainを構築する第一歩です。CLAUDE.mdがルールを定め、Auto Memoryが技術的な変更を記録します。そこに対象読者、経済性、製品といったビジネスの背景を含むフォルダーを加えると、本当の価値が生まれます。そうすればClaudeは、あなたの具体的なタスクに対する「質の高い解決策」を書くようになります。

</div>

CLAUDE.mdとAuto Memoryは、コードがどのように構成されているかをClaudeに覚えさせます。リファクタリング、バグ、移行、テストなどの技術的なタスクには、それで十分です。

しかし、誰にメールするか、提案をどう表現するか、価格をいくらにするかといったビジネス上の判断が必要になると、技術的なメモリだけでは足りません。顧客が誰で、どのように判断し、ビジネスがどのような経済性で成り立っているかという背景が必要です。

それが[Second Brain](https://ailoot.ai/blog/ja/claude-code-second-brain/)です。プロジェクトと並べてビジネス知識を保存するフォルダーで、ClaudeはCLAUDE.md内の参照を通じてアクセスします。コードのメモリとビジネスのメモリが揃えば、エージェントは「賢いが幻覚を起こすアシスタント」ではなく、あなたの共同執筆者になります。

<div class="section" role="doc-bibliography" aria-label="出典">

### 出典

- [Claude Code Docs - Memory](https://code.claude.com/docs/en/memory) — CLAUDE.mdとAuto Memoryの公式ドキュメント
- [Anthropic - Bringing memory to Claude](https://www.claude.com/blog/memory) — Claude.aiのMemory機能に関する発表（2025年9月）
- [Anthropic Support - Memory and Chat Search](https://support.claude.com/en/articles/11817273) — Claude.aiでMemoryを使う方法
- [Claude Code Docs - Settings](https://code.claude.com/docs/en/settings) — Claude Codeの設定（autoMemoryEnabledなど）
- [Claude Code on GitHub](https://github.com/anthropics/claude-code) — ソースコードと変更履歴

</div>





<div class="aside" data-semantic="ailoot-link" aria-label="Ailoot">

[Ailoot](https://ailoot.ai/)について、さらに詳しくご覧ください。

</div>

## ClaudeのMemory：Memory、CLAUDE.md、Auto Memory：よくある質問

### Claude.aiのMemoryを有効にしても、ターミナルの文脈が戻らないのはなぜですか？

Claude.aiのMemoryとClaude Codeのプロジェクトファイルは別の仕組みです。Claude CodeではCLAUDE.mdでプロジェクト指示を渡し、別にあるAuto Memoryのメモを`/memory`で確認してください。

### Auto MemoryはローカルなのでAPIキーを保存して安全ですか？

いいえ。読み込まれたメモはモデルの文脈になり、ディスク権限を持つツールからも読めます。Auto MemoryにもCLAUDE.mdにもキーやパスワードを入れず、秘密情報を別に保管して、変数名だけを記録してください。


## Ailoot · 企業とそのプロジェクト群

Ailootは、蓄積した運営経験、幅広い顧客基盤、安定したサービス、継続的なKPI管理を基盤としています。

企業とそのプロジェクト群：数百万の顧客、毎月数十億規模の売上。

Ailootはこの運営経験を、お客様の製品、エージェント、アプリケーション、自動化でAI機能を利用するためのAPIアクセスに活かしています。