Claude Code: メモリシステム

プロジェクトメモリ > パーソナルメモリ > セッションメモリ
プロジェクトの CLAUDE.md がグローバルと矛盾する場合、プロジェクトが優先。

# グローバルメモリ（~/.claude/CLAUDE.md）
"I prefer TypeScript strict mode, functions under 20 lines"

# プロジェクトメモリ（project/CLAUDE.md）
"This project uses JavaScript (not TypeScript), functions up to 50 lines"

# 結果：Claude Code は JavaScript コードを生成し、関数は50行以内
# プロジェクトメモリがパーソナルメモリを上書き

# Claude Code はセッション内の以前の会話を記憶

> Create a UserService
[作成完了]

> Add password reset functionality to it
[Claude Code は UserService の場所を記憶し、直接修正]

> Add email verification too
[UserService のコンテキストを引き続き記憶]

# セッション終了後、会話履歴は保持されない

# セッション1：「関数型プログラミングスタイルを好みます」
# セッション2：非関数型のコードを生成する可能性 — 好みを記憶していない

# 解決策：好みを CLAUDE.md に書く

# CLAUDE.md

## Project Conventions (Persistent Memory)
- TypeScript strict モードを使用
- API レスポンス形式：{ code, data, message }
- エラーは AppError クラスを使用
- テストフレームワーク：Vitest

## Completed Work (Progress Memory)
- ✅ ユーザー認証モジュール（JWT）
- ✅ ロール権限システム（RBAC）
- 🔄 注文管理モジュール（進行中）
- ❌ 決済統合（未着手）

## Technical Decision Records (Decision Memory)
- 2026-08-15: インメモリではなく Redis キャッシュを選択（クラスタ対応が必要）
- 2026-08-20: TypeORM ではなく Prisma を採用（型安全性が優れている）
- 2026-08-25: 金額はセント整数を使用（浮動小数点エラーを回避）

> Remember: Payment module uses Stripe SDK, not direct REST API calls

Claude Code:
  → CLAUDE.md を更新中...
  → 追加："Payment integration uses Stripe SDK (not direct REST calls)"

# 後のセッションで：
> Implement payment refund functionality

Claude Code:
  → [CLAUDE.md から読み取り] Stripe SDK を使用
  → Stripe SDK を使用して payment.service.ts を作成 ✅

<!-- ~/.claude/CLAUDE.md -->

## Coding Preferences
- TypeScript strict モード
- const を優先し、let と var を避ける
- 関数は30行以内
- JSDoc コメントを追加
- ES Module を使用

## Testing Preferences
- describe/it スタイル（test() ではなく）
- テスト命名：should + 動詞 + 条件
- 外部依存をモックし、内部モジュールはモックしない

## Git Preferences
- コミット形式：conventional commits
- 各機能ポイントを別々にコミット

## Dislikes
- ❌ any 型を使用しない
- ❌ デバッグに console.log を使用しない
- ❌ TypeScript エラーを無視しない