SpyBara
Go Premium

memory.md 2026-06-16 21:57 UTC to 2026-06-17 17:02 UTC

94 added, 34 removed.

2026
Thu 18 22:00 Wed 17 17:02 Tue 16 21:57 Mon 15 23:02 Sat 13 21:59 Fri 12 22:00 Thu 11 23:01 Wed 10 23:57 Tue 9 06:34 Mon 8 06:52 Sat 6 06:24 Fri 5 06:45 Thu 4 06:52 Wed 3 06:53 Tue 2 06:51

Claude があなたのプロゞェクトを蚘憶する方法

CLAUDE.md ファむルで Claude に氞続的な指瀺を䞎え、自動メモリで Claude が自動的に孊習を蓄積できるようにしたす。

Claude Code の各セッションは、新しいコンテキストりィンドりで始たりたす。2 ぀のメカニズムがセッション間で知識を保持したす。

  • CLAUDE.md ファむル: Claude に氞続的なコンテキストを䞎えるために曞く指瀺
  • 自動メモリ: あなたの修正ず奜みに基づいお Claude が自分自身で曞くメモ

このペヌゞでは、以䞋の方法に぀いお説明したす。

CLAUDE.md ず自動メモリ

Claude Code には 2 ぀の盞互補完的なメモリシステムがありたす。どちらも各䌚話の開始時に読み蟌たれたす。Claude はこれらをコンテキストずしお扱い、匷制的な蚭定ではありたせん。アクションをブロックするには、Claude の刀断に関わらず PreToolUse hook を䜿甚しおください。より具䜓的で簡朔な指瀺ほど、Claude はそれに埓う可胜性が高くなりたす。

CLAUDE.md ファむル 自動メモリ
誰が曞くか あなた Claude
䜕が含たれるか 指瀺ずルヌル 孊習ずパタヌン
スコヌプ プロゞェクト、ナヌザヌ、たたは組織 リポゞトリごず、ワヌキングツリヌ党䜓で共有
読み蟌たれる堎所 すべおのセッション すべおのセッション最初の 200 行たたは 25KB
甹途 コヌディング暙準、ワヌクフロヌ、プロゞェクトアヌキテクチャ ビルドコマンド、デバッグの掞察、Claude が発芋する奜み

Claude の動䜜をガむドしたい堎合は CLAUDE.md ファむルを䜿甚したす。自動メモリにより、Claude は手動の䜜業なしにあなたの修正から孊習できたす。

Subagent も独自の自動メモリを保持できたす。詳现に぀いおは、subagent 蚭定を参照しおください。

CLAUDE.md ファむル

CLAUDE.md ファむルは、プロゞェクト、個人的なワヌクフロヌ、たたは組織党䜓に察しお Claude に氞続的な指瀺を䞎えるマヌクダりンファむルです。これらのファむルをプレヌンテキストで曞きたす。Claude は各セッションの開始時にそれらを読みたす。

CLAUDE.md をい぀远加するか

CLAUDE.md を、そうでなければ再床説明する堎所ずしお扱いたす。以䞋の堎合に远加したす。

  • Claude が 2 回目に同じ間違いを犯す
  • コヌドレビュヌが Claude がこのコヌドベヌスに぀いお知っおおくべきだったこずを指摘する
  • 前回のセッションで入力した同じ修正たたは説明をチャットに入力する
  • 新しいチヌムメンバヌが生産的になるために同じコンテキストが必芁になる

Claude がすべおのセッションで保持すべき事実に限定したす。ビルドコマンド、芏玄、プロゞェクトレむアりト、「垞に X を実行する」ルヌル。゚ントリが耇数ステップの手順である堎合、たたはコヌドベヌスの 1 ぀の郚分にのみ関連する堎合は、代わりに skill たたは パススコヌプルヌル に移動したす。拡匵機胜の抂芁では、各メカニズムをい぀䜿甚するかに぀いお説明しおいたす。

CLAUDE.md ファむルをどこに配眮するかを遞択する

CLAUDE.md ファむルはいく぀かの堎所に配眮でき、それぞれ異なるスコヌプを持ちたす。䞋の衚はそれらを読み蟌み順序で列挙しおおり、最も広いスコヌプから最も具䜓的なものたでなので、プロゞェクト指瀺はナヌザヌ指瀺の埌にコンテキストに衚瀺されたす。

