Claude Code: コンテキスト管理

セッション開始 → CLAUDE.md + システムプロンプトを読み込み
              → 指示に基づいて関連ファイルを読み取り
              → 各ターンで履歴が蓄積
              → 上限に近づくと古い内容を切り捨て
              → 長いセッションは品質が低下する可能性

> /cost

Token usage:
  System prompt:     4,230 tokens
  CLAUDE.md:         1,850 tokens
  Project files:    52,400 tokens (12 files)
  Conversation:     28,600 tokens (8 turns)
  Code output:       8,920 tokens
  ─────────────────────────────────
  Total:            96,000 / 200,000 tokens (48%)
  Estimated cost:    $1.82

# 高消費（プロジェクト全体を読み取り）
> Help me refactor this project

# 中消費（範囲を限定）
> Refactor all services under src/services/

# 低消費（正確なファイルを指定）
> Refactor src/services/user.service.ts, extract validation logic to separate file

# 曖昧な指示：~80K tokens、$1.60
> Add a user search endpoint to the project

# 正確な指示：~25K tokens、$0.50（70%節約）
> In src/routes/user.ts, add GET /api/users/search endpoint,
> using searchUsers method from src/services/user.service.ts,
> following the search endpoint format in src/routes/product.ts

<!-- CLAUDE.md で作業範囲を制限 -->
## Current Work Scope
- Primary: src/api/ ディレクトリ
- Models: src/models/ ディレクトリ
- Current task: ユーザー権限モジュール

## Not Currently Relevant
- src/frontend/（独立したフロントエンド開発）
- src/migrations/（DB マイグレーション完了）
- docs/（ドキュメントは別管理）

# すべてのファイルを一度に読み込まない
> ❌ "Read all route files and refactor"
> ✅ "Read src/routes/user.ts and add pagination support"

# 完了後に続行
> "Now read src/routes/order.ts and add same pagination"

# 長いタスクを短いセッションに分割

# セッション1：モデル設計
claude "Design user permission DB model, only read prisma/schema.prisma"
# Ctrl+D で終了

# セッション2：ミドルウェア
claude "Based on the permission model, implement RBAC middleware"

# セッション3：ルート統合
claude "Integrate RBAC middleware into all routes needing permission checks"

# 最適化前：曖昧な指示 — 156K tokens（$3.12）
> Fix all test failures

# 最適化後：正確な指示 — 32K tokens（$0.64）
> Run npm test, only fix 3 failing tests in auth module,
> don't read frontend files

節約率：80%