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

• CLAUDE.md ファイル: Claude に永続的なコンテキストを与えるために書く指示。Claude は CLAUDE.md の代わりにリポジトリの AGENTS.md ファイルを読むこともできます
• 自動メモリ: あなたの修正と好みに基づいて Claude が自分自身で書くメモ

• CLAUDE.md ファイルを書いて整理する
• 既存の AGENTS.md をプロジェクト指示として使用する
• .claude/rules/ で特定のファイルタイプにルールをスコープする
• 自動メモリを設定するので Claude が自動的にメモを取ります
• 指示が従われていない場合のトラブルシューティング

​

CLAUDE.md と自動メモリ

​

CLAUDE.md ファイル

​

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

• Claude が同じ間違いを 2 回目に犯した場合
• コードレビューで Claude がこのコードベースについて知っておくべきだったことが指摘された場合
• 前回のセッションで入力した同じ修正または説明をチャットに再度入力する場合
• 新しいチームメンバーが生産性を高めるために同じコンテキストが必要な場合

​

CLAUDE.md ファイルの配置場所を選択する

​

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

​

効果的な指示を書く

• 「コードを適切にフォーマットする」ではなく「2 スペースのインデントを使用する」
• 「変更をテストする」ではなく「コミット前に npm test を実行する」
• 「ファイルを整理しておく」ではなく「API ハンドラーは src/api/handlers/ に存在する」

• サイズ: CLAUDE.md ファイルあたり 200 行以下を目標にしてください。より長いファイルはより多くのコンテキストを消費し、遵守を減らします。コードベースの一部にのみ関連する指示を パススコープ付きルール に移動してください。これらは、一致するファイルで Claude が作業するときにのみロードされます。インポート は長いファイルを整理するのに役立ちますが、インポートされたファイルも起動時にロードされるため、コンテキストコストは削減されません。
• 構造: 関連する指示をマークダウンヘッダーと箇条書きの下にグループ化してください。整理されたセクションは、密集した段落よりも Claude が従いやすくなります。
• 一貫性: 2 つの指示が矛盾している場合、Claude は 1 つを任意に選択する可能性があります。CLAUDE.md ファイル、サブディレクトリ内のネストされた CLAUDE.md ファイル、および .claude/rules/ を定期的に確認して、古い指示または矛盾する指示を削除してください。Claude に見つけてもらうには、プロンプト監査を実行 してください。

​

指示ファイルを監査する

​

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

- API conventions @Design\ Docs/api-conventions.md

See @README for project overview and @package.json for available npm commands for this project.

# Additional Instructions
- git workflow @docs/git-instructions.md

# Individual Preferences
- @~/.claude/my-project-instructions.md

​

CLAUDE.md ファイルのロード方法

​

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

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

​

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

​

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

your-project/
├── .claude/
│   ├── CLAUDE.md           # Main project instructions
│   └── rules/
│       ├── code-style.md   # Code style guidelines
│       ├── testing.md      # Testing conventions
│       └── security.md     # Security requirements

​

パススコープ付きルール

---
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:
  - "src/**/*.{ts,tsx}"
  - "lib/**/*.ts"
  - "tests/**/*.test.ts"
---

​

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

​

シンボリックリンクを使用してプロジェクト間でルールを共有する

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

​

ユーザーレベルルール

~/.claude/rules/
├── preferences.md    # Your personal coding preferences
└── workflows.md      # Your preferred workflows

​

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

​

組織全体の CLAUDE.md をデプロイする

{
  "claudeMd": "Always run `make lint` before committing.\nNever push directly to main."
}

​

特定の CLAUDE.md ファイルを除外する

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

​

AGENTS.md

​

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

• 該当するため、Claude は AGENTS.md の代わりにこれらを読み込む: ワーキングディレクトリまたはその上位ディレクトリにある CLAUDE.md、.claude/CLAUDE.md、または CLAUDE.local.md
• 該当しないため、AGENTS.md と一緒に読み込み続ける: ~/.claude/CLAUDE.md、組織が管理する CLAUDE.md、および .claude/rules/ ファイル

• セッション開始時: ワーキングディレクトリとその上位ディレクトリ内のすべての 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 インポート が展開され、claudeMdExcludes パターンが適用され、プロジェクト指示なしで起動する サブエージェントは、これらのファイルもなしで起動します
• 読み込まれない: AGENTS.local.md、AGENTS.override.md、または .agents/ ディレクトリ下のすべてのもの

​

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

{
  "pluginConfigs": {
    "cc-plugin-agents-md@builtin": {
      "options": { "instructionFiles": "claude-md-and-agents-md" }
    }
  }
}

​

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

• Claude Code v2.1.277 より前のバージョンを使用している
• /plugin を使用して、AGENTS.md を読み込む組み込みプラグインを無効にした
• 一部の場合、v2.1.276 以前から アップグレード した後の最初のセッションです。次のセッションから Claude は AGENTS.md を読み込みます