スコヌプ 堎所 目的 ナヌスケヌスの䟋 共有察象
管理ポリシヌ • macOS: /Library/Application Support/ClaudeCode/CLAUDE.md
• Linux ず WSL: /etc/claude-code/CLAUDE.md
• Windows: C:\Program Files\ClaudeCode\CLAUDE.md		 IT/DevOps が管理する組織党䜓の指瀺 䌚瀟のコヌディング暙準、セキュリティポリシヌ、コンプラむアンス芁件 組織内のすべおのナヌザヌ
ナヌザヌ指瀺 ~/.claude/CLAUDE.md すべおのプロゞェクトの個人的な奜み コヌドスタむルの奜み、個人的なツヌリングショヌトカット あなただけすべおのプロゞェクト
プロゞェクト指瀺 ./CLAUDE.md たたは ./.claude/CLAUDE.md プロゞェクトのチヌム共有指瀺 プロゞェクトアヌキテクチャ、コヌディング暙準、䞀般的なワヌクフロヌ ゜ヌス管理を通じたチヌムメンバヌ
ロヌカル指瀺 ./CLAUDE.local.md 個人的なプロゞェクト固有の奜み。.gitignore に远加したす あなたのサンドボックス URL、奜みのテストデヌタ あなただけ珟圚のプロゞェクト

ワヌキングディレクトリより䞊のディレクトリ階局内の CLAUDE.md および CLAUDE.local.md ファむルは、起動時に完党に読み蟌たれたす。サブディレクトリ内のファむルは、Claude がそれらのディレクトリ内のファむルを読むずきにオンデマンドで読み蟌たれたす。完党な解決順序に぀いおは、CLAUDE.md ファむルの読み蟌み方法を参照しおください。

倧芏暡なプロゞェクトの堎合、プロゞェクトルヌルを䜿甚しおトピック固有のファむルに指瀺を分割できたす。ルヌルを䜿甚するず、特定のファむルタむプたたはサブディレクトリに指瀺をスコヌプできたす。

プロゞェクト CLAUDE.md を蚭定する

プロゞェクト CLAUDE.md は ./CLAUDE.md たたは ./.claude/CLAUDE.md に保存できたす。このファむルを䜜成し、プロゞェクトで䜜業する誰もが適甚できる指瀺を远加したす。ビルドおよびテストコマンド、コヌディング暙準、アヌキテクチャの決定、呜名芏則、䞀般的なワヌクフロヌ。これらの指瀺はバヌゞョン管理を通じおチヌムず共有されるため、個人的な奜みではなくプロゞェクトレベルの暙準に焊点を圓おたす。

効果的な指瀺を曞く

CLAUDE.md ファむルは各セッションの開始時にコンテキストりィンドりに読み蟌たれ、䌚話ず䞀緒にトヌクンを消費したす。コンテキストりィンドりの可芖化は、CLAUDE.md がスタヌトアップコンテキストの残りの郚分に盞察的にどこに読み蟌たれるかを瀺したす。これらはコンテキストであり匷制的な蚭定ではないため、指瀺の曞き方は Claude がそれに埓う信頌性に圱響したす。具䜓的で簡朔でよく構造化された指瀺が最適に機胜したす。

サむズ: CLAUDE.md ファむルあたり 200 行以䞋を目暙にしたす。より長いファむルはより倚くのコンテキストを消費し、遵守を枛らしたす。指瀺が倧きくなっおいる堎合は、パススコヌプルヌルを䜿甚しお、指瀺が䞀臎するファむルで䜜業するずきにのみ読み蟌たれるようにしお、ノむズを枛らしおコンテキストスペヌスを節玄できたす。むンポヌトを䜿甚しおコンテンツを分割しお敎理するこずもできたすが、むンポヌトされたファむルは䟝然ずしお読み蟌たれ、起動時にコンテキストりィンドりに入りたす。

構造: マヌクダりンヘッダヌず箇条曞きを䜿甚しお関連する指瀺をグルヌプ化したす。Claude は読者ず同じ方法で構造をスキャンしたす。敎理されたセクションは密集した段萜よりも埓いやすいです。

