04 CLAUDE.md とメモリ

更新日: 2026-10-25

セッションは毎回まっさらなコンテキストで始まる。セッションをまたいで知識を持ち越す仕組みは2つ。

注意: どちらも「強制力のある設定」ではなく「文脈」。絶対に守らせたいこと(例: .env を触らせない)は Hook で強制する → 11_Hooks

CLAUDE.md

範囲	場所	共有
組織(管理ポリシー)	macOS: `/Library/Application Support/ClaudeCode/CLAUDE.md` など	組織全員
ユーザー	`~/.claude/CLAUDE.md`	自分(全プロジェクト)
プロジェクト	`./CLAUDE.md` または `./.claude/CLAUDE.md`	チーム(gitで共有)
ローカル	`./CLAUDE.local.md`(.gitignore に入れる)	自分(このプロジェクトだけ)

200行以下が目安。長いと守られなくなる
見出しと箇条書きで構造化
具体的に・検証可能に
- ✗「きれいに整形して」→ ○「インデントはスペース2つ」
- ✗「テストして」→ ○「コミット前に npm test を実行」
- ✗「整理して」→ ○「APIハンドラは src/api/handlers/ に置く」
矛盾するルールを作らない(どちらかが適当に選ばれる)
どうしても守らせたい1行だけ「IMPORTANT」を付ける(全部に付けると効かない)

各行について「これを消したら Claude はミスするか?」と自問し、No なら削る。

/init で雛形生成(CLAUDE_CODE_NEW_INIT=1 で Skills や Hooks まで対話的に作る)
@path/to/file で他ファイルを取り込む(最大4段、相対パスはそのファイル基準)
```
See @README for project overview and @package.json for npm commands.
- git workflow @docs/git-instructions.md
```
※ 取り込んだファイルも起動時に全部読まれる = 節約にはならない
/doctor prompt-audit … CLAUDE.md・Skills・サブエージェント・コマンドに「古いモデル向けの書き方」(過剰な強調など)が残っていないか監査(v2.1.283〜)
/doctor … コードから推測できる内容を削る提案
/context の「Memory files」で読み込まれたか確認

大きなプロジェクトではトピック別ファイルに分けられる。

.claude/
├── CLAUDE.md
└── rules/
    ├── code-style.md
    ├── testing.md
    └── security.md

paths を付けると該当ファイルを触った時だけ読み込まれる(コンテキスト節約):

---
paths:
  - "src/api/**/*.ts"
---
# API Development Rules
- 全エンドポイントに入力バリデーション

AGENTS.md は他のAIツール(Codex など)と共通の指示ファイル
CLAUDE.md が無ければ AGENTS.md を自動で読む(v2.1.277以降)。CLAUDE.md があれば CLAUDE.md だけ
この読み込みは組み込みの Mod cc-plugin-agents-md が担当している(/plugin の Installed → Built-in で確認できる)
両方読ませたい → /config の Project instructions を claude-md-and-agents-md に

1つのファイルを共有するおすすめ構成:

# CLAUDE.md
@AGENTS.md
## Claude Code
src/billing/ の変更はプランモードで。

Claude が作業中に「今後役立つ」と判断したことを自分でメモする(既定ON)
4種類: user(あなたの役割・好み) / feedback(訂正・承認されたやり方) / project(進行中の仕事・期限・決定) / reference(外部情報の場所)
コードから分かること、CLAUDE.md に既にあることは保存しない
保存先: ~/.claude/projects/<project>/memory/(MEMORY.md が索引、トピック別ファイル)
マシンローカル(他PCやクラウドとは共有されない)
「pnpm を使ってと覚えて」と言うと自動メモリへ。CLAUDE.md に書かせたいなら「CLAUDE.md に追加して」
確認・編集: /memory、無効化: autoMemoryEnabled: false