Claude Codeは、ワークフローのスタイルガイドラインや一般的なコマンドなど、セッション間であなたの設定を記憶できます。

メモリタイプを決定する

Claude Codeは階層構造で4つのメモリ場所を提供し、それぞれ異なる目的を果たします:

メモリタイプ場所目的使用例共有対象
エンタープライズポリシーmacOS: /Library/Application Support/ClaudeCode/CLAUDE.md
Linux: /etc/claude-code/CLAUDE.md
Windows: C:\ProgramData\ClaudeCode\CLAUDE.md
IT/DevOpsが管理する組織全体の指示会社のコーディング標準、セキュリティポリシー、コンプライアンス要件組織内の全ユーザー
プロジェクトメモリ./CLAUDE.mdプロジェクトのチーム共有指示プロジェクトアーキテクチャ、コーディング標準、一般的なワークフローソース管理を通じたチームメンバー
ユーザーメモリ~/.claude/CLAUDE.md全プロジェクトの個人設定コードスタイリング設定、個人ツールのショートカットあなただけ(全プロジェクト)
プロジェクトメモリ(ローカル)./CLAUDE.local.md個人のプロジェクト固有設定(下記参照、非推奨) あなたのサンドボックスURL、推奨テストデータあなただけ(現在のプロジェクト)

すべてのメモリファイルは、Claude Code起動時に自動的にコンテキストに読み込まれます。階層の上位にあるファイルが優先され、最初に読み込まれ、より具体的なメモリが構築される基盤を提供します。

CLAUDE.mdインポート

CLAUDE.mdファイルは@path/to/import構文を使用して追加ファイルをインポートできます。以下の例では3つのファイルをインポートしています:

プロジェクト概要については@READMEを、このプロジェクトで利用可能なnpmコマンドについては@package.jsonを参照してください。

# 追加指示
- gitワークフロー @docs/git-instructions.md

相対パスと絶対パスの両方が許可されています。特に、ユーザーのホームディレクトリ内のファイルをインポートすることは、チームメンバーがリポジトリにチェックインされない個別の指示を提供する便利な方法です。以前はCLAUDE.local.mdが同様の目的を果たしていましたが、複数のgit worktreeでより良く動作するため、現在はインポートが推奨され、非推奨となっています。

# 個人設定
- @~/.claude/my-project-instructions.md

潜在的な衝突を避けるため、インポートはmarkdownコードスパンやコードブロック内では評価されません。

このコードスパンはインポートとして扱われません: `@anthropic-ai/claude-code`

インポートされたファイルは再帰的に追加ファイルをインポートでき、最大深度は5ホップです。/memoryコマンドを実行することで、どのメモリファイルが読み込まれているかを確認できます。

Claudeがメモリを検索する方法

Claude Codeはメモリを再帰的に読み取ります:cwdから開始して、Claude Codeはルートディレクトリ / まで(含まない)再帰し、見つけたCLAUDE.mdまたはCLAUDE.local.mdファイルを読み取ります。これは、foo/bar/ でClaude Codeを実行し、foo/CLAUDE.mdfoo/bar/CLAUDE.md の両方にメモリがある大規模なリポジトリで作業する際に特に便利です。

Claudeは現在の作業ディレクトリ下のサブツリーにネストされたCLAUDE.mdも発見します。起動時に読み込む代わりに、Claudeがそれらのサブツリー内のファイルを読み取る際にのみ含まれます。

#ショートカットでメモリを素早く追加

メモリを追加する最も速い方法は、入力を#文字で始めることです:

# 常に説明的な変数名を使用する

これを保存するメモリファイルを選択するよう促されます。

/memoryでメモリを直接編集

セッション中に/memoryスラッシュコマンドを使用して、より広範囲な追加や整理のために、システムエディタでメモリファイルを開きます。

プロジェクトメモリを設定

重要なプロジェクト情報、規約、頻繁に使用されるコマンドを保存するCLAUDE.mdファイルを設定したいとします。

以下のコマンドでコードベース用のCLAUDE.mdをブートストラップします:

> /init 

ヒント:

  • 繰り返し検索を避けるため、頻繁に使用されるコマンド(ビルド、テスト、リント)を含める
  • コードスタイルの設定と命名規則を文書化する
  • プロジェクト固有の重要なアーキテクチャパターンを追加する
  • CLAUDE.mdメモリは、チームと共有する指示と個人設定の両方に使用できます。

組織レベルのメモリ管理

エンタープライズ組織は、すべてのユーザーに適用される中央管理されたCLAUDE.mdファイルをデプロイできます。

組織レベルのメモリ管理を設定するには:

  1. オペレーティングシステムに適した場所にエンタープライズメモリファイルを作成します:
  • macOS: /Library/Application Support/ClaudeCode/CLAUDE.md
  • Linux/WSL: /etc/claude-code/CLAUDE.md
  • Windows: C:\ProgramData\ClaudeCode\CLAUDE.md
  1. すべての開発者マシンに一貫した配布を確保するため、構成管理システム(MDM、グループポリシー、Ansibleなど)を通じてデプロイします。

メモリのベストプラクティス

  • 具体的にする: 「2スペースインデントを使用」は「コードを適切にフォーマット」よりも良い。
  • 構造を使用して整理: 各個別メモリを箇条書きとしてフォーマットし、関連するメモリを説明的なmarkdown見出しの下にグループ化する。
  • 定期的にレビュー: Claudeが常に最新の情報とコンテキストを使用するよう、プロジェクトの進化に合わせてメモリを更新する。