具䜓性: 怜蚌できるほど具䜓的な指瀺を曞きたす。䟋えば

  • 「コヌドを適切にフォヌマットする」ではなく「2 スペヌスのむンデントを䜿甚する」
  • 「倉曎をテストする」ではなく「コミット前に npm test を実行する」
  • 「ファむルを敎理しおおく」ではなく「API ハンドラヌは src/api/handlers/ に存圚する」

䞀貫性: 2 ぀のルヌルが互いに矛盟しおいる堎合、Claude は 1 ぀を任意に遞択する可胜性がありたす。CLAUDE.md ファむル、サブディレクトリ内のネストされた CLAUDE.md ファむル、および .claude/rules/ を定期的に確認しお、叀い指瀺たたは矛盟する指瀺を削陀したす。モノレポでは、claudeMdExcludes を䜿甚しお、䜜業に関連のない他のチヌムの CLAUDE.md ファむルをスキップしたす。

远加ファむルをむンポヌトする

CLAUDE.md ファむルは @path/to/import 構文を䜿甚しお远加ファむルをむンポヌトできたす。むンポヌトされたファむルは展開され、それらを参照する CLAUDE.md ず䞀緒に起動時にコンテキストに読み蟌たれたす。

盞察パスず絶察パスの䞡方が蚱可されたす。盞察パスはワヌキングディレクトリではなく、むンポヌトを含むファむルに盞察的に解決されたす。むンポヌトされたファむルは他のファむルを再垰的にむンポヌトでき、最倧深床は 4 ホップです。

README、package.json、およびワヌクフロヌガむドを取埗するには、CLAUDE.md の任意の堎所で @ 構文を䜿甚しおそれらを参照したす。

プロゞェクト抂芁に぀いおは @README を参照し、このプロゞェクトで利甚可胜な npm コマンドに぀いおは @package.json を参照しおください。

# 远加の指瀺
- git ワヌクフロヌ @docs/git-instructions.md

バヌゞョン管理にチェックむンしたくない個人的なプロゞェクト固有の奜みに぀いおは、プロゞェクトルヌトで CLAUDE.local.md を䜜成したす。これは CLAUDE.md ず䞀緒に読み蟌たれ、同じ方法で扱われたす。CLAUDE.local.md を .gitignore に远加しお、コミットされないようにしたす。/init を実行しお個人的なオプションを遞択するず、これが自動的に行われたす。

耇数の git worktrees で同じリポゞトリを操䜜する堎合、gitignored CLAUDE.local.md は䜜成したワヌキングツリヌにのみ存圚したす。ワヌキングツリヌ党䜓で個人的な指瀺を共有するには、代わりにホヌムディレクトリからファむルをむンポヌトしたす。

# 個人的な奜み
- @~/.claude/my-project-instructions.md

指瀺を敎理するためのより構造化されたアプロヌチに぀いおは、.claude/rules/を参照しおください。

AGENTS.md

Claude Code は CLAUDE.md を読みたす。AGENTS.md ではありたせん。リポゞトリが既に他のコヌディング゚ヌゞェント甚に AGENTS.md を䜿甚しおいる堎合、CLAUDE.md を䜜成しおそれをむンポヌトし、䞡方のツヌルが重耇なしに同じ指瀺を読むようにしたす。Claude 固有の指瀺をむンポヌトの䞋に远加するこずもできたす。Claude はむンポヌトされたファむルをセッション開始時に読み蟌み、その埌残りを远加したす。

@AGENTS.md

## Claude Code

`src/billing/` の䞋の倉曎には Plan Mode を䜿甚したす。

シンボリックリンクも機胜したす。Claude 固有のコンテンツを远加する必芁がない堎合は、次のようにしたす。

ln -s AGENTS.md CLAUDE.md

Windows では、シンボリックリンクを䜜成するには管理者暩限たたは開発者モヌドが必芁なため、代わりに @AGENTS.md むンポヌトを䜿甚したす。

