claude-code-project-memory

Claude Code プロジェクトメモリ（2026年1月）

CLAUDE.md プロジェクトメモリを設定し、トークンコストを抑えながら、セッションをまたいで Claude Code に安定した、適用範囲の明確な指示を与えます。

クイックリファレンス

メモリの種類	一般的な場所	目的
管理ポリシー	OS に依存（公式ドキュメントを参照）	組織全体の標準（セキュリティ、コンプライアンス）
プロジェクトメモリ	./CLAUDE.md or ./.claude/CLAUDE.md	共有するプロジェクトのコンテキストと規約
プロジェクトルール	./.claude/rules/*.md	トピック別のモジュール式ルール（テスト、セキュリティ、スタイル）
ユーザーメモリ	~/.claude/CLAUDE.md	複数のプロジェクトで共通する個人の設定
プロジェクトメモリ（ローカル）	./CLAUDE.local.md (git-ignored)	ローカル限定のプロジェクト固有の設定

読み込みの仕組み（概要）

• 再帰読み込み：現在の作業ディレクトリからファイルシステムのルート（/）の直前まで読み込みます。
• オンデマンド読み込み：cwd 配下のネストされた CLAUDE.md ファイルは、Claude がそのサブツリー内のファイルを読み取るときにのみ読み込まれます。
• インポート：@path/to/file で追加のコンテキストを取り込みます（最大深度：5。~ に対応）。

ワークフロー（ベストプラクティス）

1. 最小限の CLAUDE.md（50～120 行）から始めます。プロジェクトの概要、構成、「必ず守る」ルールを記載します。
2. 長いガイダンスや変更に弱いガイダンスは .claude/rules/ に移します（1 ファイルにつき 1 トピック）。
3. 詳細なドキュメントをメモリにコピーする代わりに、@imports をナビゲーションとして使います。
4. メモリをコードと同様に扱います。PR レビュー、オーナーシップ、定期的な整理（不要になったルールの削除）を行います。

適用パスを指定できるルール

.claude/rules/testing.md、.claude/rules/security.md などを作成します。ルールの適用対象がリポジトリの一部だけの場合は、適用範囲を指定します。

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

コマンド（Claude Code）

• > /memory でメモリを表示し、直接編集できます。
• > /init でプロジェクトメモリを初期化できます（現在の動作は公式ドキュメントを参照）。

クロスプラットフォーム戦略（AGENTS.md + CLAUDE.md）

複数のコーディングアシスタントに対応する場合は、正本となるファイルを 1 つにして、もう一方に反映させます。

• macOS/Linux：一方をもう一方へのシンボリックリンクにします。
• Windows：開発者モードが有効でない限り、シンボリックリンクよりコピー（または簡単な同期スクリプト）を優先します。

メモリファイルではツール固有の説明を避け、移植性を保ち、プロジェクトに厳密に焦点を当てます。

検証（簡易チェック）

• 同梱のリンターを実行します：bash frameworks/shared-skills/skills/claude-code-project-memory/scripts/lint_claude_memory.sh .
• メモリの変更をマージする前に、未解決の @imports とシークレットがないか手動で確認します。

リソース

リソース	目的
references/memory-patterns.md	パターンとアンチパターン
references/memory-examples.md	技術スタック別の完全な例
references/large-codebase-strategy.md	10 万～100 万 LOC の戦略
data/sources.json	公式リンク

関連スキル

スキル	目的
claude-code-skills	スキル作成のパターン
claude-code-agents	Claude Code エージェントの設定
docs-codebase	リポジトリのドキュメント作成パターン