> ## Documentation Index > Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Claude があなたのプロジェクトを記憶する方法 > CLAUDE.md ファイルで Claude に永続的な指示を与え、自動メモリで Claude が自動的に学習を蓄積できるようにします。 Claude Code の各セッションは、新しいコンテキストウィンドウで始まります。2 つのメカニズムがセッション間で知識を保持します。 * **CLAUDE.md ファイル**: Claude に永続的なコンテキストを与えるために書く指示。Claude は CLAUDE.md の代わりにリポジトリの [`AGENTS.md` ファイル](#agents-md)を読むこともできます * **自動メモリ**: あなたの修正と好みに基づいて Claude が自分自身で書くメモ このページでは、以下の方法について説明します。 * [CLAUDE.md ファイルを書いて整理する](#claude-md-files) * [既存の AGENTS.md](#agents-md) をプロジェクト指示として使用する * [`.claude/rules/` で特定のファイルタイプにルールをスコープする](#organize-rules-with-claude/rules/) * [自動メモリを設定する](#auto-memory)ので Claude が自動的にメモを取ります * [指示が従われていない場合のトラブルシューティング](#troubleshoot-memory-issues)

CLAUDE.md と自動メモリ

Claude Code には 2 つの相互補完的なメモリシステムがあります。どちらも各会話の開始時に読み込まれます。Claude はこれらをコンテキストとして扱い、強制的な設定ではありません。アクションをブロックするには、Claude の判断に関わらず [PreToolUse hook](/docs/ja/hooks-guide) を使用してください。より具体的で簡潔な指示ほど、Claude はそれに従う可能性が高くなります。 | | CLAUDE.md ファイル | 自動メモリ | | :- | :- | :- | | **誰が書くか** | あなた | Claude | | **何が含まれるか** | 指示とルール | 学習とパターン | | **スコープ** | プロジェクト、ユーザー、または組織 | リポジトリごと、ワーキングツリー全体で共有 | | **読み込まれる場所** | すべてのセッション | すべてのセッション（最初の 200 行または 25KB） | | **用途** | コーディング標準、ワークフロー、プロジェクトアーキテクチャ | あなたの好み、Claude に与える修正、Claude がコードから導き出せないプロジェクトコンテキスト | Claude の動作をガイドしたい場合は CLAUDE.md ファイルを使用します。自動メモリにより、Claude は手動の作業なしにあなたの修正から学習できます。 Subagent も独自の自動メモリを保持できます。詳細については、[subagent 設定](/docs/ja/sub-agents#enable-persistent-memory)を参照してください。

CLAUDE.md ファイル

CLAUDE.md ファイルは、プロジェクト、個人のワークフロー、または組織全体に対して Claude に永続的な指示を与えるマークダウンファイルです。これらのファイルはプレーンテキストで記述し、Claude はすべてのセッションの開始時にそれらを読みます。リポジトリが代わりに `AGENTS.md` を使用している場合は、[AGENTS.md](#agents-md) を参照してください。

CLAUDE.md に追加するタイミング

CLAUDE.md を、そうでなければ何度も説明し直すことになる内容を記述する場所として扱ってください。以下の場合に追加してください。 * Claude が同じ間違いを 2 回目に犯した場合 * コードレビューで Claude がこのコードベースについて知っておくべきだったことが指摘された場合 * 前回のセッションで入力した同じ修正または説明をチャットに再度入力する場合 * 新しいチームメンバーが生産性を高めるために同じコンテキストが必要な場合 すべてのセッションで Claude が保持すべき事実に限定してください。ビルドコマンド、規約、プロジェクトレイアウト、「常に X を実行する」ルールなどです。エントリが複数ステップの手順である場合、またはコードベースの 1 つの部分にのみ関連する場合は、代わりに [スキル](/docs/ja/skills) または [パススコープ付きルール](#organize-rules-with-claude/rules/) に移動してください。[拡張機能の概要](/docs/ja/features-overview#build-your-setup-over-time) では、各メカニズムをいつ使用するかについて説明しています。

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`。`./AGENTS.md` がそれらの代わりに、または一緒にロードされるタイミングについては [AGENTS.md](#agents-md) を参照してください | プロジェクトのチーム共有指示 | プロジェクトアーキテクチャ、コーディング標準、一般的なワークフロー | ソース管理を通じたチームメンバー | | **ローカル指示** | `./CLAUDE.local.md` | 個人的なプロジェクト固有の設定。`.gitignore` に追加してください | サンドボックス URL、推奨テストデータ | 自分のみ（現在のプロジェクト） | 作業ディレクトリより上のディレクトリ階層内の CLAUDE.md および CLAUDE.local.md ファイルは起動時にロードされます。サブディレクトリ内のファイルはオンデマンドでロードされます。ロードされるタイミングと完全な解決順序については、[CLAUDE.md ファイルのロード方法](#how-claude-md-files-load) を参照してください。 大規模なプロジェクトの場合、[プロジェクトルール](#organize-rules-with-claude/rules/) を使用してトピック固有のファイルに指示を分割できます。ルールを使用すると、特定のファイルタイプまたはサブディレクトリに指示をスコープできます。

プロジェクト CLAUDE.md をセットアップする

プロジェクト CLAUDE.md は `./CLAUDE.md` または `./.claude/CLAUDE.md` に保存できます。このファイルを作成し、プロジェクトで作業する誰もが適用される指示を追加してください。ビルドおよびテストコマンド、コーディング標準、アーキテクチャの決定、命名規約、一般的なワークフローなどです。これらの指示はバージョン管理を通じてチームと共有されるため、個人的な設定ではなくプロジェクトレベルの標準に焦点を当ててください。ファイルがロードされたことを確認するには、セッションで `/context` を実行し、**Memory files** の下のリストを確認してください。 `/init` を実行して、開始用の CLAUDE.md を自動的に生成します。Claude はコードベースを分析し、発見したビルドコマンド、テスト指示、プロジェクト規約を含むファイルを作成します。CLAUDE.md が既に存在する場合、`/init` は上書きするのではなく改善を提案します。そこから Claude が自分で発見しない指示で洗練させてください。 代わりにインタラクティブなマルチフェーズフローの場合は、`/init` を実行する前に `CLAUDE_CODE_NEW_INIT` 環境変数を `1` に設定してください。シェルまたは [環境変数を設定する](/docs/ja/env-vars#set-environment-variables) に示されているように設定ファイルの `env` ブロックで設定します。設定すると、`/init` はセットアップするアーティファクト（CLAUDE.md ファイル、スキル、フック）を尋ねます。その後、サブエージェントでコードベースを探索し、フォローアップの質問を通じてギャップを埋め、ファイルを書き込む前に確認可能な提案を提示します。変数は `/init` の実行方法のみを変更するため、設定したままにしておくことができます。

効果的な指示を書く

Claude は CLAUDE.md ファイルをコンテキストとして扱い、強制的な設定ではないため、指示の書き方は Claude がそれらに従う信頼性に影響します。検証可能なほど具体的な指示を書いてください。 * 「コードを適切にフォーマットする」ではなく「2 スペースのインデントを使用する」 * 「変更をテストする」ではなく「コミット前に `npm test` を実行する」 * 「ファイルを整理しておく」ではなく「API ハンドラーは `src/api/handlers/` に存在する」 ファイルを短く、整理され、一貫性のあるものに保ってください。 * **サイズ**: CLAUDE.md ファイルあたり 200 行以下を目標にしてください。より長いファイルはより多くのコンテキストを消費し、遵守を減らします。コードベースの一部にのみ関連する指示を [パススコープ付きルール](#path-specific-rules) に移動してください。これらは、一致するファイルで Claude が作業するときにのみロードされます。[インポート](#import-additional-files) は長いファイルを整理するのに役立ちますが、インポートされたファイルも起動時にロードされるため、コンテキストコストは削減されません。 * **構造**: 関連する指示をマークダウンヘッダーと箇条書きの下にグループ化してください。整理されたセクションは、密集した段落よりも Claude が従いやすくなります。 * **一貫性**: 2 つの指示が矛盾している場合、Claude は 1 つを任意に選択する可能性があります。CLAUDE.md ファイル、サブディレクトリ内のネストされた CLAUDE.md ファイル、および [`.claude/rules/`](#organize-rules-with-claude/rules/) を定期的に確認して、古い指示または矛盾する指示を削除してください。Claude に見つけてもらうには、[プロンプト監査を実行](#audit-your-instruction-files) してください。

指示ファイルを監査する

Claude に指示ファイルで古い内容または矛盾する内容をチェックさせるには、セッションで `/doctor prompt-audit` を実行してください。Claude は、古いモデル用に書かれた指示、存在しないファイルまたはコマンドへの参照、互いに矛盾するファイルなどの問題を探します。提案された編集を含む調査結果のレポートが表示され、Claude に適用するよう依頼するまでファイル内の何も変更されません。 デフォルトでは、監査は CLAUDE.md、CLAUDE.local.md、AGENTS.md ファイル、および `.claude/` と `~/.claude/` の下のルール、スキル、コマンド、サブエージェント、出力スタイルをカバーします。代わりに 1 つのファイルまたはディレクトリを監査するには、そのパスを渡してください。例えば `/doctor prompt-audit .claude/skills/deploy` です。 監査はバンドルされた `/claude-api` スキルを通じて実行されます。そのスキルが [`skillOverrides`](/docs/ja/skills#override-skill-visibility-from-settings) で無効になっているか、[`disableBundledSkills`](/docs/ja/settings-reference#disablebundledskills) で無効になっている場合は利用できません。`/doctor prompt-audit` には Claude Code v2.1.283 以降が必要です。

追加ファイルをインポートする

CLAUDE.md ファイルは `@path/to/import` 構文を使用して追加ファイルをインポートできます。インポートされたファイルは展開され、それらを参照する CLAUDE.md と一緒に起動時にコンテキストにロードされます。 相対パスと絶対パスの両方が許可されます。相対パスは、作業ディレクトリではなく、インポートを含むファイルを基準に解決されます。インポートされたファイルは他のファイルを再帰的にインポートでき、最大深度は 4 ホップです。 パスにスペースが含まれるファイルをインポートするには、各スペースの前にバックスラッシュを付けます。バックスラッシュがない場合、インポートが独立した行にあっても、パスは最初のスペースで終了します。引用符で囲まれたパスは、バックスラッシュの有無にかかわらず、まったくインポートされません。このインポートは `Design Docs` という名前のフォルダからファイルをロードします。 ```text theme={null} - API conventions @Design\ Docs/api-conventions.md ``` インポート解析はマークダウンコードスパンとフェンスコードブロックをスキップします。CLAUDE.md でパスをインポートせずに言及するには、バックティックで囲んでください。`` `@README` `` と書くとテキストはリテラルのままですが、バックティックの外の `@README` はファイルをインポートします。 README、package.json、ワークフローガイドを取得するには、CLAUDE.md の任意の場所で `@` 構文を使用してそれらを参照してください。 ```text theme={null} See @README for project overview and @package.json for available npm commands for this project. # Additional Instructions - git workflow @docs/git-instructions.md ``` バージョン管理にチェックインすべきではない個人的なプロジェクト固有の設定については、プロジェクトルートに `CLAUDE.local.md` を作成してください。これは `CLAUDE.md` と一緒にロードされ、同じ方法で扱われます。`CLAUDE.local.md` を `.gitignore` に追加して、コミットされないようにしてください。`CLAUDE_CODE_NEW_INIT=1` が設定されている場合、`/init` を実行して個人オプションを選択するとこれが自動的に行われます。 同じリポジトリの複数の git worktree で作業する場合、gitignore された `CLAUDE.local.md` は作成した worktree にのみ存在します。worktree 間で個人的な指示を共有するには、代わりにホームディレクトリからファイルをインポートしてください。 ```text theme={null} # Individual Preferences - @~/.claude/my-project-instructions.md ``` プロジェクトレベルのメモリファイル内のインポートは、上記のホームディレクトリのインポートのように、パスが作業ディレクトリの外に解決される場合、外部インポートとなります。Claude Code が初めてプロジェクトで外部インポートを検出すると、ファイルをリストする承認ダイアログが表示されます。拒否すると、インポートは無効のままになり、ダイアログは再度表示されません。 Claude Code はダイアログを表示して、共有プロジェクトに他の人がコミットしたファイルから保護します。`~/.claude/CLAUDE.md` や `~/.claude/rules/` などのユーザースコープのメモリファイルは、自分で書いたファイルです。デスクトップでの [Cowork](https://claude.com/product/cowork) セッションを除き、Claude Code はダイアログなしでそれらのインポートをロードし、他の個人設定と同様に信頼します。 デスクトップの Cowork セッションでは、Claude Code はユーザースコープファイル内のセッションの作業ディレクトリの外に解決されるパスを持つインポートをスキップし、ファイルの残りをロードします。これらのセッションでは、それ自体がシンボリックリンクまたはハードリンクである `~/.claude/CLAUDE.md` と、作業ディレクトリの外を指すシンボリックリンクされた `~/.claude/rules/` ディレクトリまたはルールファイルもスキップします。

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 Code はそれぞれをロードします。読み取りには、単一ファイルに対する `cat` や `head` など、[読み取りとしてカウントされる](/docs/ja/tools-reference#edit-tool-behavior) Bash コマンドでファイルを表示することも含まれます。`.claude/worktrees/` の下にある worktree 内のファイルについては、[worktree でサブエージェントを分離する](/docs/ja/worktrees#isolate-subagents-with-worktrees) を参照してください。 大規模なモノレポで他のチームの CLAUDE.md ファイルが取得される場合は、[`claudeMdExcludes`](#exclude-specific-claude-md-files) を使用してそれらをスキップしてください。ルートおよびディレクトリごとの CLAUDE.md ファイルとルールの完全なレイアウトについては、[モノレポと大規模リポジトリ](/docs/ja/large-codebases) を参照してください。 CLAUDE.md ファイル内のブロックレベル HTML コメント（``）は、コンテンツが Claude のコンテキストに注入される前に削除されます。コンテキストトークンを消費せずに、人間のメンテナーのためのメモを残すために使用してください。コードブロック内のコメントは保持されます。Read ツールで CLAUDE.md ファイルを直接開くと、コメントは表示されたままになります。

追加ディレクトリからロードする

`--add-dir` フラグは、メインの作業ディレクトリの外の追加ディレクトリに Claude がアクセスできるようにします。デフォルトでは、これらのディレクトリからの CLAUDE.md ファイルはロードされません。 追加ディレクトリからメモリファイルもロードするには、`CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` 環境変数を設定してください。 ```bash theme={null} CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 claude --add-dir ../shared-config ``` インライン形式は、Bash または Zsh でその 1 回の起動に対して変数を設定します。すべてのセッションで有効にするには、[環境変数を設定する](/docs/ja/env-vars#set-environment-variables) に示されているように `~/.claude/settings.json` の `env` ブロックに追加してください。 これは追加ディレクトリから `CLAUDE.md`、`.claude/CLAUDE.md`、`.claude/rules/*.md`、および `CLAUDE.local.md` をロードします。`CLAUDE.local.md` は [`--setting-sources`](/docs/ja/cli-reference) から `local` を除外する場合はスキップされます。

`.claude/rules/` でルールを整理する

大規模なプロジェクトの場合、`.claude/rules/` ディレクトリを使用して指示を複数のファイルに整理できます。これにより、指示がモジュール化され、チームが保守しやすくなります。ルールは [特定のファイルパスにスコープ](#path-specific-rules) することもできるため、Claude が一致するファイルで作業するときにのみコンテキストにロードされ、ノイズを減らしてコンテキストスペースを節約します。 ルールはすべてのセッションまたは一致するファイルが開かれるときにコンテキストにロードされます。タスク固有の指示で常にコンテキストに含まれる必要がない場合は、代わりに [スキル](/docs/ja/skills) を使用してください。これは、呼び出すときまたは Claude がプロンプトに関連していると判断したときにのみロードされます。

ルールをセットアップする

プロジェクトの `.claude/rules/` ディレクトリにマークダウンファイルを配置してください。各ファイルは 1 つのトピックをカバーし、`testing.md` や `api-design.md` のような説明的なファイル名を持つ必要があります。すべての `.md` ファイルは再帰的に発見されるため、`frontend/` や `backend/` のようなサブディレクトリにルールを整理できます。 ```text theme={null} your-project/ ├── .claude/ │ ├── CLAUDE.md # Main project instructions │ └── rules/ │ ├── code-style.md # Code style guidelines │ ├── testing.md # Testing conventions │ └── security.md # Security requirements ``` [`paths` フロントマター](#path-specific-rules) のないルールは、`.claude/CLAUDE.md` と同じ優先順位で起動時にロードされます。 [`--setting-sources`](/docs/ja/cli-reference) から `project` を除外する場合、プロジェクトルールはスキップされます。v2.1.211 より前では、パススコープ付きルールやネストされた `.claude/rules/` ディレクトリ内のルールを含む、オンデマンドでロードするルールは、`project` が除外されている場合でもロードされました。

パススコープ付きルール

ルールは YAML フロントマターと `paths` フィールドを使用して特定のファイルにスコープできます。これらの条件付きルールは、指定されたパターンに一致するファイルで Claude が作業するときにのみ適用されます。 ```markdown theme={null} --- paths: - "src/api/**/*.ts" --- # API Development Rules - All API endpoints must include input validation - Use the standard error response format - Include OpenAPI documentation comments ``` `paths` フィールドのないルールは無条件にロードされ、すべてのファイルに適用されます。パススコープ付きルールは、Claude が一致するファイルに対して Read、Write、または Edit ツールを使用したときにロードされます。また、単一ファイルに対する `cat` や `head` など、[読み取りとしてカウントされる](/docs/ja/tools-reference#edit-tool-behavior) Bash コマンドで Claude が一致するファイルを表示したときにもロードされます。マッチングは、Claude がプロジェクトディレクトリへのシンボリックリンクされたパスを通じてファイルに到達する場合（例えば、シンボリックリンクされたチェックアウト）にも機能します。 `paths` フィールドでグロブパターンを使用して、拡張子、ディレクトリ、またはそれらの組み合わせでファイルをマッチさせてください。 | パターン | マッチ | | - | - | | `**/*.ts` | 任意のディレクトリ内のすべての TypeScript ファイル | | `src/**/*` | `src/` ディレクトリの下のすべてのファイル | | `*.md` | プロジェクトルート内のマークダウンファイル | | `src/components/*.tsx` | 特定のディレクトリ内の React コンポーネント | 複数のパターンを指定し、ブレース展開を使用して 1 つのパターンで複数の拡張子をマッチさせることができます。 ```markdown theme={null} --- paths: - "src/**/*.{ts,tsx}" - "lib/**/*.ts" - "tests/**/*.test.ts" --- ``` 各ブレースグループは展開されたパターンの数を乗算します。`src/*.{ts,tsx}` は 2 つのパターンに展開され、`{a,b}/{c,d}/*.{ts,tsx}` は 8 つに展開されます。展開を制限するために、ルール全体の `paths` リストは 1,000 展開パターンと 4 MiB の 1 つの予算を共有し、ブレースのないパターンはそれに対してカウントされません。 Claude Code は予算を超えるパターンを展開されていない状態で使用し、その文字通りのブレースはファイルをマッチさせません。v2.1.217 より前では、多くのブレースグループを持つ `paths` 値は起動時に CLI をスタールまたはクラッシュさせました。 グロブ構文は `[` をブラケット式（`[abc]` など）の開始として扱います。`photos [2024/**` のようにブラケット式として読むことができない `[` を持つパターンは無効です。何もマッチせず、ルールの他のパターンは機能し続けます。ファイル名内のリテラル `[` をマッチさせるには、`photos \[2024/**` のようにエスケープしてください。v2.1.207 より前では、1 つの無効なパターンは、何もマッチしないのではなく、ルールが評価されたすべてのファイルに対して Read ツールを失敗させました。

ルールのフロントマターリファレンス

ファイル先頭の `---` マーカーの間に YAML [フロントマター](/docs/ja/glossary#frontmatter) を記述してルールを設定します。`paths` は Claude Code がルールから読む唯一のフィールドです。他のフィールドはエラーなしで無視されます。Claude Code はルールをコンテキストにロードする前にフロントマターを削除します。 | フィールド | 必須 | 説明 | | :- | :- | :- | | `paths` | いいえ | [ルールを一致するファイルにスコープする](#path-specific-rules) グロブパターン。YAML リストまたはカンマ区切り文字列を受け入れます | マーカー間の YAML が解析できない場合、Claude Code はフロントマターを無視し、`paths` がないかのようにルールをロードします。`claude --debug` を実行して解析エラーを確認してください。 `.claude/rules/` ディレクトリはシンボリックリンクをサポートしているため、共有ルールセットを保持し、複数のプロジェクトにリンクできます。循環シンボリックリンクは検出され、適切に処理されます。 Claude Code は、ターゲットが作業ディレクトリの外にあるシンボリックリンクを [外部インポート](#import-additional-files) のように扱います。リンクされたルールは、プロジェクトの外部インポートを承認するまでロードされず、その後は [`paths` フィールド](#path-specific-rules) のないものだけがロードされます。 Claude Code はこの承認を、インタラクティブセッションの開始時にダイアログでプロジェクトごとに 1 回求めます。ダイアログには、外部の `@path` インポートとともに、リンクされたルールファイルが一覧表示されます。承認なしで共有ルールをロードするには、[`~/.claude/rules/`](#user-level-rules) に保持してください。そこではマシン上のすべてのプロジェクトに適用されます。 この例は、共有ディレクトリと個別ファイルの両方をリンクします。 ```bash theme={null} ln -s ~/shared-claude-rules .claude/rules/shared ln -s ~/company-standards/security.md .claude/rules/security.md ``` `.claude/rules/` または `CLAUDE.md` のシンボリックリンクを、UNC 共有 `\\server\share` や `/net` または `/Network` の下のパスなどのネットワークパスに向けた場合、リンクされた指示はロードされません。そのようなパスを検索すると、その名前が示すホストに接続する可能性があるため、Claude Code はリンクをたどりません。`\\wsl$` パスはネットワークパスとしてカウントされません。

ユーザーレベルルール

`~/.claude/rules/` の個人的なルールはマシン上のすべてのプロジェクトに適用されます。プロジェクト固有ではない設定に使用してください。 ```text theme={null} ~/.claude/rules/ ├── preferences.md # Your personal coding preferences └── workflows.md # Your preferred workflows ``` Claude Code はプロジェクトルールの前にユーザーレベルルールをロードするため、プロジェクトルールはユーザールールより後に Claude のコンテキストに表示されます。どちらのセットも他方を上書きしません。ユーザールールとプロジェクトルールが矛盾する場合、Claude はどちらかに従う可能性があるため、2 つを一貫性のあるものに保ってください。

大規模なチーム向けに CLAUDE.md を管理する

Claude Code を複数のチームにデプロイする組織の場合、指示を一元化し、どの CLAUDE.md ファイルがロードされるかを制御できます。

組織全体の 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` MDM、グループポリシー、Ansible、または同様のツールを使用して、開発者マシン全体にファイルを配布してください。その他の組織全体の設定オプションについては、[管理設定](/docs/ja/managed-settings) を参照してください。 `claudeMd` キーを使用すると、別のファイルをデプロイする代わりに、管理された CLAUDE.md コンテンツを `managed-settings.json` に直接配置できます。 **スコープ**: マシン上のすべての Claude Code セッション、すべてのリポジトリで。リポジトリ固有のガイダンスについては、プロジェクト CLAUDE.md をコミットしてください。 **優先順位**: 管理された CLAUDE.md ファイルと同じ。ユーザーおよびプロジェクト CLAUDE.md の前にロードされます。 **どこで尊重されるか**: 管理設定およびポリシー設定のみ。ユーザー、プロジェクト、またはローカル設定で `claudeMd` を設定しても効果がありません。 以下の例は、管理設定ファイルに直接動作指示を追加します。 ```json theme={null} { "claudeMd": "Always run `make lint` before committing.\nNever push directly to main." } ``` 管理された CLAUDE.md と [管理設定](/docs/ja/managed-settings) は異なる目的を果たします。技術的な強制には設定を、動作ガイダンスには 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` に追加して、除外をマシンにローカルに保ってください。 ```json theme={null} { "claudeMdExcludes": [ "**/monorepo/CLAUDE.md", "/home/user/monorepo/other-team/.claude/rules/**" ] } ``` パターンは、グロブ構文を使用して絶対ファイルパスに対してマッチされます。`claudeMdExcludes` は任意の [設定レイヤー](/docs/ja/settings#where-settings-live)（ユーザー、プロジェクト、ローカル、または管理ポリシー）で設定できます。配列はレイヤー全体でマージされます。 [シンボリックリンク](#share-rules-across-projects-with-symlinks) を通じて到達するルールファイルを除外するには、ファイルとそのディレクトリのどちらがリンクであっても、`.claude/rules/` の下のファイルのパスまたはそのリンクターゲットのいずれかのパスに対してパターンを記述してください。どちらかのパスに一致するパターンはファイルを除外します。v2.1.239 より前では、リンクターゲットに一致するパターンのみがファイルを除外しました。 管理ポリシー CLAUDE.md ファイルは除外できません。これにより、個別の設定に関わらず、組織全体の指示が常に適用されることが保証されます。

AGENTS.md

Claude Code は [`AGENTS.md`](/docs/ja/glossary#agents-md) をプロジェクト指示として読み込むことができるため、他のコーディングエージェント向けにセットアップされたリポジトリは、`CLAUDE.md`、インポート、またはセッティングを追加することなく動作します。このテーブルは、リポジトリ内の指示ファイルの組み合わせごとに Claude が既定で読み込むものを示しています。 | リポジトリに含まれるもの | Claude が読み込むもの | | :- | :- | | `AGENTS.md` があり、ワーキングディレクトリまたはその上位ディレクトリに `CLAUDE.md` または `CLAUDE.local.md` がない | `AGENTS.md` | | `AGENTS.md` と、ワーキングディレクトリまたはその上位ディレクトリに `CLAUDE.md` または `CLAUDE.local.md` がある | `CLAUDE.md` ファイルのみ | | `AGENTS.md` を既に [インポートしている](#share-one-file-with-other-coding-tools) `CLAUDE.md` がある | `CLAUDE.md`（インポートを通じて `AGENTS.md` を含む） | 既定の動作を変更する場合（例えば、Claude に常に両方のファイルを読み込ませたい、`CLAUDE.md` のみを読み込ませたい、または組織が管理する指示のみを読み込ませたい場合）は、[**Project instructions** セッティングを変更](#choose-which-instruction-files-load) してください。 `AGENTS.md` を直接読み込むには Claude Code v2.1.277 以降が必要です。一部のセッションでは Claude が [`AGENTS.md` を読み込むことができない](#when-agents-md-support-is-unavailable) ため、代わりに [`CLAUDE.md` からインポート](#share-one-file-with-other-coding-tools) してください。

Claude Code が AGENTS.md を読み込むとき

既定では、Claude はワーキングディレクトリまたはその上位ディレクトリに `CLAUDE.md` がない場合にのみ `AGENTS.md` を読み込みます。このチェックに該当するファイルは以下の通りです。 * **該当するため、Claude は `AGENTS.md` の代わりにこれらを読み込む**: ワーキングディレクトリまたはその上位ディレクトリにある `CLAUDE.md`、`.claude/CLAUDE.md`、または `CLAUDE.local.md` * **該当しないため、`AGENTS.md` と一緒に読み込み続ける**: `~/.claude/CLAUDE.md`、組織が管理する `CLAUDE.md`、および `.claude/rules/` ファイル 該当するものがない場合、Claude が読み込むものと確認方法は以下の通りです。 * **セッション開始時**: ワーキングディレクトリとその上位ディレクトリ内のすべての `AGENTS.md` と `.claude/AGENTS.md`。インタラクティブセッションでは、会話に `no CLAUDE.md found; AGENTS.md loaded: /home/you/repo/AGENTS.md` のような行が表示されます * **Claude がサブディレクトリで作業するとき**: Claude が Read ツールでそこにファイルを開き、そのサブディレクトリに 3 つの `CLAUDE.md` ファイルのいずれも含まれていない場合、サブディレクトリの `AGENTS.md` * **各 `AGENTS.md` 内**: [`@path` インポート](#import-additional-files) が展開され、[`claudeMdExcludes`](#exclude-specific-claude-md-files) パターンが適用され、[プロジェクト指示をスキップ](/docs/ja/sub-agents#what-loads-at-startup) するサブエージェントがこれらのファイルもスキップします * **読み込まれない**: `AGENTS.local.md`、`AGENTS.override.md`、または `.agents/` ディレクトリ下のすべてのもの `CLAUDE.local.md` が該当するため、`AGENTS.md` に依存するプロジェクトに `CLAUDE.local.md` を追加して独自のコミットされていない指示を保持すると、Claude は `AGENTS.md` を読み込まなくなります。`CLAUDE.local.md` を保持しながら Claude に `AGENTS.md` を読み込ませるには、**Project instructions** を [`claude-md-and-agents-md`](#choose-which-instruction-files-load) に設定してください。

Claude が読み込む指示ファイルを選択する

Claude が読み込むファイルを変更するには、Claude Code セッションで `/config` と入力してセッティングパネルを開き、**Project instructions** を以下のいずれかの値に設定します。 | 値 | Claude が読み込むもの | | :- | :- | | `claude-md-or-agents-md` | `CLAUDE.md` ファイル、またはワーキングディレクトリまたはその上位ディレクトリに `CLAUDE.md` または `CLAUDE.local.md` がない場合は `AGENTS.md` ファイル。これが既定値です | | `claude-md-and-agents-md` | `CLAUDE.md` と `AGENTS.md` ファイルを一緒に、各ディレクトリの `CLAUDE.md` ファイルを最初に、その後に `AGENTS.md` を読み込みます。Claude Code は既に読み込んだ `AGENTS.md` をスキップするため、`CLAUDE.md` がインポートまたはシンボリックリンクしているものは 2 回読み込まれません | | `claude-md` | `CLAUDE.md` ファイルのみ | | `managed-only` | 起動時に組織が管理する `CLAUDE.md` と [自動メモリ](#auto-memory) のみ。プロジェクト、ローカル、ユーザーの `CLAUDE.md` ファイル、`.claude/rules/` ファイル、およびすべての `AGENTS.md` は除外されます。サブディレクトリの `CLAUDE.md` と `.claude/rules/` ファイル、および [パススコープのルール](#path-specific-rules) は、引き続き必要に応じて読み込まれます | `/config` の代わりに設定ファイルで値を設定することもできます。`AGENTS.md` を読み込む組み込みプラグインの ID である `cc-plugin-agents-md@builtin` の下で、[`pluginConfigs`](/docs/ja/settings-reference#pluginconfigs) に追加してください。Claude Code はこのエントリを `~/.claude/settings.json`、`--settings` ファイル、または [管理設定](/docs/ja/managed-settings) から読み込み、プロジェクトおよびローカルの設定ファイルでは無視します。この例は Claude に両方のファイルを読み込ませます。 ```json settings.json theme={null} { "pluginConfigs": { "cc-plugin-agents-md@builtin": { "options": { "instructionFiles": "claude-md-and-agents-md" } } } } ``` v2.1.285 より前は、このプラグインの ID は `agents-md@builtin` であり、Claude Code は `cc-plugin-agents-md@builtin` の下のエントリを無視していました。以前のバージョンでも同じ設定ファイルを読み込む場合は、そこでは `agents-md@builtin` を使用してください。Claude Code v2.1.285 以降は、どちらの ID の下のエントリも読み込みます。 変更は次のメッセージから、およびすべての新しいセッションで適用されます。

AGENTS.md サポートが利用できないとき

これらのセッションでは Claude は `CLAUDE.md` ファイルのみを読み込み、**Project instructions** は `/config` セッティングパネルに表示されません。 * Claude Code v2.1.277 より前のバージョンを使用している * `/plugin` を使用して、`AGENTS.md` を読み込む組み込みプラグインを無効にした * 一部の場合、v2.1.276 以前から [アップグレード](/docs/ja/env-vars#first-session-after-an-install-or-upgrade) した後の最初のセッションです。次のセッションから Claude は `AGENTS.md` を読み込みます v2.1.281 より前では、Amazon Bedrock 上のセッションやテレメトリが無効になっているセッションなど、一部のセッションは `CLAUDE.md` ファイルのみを読み込みます。これらのバージョンでは Claude Code を更新してください。これらのセッションのいずれかで Claude に `AGENTS.md` を提供するには、[`CLAUDE.md` からインポート](#share-one-file-with-other-coding-tools) してください。

AGENTS.md が CLAUDE.md と異なる点

Claude が **Project instructions** セッティングを通じて読み込む `AGENTS.md` は、これらの場所で `CLAUDE.md` と異なります。 | | `CLAUDE.md` | **Project instructions** セッティングを通じて読み込まれた `AGENTS.md` | | :- | :- | :- | | [`InstructionsLoaded` フック](/docs/ja/hooks#instructionsloaded) | 発火する | 発火しない。`CLAUDE.md` がインポートまたはシンボリックリンクしている `AGENTS.md` に対しては通常通り発火します | | [`CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD`](#load-from-additional-directories) が設定されている間に `--add-dir` で追加するディレクトリ | それらの `CLAUDE.md` が読み込まれる | それらの `AGENTS.md` は読み込まれません | | ワーキングディレクトリの外のファイルの `@path` インポート | Claude Code はあなたに [外部インポート](#import-additional-files) の承認を求めます | このプロジェクトに対して既に外部インポートを承認している場合のみ読み込まれ、プロンプトはありません |

以前の AGENTS.md 回避策を削除する

Claude Code が独自に `AGENTS.md` を読み込む前にそれを読み込むようにセットアップした場合、各一般的なセットアップで以下を実行してください。 * **`@AGENTS.md` を含む `CLAUDE.md`**: そのままにしておくことができます。インポートを保持することで、使用する **Project instructions** 値に関係なく Claude が `AGENTS.md` を 2 回読み込むことはありません。`CLAUDE.md` が他に何も含まない場合は削除するか、一部のセッションが [`AGENTS.md` を直接読み込むことができない](#when-agents-md-support-is-unavailable) 場合は保持してください。 * **Claude に言葉で `AGENTS.md` を読み込むよう指示する `CLAUDE.md`**: Claude がファイルを開くことを決定した場合のみ `AGENTS.md` が表示されます。`CLAUDE.md` を削除して Claude が `AGENTS.md` を直接読み込むようにするか、文を `@AGENTS.md` インポートに置き換えてください。 * **`AGENTS.md` にシンボリックリンクされた `CLAUDE.md`**: 何もしないか、シンボリックリンクを削除してください。どちらの場合でも Claude はコンテンツを 1 回読み込みます。 * **`AGENTS.md` を出力する `SessionStart` フック**: 削除してください。Claude が `AGENTS.md` を直接読み込むと、フックはコンテキストに 2 番目のコピーを追加します。

他のコーディングツールと 1 つのファイルを共有する

Claude が `AGENTS.md` を直接読み込んでいない場合でも、`AGENTS.md` の隣に `CLAUDE.md` に `@AGENTS.md` インポートを配置することで、すべてのツールが共有する 1 つのファイルとして保持できます。プロジェクトに `CLAUDE.md` もある場合、**Project instructions** を `claude-md` に設定した場合、または [`AGENTS.md` を読み込むことができない](#when-agents-md-support-is-unavailable) セッションで実行してください。インポートの下に Claude 固有の指示を追加すると、Claude はインポートされたファイルを最初に読み込み、その後残りを読み込みます。 ```markdown CLAUDE.md theme={null} @AGENTS.md ## Claude Code `src/billing/` 下の変更にはプランモードを使用してください。 ``` Claude 固有のコンテンツが不要な場合、シンボリックリンクも機能します。 ```bash theme={null} ln -s AGENTS.md CLAUDE.md ``` コマンドは成功時に出力を出力しません。シンボリックリンクをインポートより選択する前に、これらの制約を確認してください。 * **編集**: Claude はリンクを通じて `CLAUDE.md` を読み込みますが、Edit および Write ツールは [シンボリックリンクを通じた書き込みを拒否](/docs/ja/errors#refusing-after-a-symlink-changed) し、拒否はリンクのターゲットである `AGENTS.md` を代わりに編集するよう Claude に指示します * **Windows**: リポジトリをクローンする人が Windows で作業する場合は、`@AGENTS.md` インポートを代わりに使用してください。そこでシンボリックリンクを作成するには管理者権限または開発者モードが必要であり、`core.symlinks` が有効になっていない限り Git はコミットされたシンボリックリンクをプレーンテキストファイルとしてチェックアウトします。これにより、そのクローンに指示の代わりに 1 行の `CLAUDE.md` が残ります どちらのアプローチでも、次のセッションで `/context` を実行し、**Memory files** の下に `CLAUDE.md` が表示されることを確認してください。

他のツールから指示を移行する

[`/init`](/docs/ja/commands) を実行すると、他のツールの指示ファイルが読み込まれ、関連する部分が生成された `CLAUDE.md` に組み込まれます。 * `.cursor/rules/` または `.cursorrules` の Cursor ルール * `.github/copilot-instructions.md` の Copilot ルール * `CLAUDE_CODE_NEW_INIT=1` が設定されている場合: `AGENTS.md`、`.devin/rules/`、`.windsurf/rules/` または `.windsurfrules`、および `.clinerules` [`/import`](/docs/ja/commands) を実行して、サポートされているコーディングエージェントの設定を Claude Code に取り込むこともできます。これにより、`AGENTS.md` などの指示ファイルの 1 回限りのコピーが一致する `CLAUDE.md` に追加され、MCP サーバー、コマンド、サブエージェント、およびスキルが引き継がれます。Claude Code v2.1.213 以降が必要です。

自動メモリ

自動メモリを使用すると、Claude は何も書かずにセッション間で知識を蓄積できます。Claude は作業中に自分自身のためにメモを 4 種類保存します。Claude はメモリファイルのフロントマターに `type` フィールドとして種類を記録します。 * `user`：あなたの役割、専門知識、および作業の好み * `feedback`：Claude に与える修正と確認するアプローチ * `project`：進行中の作業、期限、および Claude がコードまたは git 履歴から導き出せない決定 * `reference`：issue トラッカーやダッシュボードなど、プロジェクト外の情報を見つける場所 Claude はアーキテクチャ、ファイルパス、デバッグ修正など、コードベースから導き出せるものはすべてスキップします。また、CLAUDE.md ファイルが既に述べていることもスキップします。 Claude はすべてのセッションで何かを保存するわけではありません。情報が将来の会話で役立つかどうかに基づいて、何を記憶する価値があるかを決定します。

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

自動メモリはローカルセッションではデフォルトで有効です。[Claude Tag](https://claude.com/docs/claude-tag/overview) セッション以外では、[セルフホスト環境](/docs/ja/self-hosted-environments-configuration#how-each-session’s-config-is-assembled)のセッションはデフォルトで自動メモリがオフの状態で実行されます。 切り替えるには、セッションで `/memory` を開き、自動メモリトグルを使用します。これにより `autoMemoryEnabled` が `~/.claude/settings.json` のユーザー設定に保存されます。 次のセッションでは、トグルで自動メモリをオフにすることはできますが、再びオンにすることはできません。 * [バックグラウンドセッション](/docs/ja/agent-view) * 別の Claude Code セッションが開始したセッション（Claude が Bash ツールを通じて `claude` を実行した場合など） これらのセッションで自動メモリがオフの間、トグルには `off · can't be turned on here; use a session started outside Claude Code` と表示されます。自動メモリを再びオンにするには、ターミナルで直接 `claude` を実行し、そのセッションで `/memory` トグルを使用します。 単一のプロジェクトに対してオフにするには、そのプロジェクトの設定で `autoMemoryEnabled` を設定します。 ```json theme={null} { "autoMemoryEnabled": false } ``` 環境変数を使用して自動メモリを無効にするには、`CLAUDE_CODE_DISABLE_AUTO_MEMORY=1` を設定します。

ストレージの場所

各プロジェクトは `~/.claude/projects//memory/` に独自のメモリディレクトリを取得します。`` パスは git リポジトリから派生しているため、同じリポジトリ内のすべてのワーキングツリーとサブディレクトリは 1 つの自動メモリディレクトリを共有します。git リポジトリの外では、プロジェクトルートが代わりに使用されます。 `CLAUDE_CODE_PROJECT_DIR_NAME` を `CLAUDE_CONFIG_DIR` の横に設定した場合、Claude Code はその名前を、どのリポジトリを起動しても `/projects/` の下の `` ディレクトリとして使用するため、その設定ディレクトリで起動されたプロジェクトは 1 つの自動メモリディレクトリを共有します。Claude Code v2.1.234 以降が必要です。詳細は [`CLAUDE_CODE_PROJECT_DIR_NAME`](/docs/ja/sessions#name-the-project-directory-yourself) を参照してください。 自動メモリを別の場所に保存するには、`settings.json` で `autoMemoryDirectory` を設定します。これは任意の[設定スコープ](/docs/ja/settings#settings-precedence)から読み込まれます。ユーザー、プロジェクト、ローカル、ポリシー、または `--settings` です。 ```json theme={null} { "autoMemoryDirectory": "~/my-custom-memory-dir" } ``` 値は絶対パスであるか、`~/` で始まる必要があります。 プロジェクトの `.claude/settings.json` または `.claude/settings.local.json` で設定する場合、Claude Code はそれを[設定ファイル内の hooks と同じワークスペーストラストルール](/docs/ja/permissions#what-runs-before-you-trust-a-folder)の下で尊重します。[`permissions.blockReadsOutsideWorkingDirectories`](/docs/ja/settings-reference#permissions-blockreadsoutsideworkingdirectories) がオンの間、Claude Code は[リポジトリ提供の設定ファイル](/docs/ja/permissions#when-your-local-settings-file-needs-trust)が選択するディレクトリからは自動メモリを読み込まず、そこに保存もしません。そのディレクトリがどこにあるかに関わらず。 ディレクトリには `MEMORY.md` インデックスとメモリごとに 1 つのトピックファイルが含まれます。 ```text theme={null} ~/.claude/projects//memory/ ├── MEMORY.md # インデックス、メモリごとに 1 行、すべてのセッションに読み込まれます ├── user_role.md # 1 つのメモリ ├── feedback_testing.md # 1 つのメモリ └── ... # Claude が作成するその他のトピックファイル ``` `MEMORY.md` はメモリディレクトリのインデックスとして機能します。Claude はセッション全体を通じてこのディレクトリ内のファイルを読み書きし、`MEMORY.md` を使用して保存されている内容を追跡します。 自動メモリはマシンローカルです。同じ git リポジトリ内のすべてのワーキングツリーとサブディレクトリは 1 つの自動メモリディレクトリを共有します。ファイルはマシン間またはクラウド環境全体で共有されません。 Claude Code は [`cleanupPeriodDays`](/docs/ja/settings-reference#cleanupperioddays) 保持期間後に古いセッショントランスクリプトを削除しますが、メモリディレクトリ内のメモリファイルをその[保持スイープ](/docs/ja/claude-directory#cleaned-up-automatically)から除外します。`MEMORY.md` とトピックファイルは、あなたまたは Claude が編集または削除するまで保持されます。

仕組み

`MEMORY.md` の最初の 200 行、または最初の 25KB のいずれか先に来る方が、すべての会話の開始時に読み込まれます。そのしきい値を超えるコンテンツはセッション開始時に読み込まれません。Claude は詳細なメモを別のトピックファイルに移動することで、`MEMORY.md` を簡潔に保ちます。 Claude が `MEMORY.md` に書き込んだ後、Claude Code はファイルを 200 行および 25KB の読み込み制限に対して測定します。ファイルが制限に近い場合、Claude Code は Claude に短縮するよう促します。エントリごとに 1 行を保持し、詳細をトピックファイルに移動し、古いエントリをマージまたは削除します。ファイルが制限を超えている場合、書き込みは成功しますが、Claude Code は[Claude にインデックスを書き直すよう指示するエラー](/docs/ja/errors#memory-index-is-over-its-read-limit)を返します。次の読み込み時に制限を超えるすべてが削除されるためです。 この制限は `MEMORY.md` にのみ適用されます。Claude Code は最大 4 MiB の CLAUDE.md ファイルを完全に読み込み、より大きいファイルはスキップします。より短いファイルはより良い遵守を生成します。 `user_role.md` または `feedback_testing.md` などのトピックファイルは起動時に読み込まれません。Claude は標準ファイルツールを使用してセッション中にオンデマンドで読み込み、情報が必要な場合に読みます。 メイン会話の自動メモリは[サブエージェント](/docs/ja/sub-agents#what-loads-at-startup)に読み込まれません。例外は[フォーク](/docs/ja/sub-agents#fork-the-current-conversation)で、これは親会話とシステムプロンプトを継承します。サブエージェント `memory` フィールドで有効にされたサブエージェント自身の自動メモリは、別のディレクトリです。 Claude はセッション中にメモリファイルを読み書きします。Claude Code インターフェイスで「Saved 2 memories」または「Recalled 2 memories」などのメッセージが表示されたら、Claude は `~/.claude/projects//memory/` から積極的に更新または読み込みを行っています。 Claude が YAML フロントマターで始まるメモリファイルを書き込む場合、Claude Code は書き込み時刻を ISO 8601 タイムスタンプとして `modified` フロントマターフィールドに記録します。タイムスタンプは、事実がどの程度最新であるかを、あなたと Claude がメモリを読み戻すときの両方に示します。フロントマターを持つすべてのファイルは、以前のバージョンで作成されたファイルを含め、Claude が次に書き込むときにフィールドを取得します。Claude Code はフロントマターを持たないファイルにフロントマターを追加することはありません。`modified` フィールドには Claude Code v2.1.214 以降が必要です。

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

自動メモリファイルはプレーンマークダウンで、いつでも編集または削除できます。[`/memory`](#view-and-edit-with-%2Fmemory) を実行して、セッション内からメモリファイルを参照して開きます。

`/memory` で表示および編集する

`/memory` コマンドは、ユーザーおよびプロジェクトスコープ全体にわたる CLAUDE.md、CLAUDE.local.md、およびその他のメモリファイルの場所をリストします。これには、まだ存在しないファイルのユーザーおよびプロジェクト CLAUDE.md エントリも含まれます。また、自動メモリのオン/オフを切り替えたり、自動メモリフォルダを開くオプションを提供したりできます。任意のファイルを選択してエディタで開きます。まだ存在しないファイルを選択すると、最初にそれが作成されます。起動時に読み込まれた `CLAUDE.md` ファイルとルールファイルを確認するには、`/context` を実行します。 VS Code などの GUI エディタはファイルを別のウィンドウで開き、ファイルが開いている間もセッションを使用し続けることができます。v2.1.216 より前は、`/memory` はファイルを閉じるまで応答を待っていました。Vim などのターミナルエディタはターミナルを占有し、終了するまで制御します。 Claude に何かを記憶するよう求めるとき、「常に npm ではなく pnpm を使用する」または「API テストがローカル Redis インスタンスを必要とすることを覚えておく」のように、Claude はそれを自動メモリに保存します。代わりに CLAUDE.md に指示を追加するには、Claude に直接「これを CLAUDE.md に追加する」と尋ねるか、`/memory` を通じてファイルを自分で編集します。

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

CLAUDE.md と自動メモリに関する最も一般的な問題と、それらをデバッグするための手順を以下に示します。

Claude が CLAUDE.md に従っていない

CLAUDE.md のコンテンツは、システムプロンプト自体の一部ではなく、システムプロンプトの後のユーザーメッセージとして配信されます。Claude はそれを読んで従おうとしますが、特に曖昧または矛盾した指示の場合、厳密な準拠を保証することはできません。 デバッグするには： * `/context` を実行し、**Memory files** の下のリストを確認して、起動時に読み込まれるはずの CLAUDE.md と CLAUDE.local.md ファイルを確認します。そこにないファイルがある場合、Claude はそれを見ることができません。`/memory` を使用してファイルを開いて編集します。 * 作業ディレクトリのサブディレクトリにある `CLAUDE.md` は、起動時ではなくオンデマンドで読み込まれるため、**Memory files** の下には表示されません。読み込まれると、そのパスを含む `Loaded` 行がターミナルに表示されます。新しいファイルをテストするには、Claude に書き込みを依頼するのではなくシェルから作成し、そのサブディレクトリ内のファイルを読むよう Claude に依頼します。 * 関連する CLAUDE.md がセッションに読み込まれる場所にあることを確認します（[CLAUDE.md ファイルをどこに配置するかを選択する](#choose-where-to-put-claude-md-files) を参照）。 * 指示をより具体的にします。「Use 2-space indentation」は「format code nicely」よりも効果的です。 * CLAUDE.md ファイル全体で矛盾する指示を探します。2 つのファイルが同じ動作に対して異なるガイダンスを提供する場合、Claude は任意に 1 つを選択する可能性があります。 * Claude Code が独自に追加するガイダンスと指示が競合しているかどうかを確認します。CLAUDE.md がコミットまたはプルリクエストルールを設定する場合、[`includeGitInstructions`](/docs/ja/settings-reference#includegitinstructions) で組み込みのものをオフにし、[`attribution`](/docs/ja/settings-reference#attribution) で属性テキストを設定します。 指示が各コミットの前やファイル編集後など、特定の時点で実行する必要があるものである場合は、代わりに [フック](/docs/ja/hooks-guide) として記述します。フックはシェルコマンドとして固定されたライフサイクルイベントで実行され、Claude が何をすることに決めたかに関係なく適用されます。 システムプロンプトレベルで指示が必要な場合は、[`--append-system-prompt`](/docs/ja/cli-reference#system-prompt-flags) を使用します。起動時に渡すため、対話的な使用よりもスクリプトと自動化に適しています。会話を再開するときの動作については、[再開された会話でのシステムプロンプトフラグ](/docs/ja/cli-reference#system-prompt-flags-in-resumed-conversations) を参照してください。 [`InstructionsLoaded` フック](/docs/ja/hooks#instructionsloaded) を使用して、どの `CLAUDE.md` とルールファイルが読み込まれたか、いつ読み込まれたか、なぜ読み込まれたかをログに記録します。これは、パス固有のルールまたはサブディレクトリ内の遅延読み込みファイルをデバッグするのに役立ちます。

AGENTS.md が読み込まれていない

リポジトリに `AGENTS.md` があり、Claude がそれが何を言っているかを知らないようである場合、通常の原因はプロジェクトパスのどこかに `CLAUDE.md` があることです。デフォルトでは、Claude は、作業ディレクトリまたはそれより上のディレクトリに `CLAUDE.md` または `CLAUDE.local.md` がない場合にのみ `AGENTS.md` を読み込みます。以下の順序で確認します： 1. 作業ディレクトリまたはそれより上のディレクトリ（`~/.claude/CLAUDE.md` を除く）で `CLAUDE.md`、`.claude/CLAUDE.md`、または `CLAUDE.local.md` を探します。見つかった場合、**Project instructions** を `claude-md-and-agents-md` に設定しない限り、Claude はそれを `AGENTS.md` の代わりに読み込みます。 2. `claude --version` を実行し、v2.1.277 以降であることを確認します。v2.1.281 より前では、Amazon Bedrock 上のセッションやテレメトリが無効なセッションなど、一部のセッションも [`AGENTS.md` を読み込むことができない](#when-agents-md-support-is-unavailable) ため、これらのバージョンでは v2.1.281 以降に更新してください。 3. セッションで `/config` を入力して設定パネルを開き、**Project instructions** が `claude-md` または `managed-only` に設定されていないことを確認します。そこに設定が表示されない場合、セッションは [`AGENTS.md` を読み込むことができない](#when-agents-md-support-is-unavailable) セッションです。 Claude が `AGENTS.md` を読み込んだかどうかを確認するには、`/memory` を実行し、リストでそのパスを探します。 v2.1.280 より前では、`/memory` と `/context` は Claude が直接読み込んだ `AGENTS.md` をリストしていませんでした。これらのバージョンでは、代わりに Claude にプロジェクト指示が何であるかを尋ねます。 見つけた `CLAUDE.md` を保持したい場合、またはセッションが `AGENTS.md` を読み込むことができない場合は、[`AGENTS.md` の横に `AGENTS.md` をインポートする `CLAUDE.md` を追加します](#share-one-file-with-other-coding-tools)。

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

`/memory` を実行し、自動メモリフォルダを選択して、Claude が保存したものを参照します。すべてはプレーンマークダウンであり、読み取り、編集、または削除できます。

CLAUDE.md が大きすぎる

200 行を超えるファイルはより多くのコンテキストを消費し、準拠を減らす可能性があります。Claude Code は 4 MiB を超えるファイルをスキップします。[パススコープルール](#path-specific-rules) を使用して、Claude が一致するファイルで作業する場合にのみ指示を読み込むか、すべてのセッションで必要でないコンテンツをトリミングします。[`@path` インポート](#import-additional-files) に分割すると、組織化に役立ちますが、インポートされたファイルは起動時に読み込まれるため、コンテキストは削減されません。 指示ファイルのいずれかが推奨される長さを超えている場合、起動時と `/status` の実行時に警告が表示されます。また、個々のファイルはその長さの範囲内であっても、セッション開始時の合計が上限を超える場合にも警告が表示されます。各 CLAUDE.md、ルールファイル、および `@path` インポートは、それぞれ別のファイルとしてカウントされます。 [`/doctor`](/docs/ja/commands#all-commands) チェックアップは、チェックインされた CLAUDE.md のトリミングを提案します。コードベースから派生できるコンテンツ（ディレクトリレイアウト、依存関係リスト、アーキテクチャの概要など）を削除し、落とし穴、根拠、およびツールのデフォルトと異なる規約を保持します。トリムチェックには Claude Code v2.1.206 以降が必要です。

`/compact` 後に指示が失われたようです

プロジェクトルート CLAUDE.md はコンテキスト圧縮後も保持されます。`/compact` の後、Claude はディスクから再度読み込み、セッションに再度注入します。サブディレクトリ内のネストされた CLAUDE.md ファイルと [`paths:` フロントマター](#path-specific-rules) を持つルールは、オンデマンドで再度読み込まれます。 圧縮後に指示が消えた場合、それは会話でのみ与えられたか、まだ再度読み込まれていないネストされた CLAUDE.md に存在するか、またはまだ再度マッチしたファイルがないパススコープルールです。会話のみの指示を CLAUDE.md に追加して、それらを永続化させます。完全な内訳については、[圧縮後に保持されるもの](/docs/ja/context-window#what-survives-compaction) を参照してください。 サイズ、構造、具体性に関するガイダンスについては、[効果的な指示を書く](#write-effective-instructions) を参照してください。 * [設定をデバッグする](/docs/ja/debug-your-config): CLAUDE.md または設定が有効にならない理由を診断する * [Skills](/docs/ja/skills): オンデマンドで読み込まれる反復可能なワークフローをパッケージ化する * [Settings](/docs/ja/settings): 設定ファイルで Claude Code の動作を設定する * [Subagent メモリ](/docs/ja/sub-agents#enable-persistent-memory): subagent が独自の自動メモリを保持できるようにする