既に AGENTS.md を持぀リポゞトリで /init を実行するず、それを読み蟌み、関連する郚分を生成された CLAUDE.md に組み蟌みたす。たた、.cursorrules、.devin/rules/、.windsurfrules などの他のツヌル蚭定も読み蟌みたす。

CLAUDE.md ファむルの読み蟌み方法

Claude Code は珟圚のワヌキングディレクトリからディレクトリツリヌを䞊に歩き、途䞭の各ディレクトリをチェックしお CLAUDE.md および CLAUDE.local.md ファむルを探したす。぀たり、foo/bar/ で Claude Code を実行するず、foo/bar/CLAUDE.md、foo/CLAUDE.md、およびそれらず䞀緒にある CLAUDE.local.md ファむルから指瀺を読み蟌みたす。

発芋されたすべおのファむルはコンテキストに連結され、互いに䞊曞きするのではなく、ディレクトリツリヌ党䜓で、コンテンツはファむルシステムルヌトからワヌキングディレクトリたで順序付けられたす。foo/bar/ の䟋では、foo/CLAUDE.md は foo/bar/CLAUDE.md の前にコンテキストに衚瀺されるため、Claude を起動した堎所に近い指瀺が最埌に読たれたす。各ディレクトリ内で、CLAUDE.local.md は CLAUDE.md の埌に远加されるため、個人的なメモはそのレベルで Claude が読む最埌のものです。

Claude は珟圚のワヌキングディレクトリの䞋のサブディレクトリ内の CLAUDE.md および CLAUDE.local.md ファむルも発芋したす。起動時に読み蟌む代わりに、Claude がそれらのサブディレクトリ内のファむルを読むずきに含たれたす。

他のチヌムの CLAUDE.md ファむルが取埗される倧芏暡なモノレポで䜜業する堎合は、claudeMdExcludes を䜿甚しおそれらをスキップしたす。倧芏暡なリポゞトリのルヌトおよびディレクトリごずの CLAUDE.md ファむルずルヌルの完党なレむアりトに぀いおは、モノレポず倧芏暡リポゞトリを参照しおください。

CLAUDE.md ファむル内のブロックレベル HTML コメント<!-- maintainer notes -->は、コンテンツが Claude のコンテキストに泚入される前に削陀されたす。コンテキストトヌクンを費やさずに人間のメンテナヌのためにメモを残すために䜿甚したす。コヌドブロック内のコメントは保持されたす。Read ツヌルで CLAUDE.md ファむルを盎接開くず、コメントは衚瀺されたたたになりたす。

远加ディレクトリから読み蟌む

--add-dir フラグは、メむンワヌキングディレクトリの倖の远加ディレクトリぞのアクセスを Claude に䞎えたす。デフォルトでは、これらのディレクトリからの CLAUDE.md ファむルは読み蟌たれたせん。

远加ディレクトリから CLAUDE.md ファむルを読み蟌むには、CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD 環境倉数を蚭定したす。

CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 claude --add-dir ../shared-config

これは远加ディレクトリから CLAUDE.md、.claude/CLAUDE.md、.claude/rules/*.md、および CLAUDE.local.md を読み蟌みたす。--setting-sourcesから local を陀倖する堎合、CLAUDE.local.md はスキップされたす。

`.claude/rules/` でルヌルを敎理する

倧芏暡なプロゞェクトの堎合、.claude/rules/ ディレクトリを䜿甚しお指瀺を耇数のファむルに敎理できたす。これにより、指瀺がモゞュヌル化され、チヌムが保守しやすくなりたす。ルヌルは特定のファむルパスにスコヌプするこずもできるため、Claude が䞀臎するファむルで䜜業するずきにのみコンテキストに読み蟌たれ、ノむズを枛らしおコンテキストスペヌスを節玄したす。

ルヌルを蚭定する

プロゞェクトの .claude/rules/ ディレクトリにマヌクダりンファむルを配眮したす。各ファむルは 1 ぀のトピックをカバヌし、testing.md たたは api-design.md のような説明的なファむル名を持぀必芁がありたす。すべおの .md ファむルは再垰的に発芋されるため、frontend/ たたは backend/ のようなサブディレクトリにルヌルを敎理できたす。

your-project/
├── .claude/
│   ├── CLAUDE.md           # メむンプロゞェクト指瀺
│   └── rules/
│       ├── code-style.md   # コヌドスタむルガむドラむン
│       ├── testing.md      # テスト芏玄
│       └── security.md     # セキュリティ芁件

paths frontmatter のないルヌルは、.claude/CLAUDE.md ず同じ優先床で起動時に読み蟌たれたす。

パス固有のルヌル

ルヌルは paths フィヌルドを持぀ YAML frontmatter を䜿甚しお特定のファむルにスコヌプできたす。これらの条件付きルヌルは、Claude が指定されたパタヌンに䞀臎するファむルで䜜業するずきにのみ適甚されたす。

---
paths:
  - "src/api/**/*.ts"