​

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

​

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

• @AGENTS.md を含む CLAUDE.md: そのままにしておくことができます。インポートを保持することで、使用する Project instructions 値に関係なく Claude が AGENTS.md を 2 回読み込むことはありません。CLAUDE.md が他に何も含まない場合は削除するか、一部のセッションが AGENTS.md を直接読み込むことができない 場合は保持してください。
• 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 つのファイルを共有する

@AGENTS.md

## Claude Code

Use plan mode for changes under `src/billing/`.

ln -s AGENTS.md CLAUDE.md

• 編集: Claude はリンクを通じて CLAUDE.md を読み込みますが、Edit および Write ツールは シンボリックリンクを通じた書き込みを拒否 し、拒否はリンクのターゲットである AGENTS.md を代わりに編集するよう Claude に指示します
• Windows: リポジトリをクローンする人が Windows で作業する場合は、@AGENTS.md インポートを代わりに使用してください。そこでシンボリックリンクを作成するには管理者権限または開発者モードが必要であり、core.symlinks が有効になっていない限り Git はコミットされたシンボリックリンクをプレーンテキストファイルとしてチェックアウトします。これにより、そのクローンに指示の代わりに 1 行の CLAUDE.md が残ります

​

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

• .cursor/rules/ または .cursorrules の Cursor ルール
• .github/copilot-instructions.md の Copilot ルール
• CLAUDE_CODE_NEW_INIT=1 が設定されている場合: AGENTS.md、.devin/rules/、.windsurf/rules/ または .windsurfrules、および .clinerules

​

自動メモリ

• user：あなたの役割、専門知識、および作業の好み
• feedback：Claude に与える修正と確認するアプローチ
• project：進行中の作業、期限、および Claude がコードまたは git 履歴から導き出せない決定
• reference：issue トラッカーやダッシュボードなど、プロジェクト外の情報を見つける場所

​

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

• バックグラウンドセッション
• 別の Claude Code セッションが開始したセッション（Claude が Bash ツールを通じて claude を実行した場合など）

{
  "autoMemoryEnabled": false
}

​

ストレージの場所

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

~/.claude/projects/<project>/memory/
├── MEMORY.md           # インデックス、メモリごとに 1 行、すべてのセッションに読み込まれます
├── user_role.md        # 1 つのメモリ
├── feedback_testing.md # 1 つのメモリ
└── ...                 # Claude が作成するその他のトピックファイル

​

仕組み

​

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

​

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

​

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

​

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

• /context を実行し、Memory files の下のリストを確認して、起動時に読み込まれるはずの CLAUDE.md と CLAUDE.local.md ファイルを確認します。そこにないファイルがある場合、Claude はそれを見ることができません。/memory を使用してファイルを開いて編集します。
• Instruction file not loaded という通知が表示された場合は、その意味と対処方法 を参照してください。
• 作業ディレクトリのサブディレクトリにある CLAUDE.md は、起動時ではなくオンデマンドで読み込まれるため、Memory files の下には表示されません。読み込まれると、そのパスを含む Loaded 行がターミナルに表示されます。新しいファイルをテストするには、Claude に書き込みを依頼するのではなくシェルから作成し、そのサブディレクトリ内のファイルを読むよう Claude に依頼します。
• 関連する CLAUDE.md がセッションに読み込まれる場所にあることを確認します（CLAUDE.md ファイルをどこに配置するかを選択する を参照）。
• 指示をより具体的にします。「Use 2-space indentation」は「format code nicely」よりも効果的です。
• CLAUDE.md ファイル全体で矛盾する指示を探します。2 つのファイルが同じ動作に対して異なるガイダンスを提供する場合、Claude は任意に 1 つを選択する可能性があります。
• Claude Code が独自に追加するガイダンスと指示が競合しているかどうかを確認します。CLAUDE.md がコミットまたはプルリクエストルールを設定する場合、includeGitInstructions で組み込みのものをオフにし、attribution で属性テキストを設定します。

​

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 を読み込むことができない ため、これらのバージョンでは v2.1.281 以降に更新してください。
3. セッションで /config を入力して設定パネルを開き、Project instructions が claude-md または managed-only に設定されていないことを確認します。そこに設定が表示されない場合、セッションは AGENTS.md を読み込むことができない セッションです。

​

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

​

CLAUDE.md が大きすぎる

​

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

​

関連リソース

• 設定をデバッグする: CLAUDE.md または設定が有効にならない理由を診断する
• Skills: オンデマンドで読み込まれる反復可能なワークフローをパッケージ化する
• Settings: 設定ファイルで Claude Code の動作を設定する
• Subagent メモリ: subagent が独自の自動メモリを保持できるようにする