メモリーとは？AIエージェントがセッションをまたいで覚えておく仕組み

確認日：2026年10月7日

AIエージェントに一度伝えた好みや注意を、次の日にまた伝え直していないでしょうか。前の会話で知ったことを、次のセッションへ引き継ぐ仕組みがメモリーです。

本記事では、AIエージェントの開発元の公式ドキュメントをもとに、メモリーの種類と読み込まれ方、自分で作る索引のファイルとの関係を解説しましょう。

メモリーとは

メモリーは、AIエージェントがセッションをまたいで情報を覚えておくために、ファイルに書き残す仕組みです。

モデルそのものは、会話を覚えていません。覚えているように見えるのは、会話の中身がコンテキストウィンドウに入っている間だけです。新しいセッションは空のコンテキストで始まるため、前のセッションで伝えた「テストはこのコマンドで」という注意も残りません。そこで、覚えておきたいことをファイルに書き、次のセッションの最初に読み込ませます。

人が書くメモリーとAIが書くメモリー

メモリーには、誰が書くかで2つの種類があります。

メモリーには、人が書く指示ファイルと、AIが会話から書き留めるメモの2種類があり、どちらもセッションの最初にコンテキストへ読み込まれることを示す図

1つ目の種類は、人が書く指示ファイルです。プロジェクトの決まりを書いた AGENTS.md などで、本サイトでは「AGENTS.mdとは」で扱いました。製品によっては、これもメモリーと呼んでいます。

もう1つの種類は、AIが会話の中から書き留めるメモです。Claude Codeのドキュメントでは、利用者の役割や好み、利用者から受けた訂正、コードからは分からない進行中の事情、外部の情報の置き場所を残すと説明していました。コードを読めば分かることや、指示ファイルに書いてあることは残しません。毎回の会話で必ず書くのでもなく、次の会話で役立つかどうかで判断します。

どちらも、新しいセッションの最初にコンテキストへ自動で読み込まれる点は同じです。違うのは、書く人と、中身を誰が管理するかにあります。

索引だけを先に読む仕組み

AIが書くメモは、使うほど増えていきます。すべてを毎回読み込むと、コンテキストウィンドウを圧迫しかねません。そこで、索引だけを先に読み、中身は必要なときに開く作りが使われます。

AIが書くメモリーの流れ。セッション1で利用者が訂正すると、エージェントがメモのファイルに書き、索引に1行足す。セッション2の最初に索引が読み込まれ、エージェントは必要になったときだけメモの本文を開く

Claude Codeの自動メモリーでは、メモを1件ずつ別のファイルに書き、MEMORY.md という索引に1件1行で載せます。セッションの最初に読み込むのは、この索引の先頭200行（または25KB）までです。各メモの本文は起動時には読まず、必要になったときにファイルを開いて読みます。

Anthropicの技術記事は、このやり方を「just in time」と呼んでいました。すべてを先に読み込むのではなく、ファイルの場所のような軽い手がかりだけを持っておき、要るときにツールで読み込む方法です。スキルが名前と説明だけを先に読むのも、同じ考え方といえます。

自分で作った索引は、メモリーなのか

メモの置き場所として、自分で「索引」や「目次」のファイルを作っている人もいるでしょう。フォルダーごとに一覧のファイルを置き、AIにそこから資料を探させる使い方です。

このファイルは、メモリーと似た働きをしますが、仕組みは違います。自動で読み込まれることはなく、普通のファイルとして置かれているだけです。

自動で読み込まれるファイルから案内された索引は開かれ、索引から中身のファイルへたどれる。どこからも案内されていない索引は、自動では読まれず、AIが偶然見つけない限り使われない

AIがこのファイルを開くのは、自動で読み込まれる指示ファイルに「資料を探すときは、まず索引を見る」と書いてあるとき、またはAIがフォルダーの中を見て自分で開いたときです。案内がなければ、使われるかどうかは偶然に任されてしまいます。

製品によって、自動で読み込むファイルが違う点にも注意が必要です。ある製品向けの設定フォルダーにだけ案内を書くと、別の製品はその案内を読みません。複数の製品を使うなら、共通の AGENTS.md に案内を書いておくのが確実です。

使うときの注意

メモリーは便利ですが、決まりを守らせる仕組みではありません。Codexのドキュメントは、チームで必ず守る決まりは AGENTS.md やリポジトリの文書に書き、メモリーは思い出すための補助として扱うよう明記していました。どんな場合でも止めたい操作は、フックや権限で止めます。

AIが書いたメモは、ときどき中身を見直しましょう。古くなった事情や、誤って覚えた好みが残っていると、次のセッションでもそれに沿って動いてしまいます。メモは手元のファイルなので、開いて直すのも消すのも自由です。

メモには、作業中に扱った情報が要約されて残ります。Codexは秘密の値を伏せて書く作りですが、メモのフォルダーを人に渡す前には、中身を確かめてください。

製品での使われ方

ここでは、Claude CodeとCodexを例に挙げます。

Claude Codeで使えるのは、人が書く CLAUDE.md と、AIが書く自動メモリーの両方です。自動メモリーは初期設定で有効で、プロジェクトごとに ~/.claude/projects/<プロジェクト>/memory/ に保存されます。会話中に /memory と入力すると、メモの確認や、自動メモリーの切り替えが可能です。

Codexは、人が書く AGENTS.md に加えて、Memoriesという機能を持っています。過去の会話を、作業が一段落したあとで背景で要約し、~/.codex/memories/ に保存する仕組みです。初期設定では無効なので、使うときは設定で有効にしてください。