---

# API 開発ルヌル

- すべおの API ゚ンドポむントは入力怜蚌を含める必芁がありたす
- 暙準゚ラヌ応答圢匏を䜿甚したす
- OpenAPI ドキュメンテヌションコメントを含めたす

paths フィヌルドのないルヌルは無条件に読み蟌たれ、すべおのファむルに適甚されたす。パススコヌプルヌルは、すべおのツヌル䜿甚時ではなく、パタヌンに䞀臎するファむルを読むずきにトリガヌされたす。

paths フィヌルドでグロブパタヌンを䜿甚しお、拡匵子、ディレクトリ、たたはその組み合わせでファむルを䞀臎させたす。

パタヌン 䞀臎
**/*.ts 任意のディレクトリ内のすべおの TypeScript ファむル
src/**/* src/ ディレクトリの䞋のすべおのファむル
*.md プロゞェクトルヌト内のマヌクダりンファむル
src/components/*.tsx 特定のディレクトリ内の React コンポヌネント

耇数のパタヌンを指定し、ブレヌス展開を䜿甚しお 1 ぀のパタヌンで耇数の拡匵子を䞀臎させるこずができたす。

---
paths:
  - "src/**/*.{ts,tsx}"
  - "lib/**/*.ts"
  - "tests/**/*.test.ts"
---

.claude/rules/ ディレクトリはシンボリックリンクをサポヌトしおいるため、共有ルヌルセットを保持し、耇数のプロゞェクトにリンクできたす。シンボリックリンクは解決され、通垞どおり読み蟌たれ、埪環シンボリックリンクは怜出され、適切に凊理されたす。

この䟋は、共有ディレクトリず個別ファむルの䞡方をリンクしたす。

ln -s ~/shared-claude-rules .claude/rules/shared
ln -s ~/company-standards/security.md .claude/rules/security.md

ナヌザヌレベルのルヌル

~/.claude/rules/ の個人的なルヌルはマシン䞊のすべおのプロゞェクトに適甚されたす。プロゞェクト固有ではない奜みに䜿甚したす。

~/.claude/rules/
├── preferences.md    # あなたの個人的なコヌディング奜み
└── workflows.md      # あなたの奜みのワヌクフロヌ

ナヌザヌレベルのルヌルはプロゞェクトルヌルの前に読み蟌たれ、プロゞェクトルヌルに高い優先床を䞎えたす。

倧芏暡なチヌム向けに CLAUDE.md を管理する

Claude Code をチヌム党䜓に展開する組織の堎合、指瀺を䞀元化し、どの CLAUDE.md ファむルが読み蟌たれるかを制埡できたす。

組織党䜓の CLAUDE.md を展開する

組織は、マシン䞊のすべおのナヌザヌに適甚される䞀元管理の CLAUDE.md を展開できたす。このファむルは個別の蚭定で陀倖するこずはできたせん。

1

管理ポリシヌの堎所にファむルを䜜成する

  • macOS: /Library/Application Support/ClaudeCode/CLAUDE.md
  • Linux ず WSL: /etc/claude-code/CLAUDE.md
  • Windows: C:\Program Files\ClaudeCode\CLAUDE.md
2

蚭定管理システムで展開する

MDM、グルヌプポリシヌ、Ansible、たたは同様のツヌルを䜿甚しお、開発者マシン党䜓にファむルを配垃したす。その他の組織党䜓の蚭定オプションに぀いおは、管理蚭定を参照しおください。

claudeMd キヌを䜿甚するず、管理 CLAUDE.md コンテンツを別のファむルを展開する代わりに managed-settings.json 内に盎接配眮できたす。

スコヌプ: マシン䞊のすべおの Claude Code セッション、すべおのリポゞトリ内。リポゞトリ固有のガむダンスに぀いおは、代わりにプロゞェクト CLAUDE.md をコミットしたす。

優先床: 管理 CLAUDE.md ファむルず同じ。ナヌザヌおよびプロゞェクト CLAUDE.md の前に読み蟌たれたす。

どこで尊重されるか: 管理およびポリシヌ蚭定のみ。ナヌザヌ、プロゞェクト、たたはロヌカル蚭定で claudeMd を蚭定しおも効果がありたせん。

以䞋の䟋は、管理蚭定ファむル内に行動指瀺を盎接远加したす。

{
  "claudeMd": "垞に `make lint` をコミット前に実行しおください。\nメむンに盎接プッシュしないでください。"
}

管理 CLAUDE.md ず管理蚭定は異なる目的を果たしたす。蚭定を技術的な匷制に䜿甚し、CLAUDE.md を行動ガむダンスに䜿甚したす。

懞念事項 蚭定察象
特定のツヌル、コマンド、たたはファむルパスをブロックする 管理蚭定: permissions.deny
サンドボックス分離を匷制する 管理蚭定: sandbox.enabled
環境倉数ず API プロバむダヌのルヌティング 管理蚭定: env
認蚌方法ず組織ロック 管理蚭定: forceLoginMethod、forceLoginOrgUUID
コヌドスタむルず品質ガむドラむン 管理 CLAUDE.md
デヌタ凊理ずコンプラむアンスのリマむンダヌ 管理 CLAUDE.md
Claude の行動指瀺 管理 CLAUDE.md

蚭定ルヌルはクラむアントによっお匷制され、Claude が䜕をするかに関係なく。CLAUDE.md 指瀺は Claude の動䜜を圢䜜りたすが、ハヌド匷制レむダヌではありたせん。

特定の CLAUDE.md ファむルを陀倖する

倧芏暡なモノレポでは、祖先 CLAUDE.md ファむルに䜜業に関連のない指瀺が含たれおいる可胜性がありたす。claudeMdExcludes 蚭定を䜿甚するず、パスたたはグロブパタヌンで特定のファむルをスキップできたす。

この䟋は、トップレベルの CLAUDE.md ず芪フォルダのルヌルディレクトリを陀倖したす。.claude/settings.local.json に远加しお、陀倖をマシンにロヌカルに保ちたす。

{
  "claudeMdExcludes": [
    "**/monorepo/CLAUDE.md",
    "/home/user/monorepo/other-team/.claude/rules/**"
  ]
}

パタヌンはグロブ構文を䜿甚しお絶察ファむルパスに察しお䞀臎したす。claudeMdExcludes は任意の蚭定レむダヌで蚭定できたす。ナヌザヌ、プロゞェクト、ロヌカル、たたは管理ポリシヌ。配列はレむダヌ党䜓でマヌゞされたす。

管理ポリシヌ CLAUDE.md ファむルは陀倖できたせん。これにより、個別の蚭定に関係なく、組織党䜓の指瀺が垞に適甚されるこずが保蚌されたす。

自動メモリ

自動メモリを䜿甚するず、Claude は䜕も曞かずにセッション間で知識を蓄積できたす。Claude は䜜業䞭に自分自身のためにメモを保存したす。ビルドコマンド、デバッグの掞察、アヌキテクチャノヌト、コヌドスタむルの奜み、ワヌクフロヌの習慣です。Claude はすべおのセッションで䜕かを保存するわけではありたせん。情報が将来の䌚話で圹立぀かどうかに基づいお、䜕を蚘憶する䟡倀があるかを決定したす。

自動メモリを有効たたは無効にする

自動メモリはデフォルトで有効です。切り替えるには、セッションで /memory を開き、自動メモリトグルを䜿甚するか、プロゞェクト蚭定で autoMemoryEnabled を蚭定したす。

{
  "autoMemoryEnabled": false
}

環境倉数を䜿甚しお自動メモリを無効にするには、CLAUDE_CODE_DISABLE_AUTO_MEMORY=1 を蚭定したす。

ストレヌゞの堎所

各プロゞェクトは ~/.claude/projects/<project>/memory/ に独自のメモリディレクトリを取埗したす。<project> パスは git リポゞトリから掟生しおいるため、同じリポゞトリ内のすべおのワヌキングツリヌずサブディレクトリは 1 ぀の自動メモリディレクトリを共有したす。git リポゞトリの倖では、プロゞェクトルヌトが代わりに䜿甚されたす。

自動メモリを別の堎所に保存するには、settings.json で autoMemoryDirectory を蚭定したす。これは任意の蚭定スコヌプから読み蟌たれたす。ナヌザヌ、プロゞェクト、ロヌカル、ポリシヌ、たたは --settings です。

{
  "autoMemoryDirectory": "~/my-custom-memory-dir"
}

倀は絶察パスであるか、~/ で始たる必芁がありたす。プロゞェクトの .claude/settings.json たたは .claude/settings.local.json で蚭定する堎合、倀はそのフォルダのワヌクスペヌストラストダむアログを受け入れた埌にのみ尊重されたす。これは hooks を管理するのず同じゲヌトです。

ディレクトリには MEMORY.md ゚ントリポむントずオプションのトピックファむルが含たれたす。

~/.claude/projects/<project>/memory/
├── MEMORY.md          # 簡朔なむンデックス、すべおのセッションに読み蟌たれたす
├── debugging.md       # デバッグパタヌンの詳现なメモ
├── api-conventions.md # API 蚭蚈の決定
└── ...                # Claude が䜜成するその他のトピックファむル

MEMORY.md はメモリディレクトリのむンデックスずしお機胜したす。Claude はセッション党䜓を通じおこのディレクトリ内のファむルを読み曞きし、MEMORY.md を䜿甚しお保存されおいる内容を远跡したす。

自動メモリはマシンロヌカルです。同じ git リポゞトリ内のすべおのワヌキングツリヌずサブディレクトリは 1 ぀の自動メモリディレクトリを共有したす。ファむルはマシン間たたはクラりド環境党䜓で共有されたせん。

仕組み

MEMORY.md の最初の 200 行、たたは最初の 25KB のいずれか先に来る方が、すべおの䌚話の開始時に読み蟌たれたす。そのしきい倀を超えるコンテンツはセッション開始時に読み蟌たれたせん。Claude は詳现なメモを別のトピックファむルに移動するこずで、MEMORY.md を簡朔に保ちたす。

この制限は MEMORY.md にのみ適甚されたす。CLAUDE.md ファむルは長さに関係なく完党に読み蟌たれたすが、より短いファむルはより良い遵守を生成したす。

debugging.md たたは patterns.md のようなトピックファむルは起動時に読み蟌たれたせん。Claude は暙準ファむルツヌルを䜿甚しおセッション䞭にオンデマンドで読み蟌み、情報が必芁な堎合に読みたす。

Claude はセッション䞭にメモリファむルを読み曞きしたす。Claude Code むンタヌフェむスで「Writing memory」たたは「Recalled memory」が衚瀺されたら、Claude は ~/.claude/projects/<project>/memory/ から積極的に曎新たたは読み蟌みを行っおいたす。

メモリを監査および線集する

自動メモリファむルはプレヌンマヌクダりンで、い぀でも線集たたは削陀できたす。/memory を実行しお、セッション内からメモリファむルを参照しお開きたす。

`/memory` で衚瀺および線集する

/memory コマンドは、珟圚のセッションに読み蟌たれたすべおの CLAUDE.md、CLAUDE.local.md、およびルヌルファむルをリストし、自動メモリのオン/オフを切り替え、自動メモリフォルダを開くためのリンクを提䟛したす。任意のファむルを遞択しお゚ディタで開きたす。

Claude に䜕かを蚘憶するよう求めるずき、「垞に npm ではなく pnpm を䜿甚する」たたは「API テストがロヌカル Redis むンスタンスを必芁ずするこずを芚えおおく」のように、Claude はそれを自動メモリに保存したす。代わりに CLAUDE.md に指瀺を远加するには、Claude に盎接「これを CLAUDE.md に远加する」ず尋ねるか、/memory を通じおファむルを自分で線集したす。

メモリの問題をトラブルシュヌティングする

これらは CLAUDE.md ず自動メモリの最も䞀般的な問題ず、それらをデバッグするための手順です。

Claude が CLAUDE.md に埓っおいない

CLAUDE.md コンテンツはシステムプロンプト自䜓の䞀郚ではなく、システムプロンプトの埌のナヌザヌメッセヌゞずしお配信されたす。Claude はそれを読んで埓おうずしたすが、特に曖昧たたは矛盟する指瀺の堎合、厳密な遵守の保蚌はありたせん。

デバッグするには

  • /memory を実行しお、CLAUDE.md および CLAUDE.local.md ファむルが読み蟌たれおいるこずを確認したす。ファむルがリストされおいない堎合、Claude はそれを芋るこずができたせん。
  • 関連する CLAUDE.md がセッションに読み蟌たれる堎所にあるこずを確認したすCLAUDE.md ファむルをどこに配眮するかを遞択するを参照。
  • 指瀺をより具䜓的にしたす。「コヌドを適切にフォヌマットする」よりも「2 スペヌスのむンデントを䜿甚する」の方が機胜したす。
  • CLAUDE.md ファむル党䜓で矛盟する指瀺を探したす。2 ぀のファむルが同じ動䜜に察しお異なるガむダンスを提䟛する堎合、Claude は 1 ぀を任意に遞択する可胜性がありたす。

特定の時点で実行する必芁がある指瀺䟋えば、すべおのコミット前たたはファむル線集埌の堎合は、代わりに hook ずしお蚘述しおください。Hook はシステムコマンドずしお固定されたラむフサむクルむベントで実行され、Claude が䜕をするかに関係なく適甚されたす。

システムプロンプトレベルで必芁な指瀺に぀いおは、--append-system-prompt を䜿甚したす。これはすべおの呌び出しで枡す必芁があるため、察話的な䜿甚よりもスクリプトず自動化に適しおいたす。

自動メモリが䜕を保存したかわからない

/memory を実行し、自動メモリフォルダを遞択しお、Claude が保存したものを参照したす。すべおはプレヌンマヌクダりンで、読み取り、線集、たたは削陀できたす。

CLAUDE.md が倧きすぎる

200 行を超えるファむルはより倚くのコンテキストを消費し、遵守を枛らす可胜性がありたす。パス固有のルヌルを䜿甚しお、Claude が䞀臎するファむルで䜜業する堎合にのみ指瀺を読み蟌むか、すべおのセッションで必芁でないコンテンツをトリミングしたす。@path むンポヌトに分割するず、組織化に圹立ちたすが、むンポヌトされたファむルは起動時に読み蟌たれるため、コンテキストは削枛されたせん。

`/compact` 埌に指瀺が倱われたようです

プロゞェクトルヌト CLAUDE.md は圧瞮を完党に生き残りたす。/compact の埌、Claude はディスクから CLAUDE.md を再床読み蟌み、セッションに新しく再泚入したす。サブディレクトリ内のネストされた CLAUDE.md ファむルは自動的に再泚入されたせん。それらは Claude がそのサブディレクトリ内のファむルを読む次回に再床読み蟌たれたす。

圧瞮埌に指瀺が消えた堎合、それは䌚話でのみ䞎えられたか、ただ再床読み蟌たれおいないネストされた CLAUDE.md に存圚しおいたす。セッション間で氞続化するために、䌚話のみの指瀺を CLAUDE.md に远加したす。圧瞮埌に䜕が生き残るかを参照しお、完党な内蚳を確認しおください。

効果的な指瀺を曞くを参照しお、サむズ、構造、および具䜓性に関するガむダンスを確認しおください。

  • 蚭定をデバッグする: CLAUDE.md たたは蚭定が有効にならない理由を蚺断する
  • Skills: オンデマンドで読み蟌たれる反埩可胜なワヌクフロヌをパッケヌゞ化する
  • Settings: 蚭定ファむルで Claude Code の動䜜を蚭定する
  • Subagent メモリ: subagent が独自の自動メモリを保持できるようにする