Claude Code: إدارة السياق

Session start → Load CLAUDE.md + system prompt
              → Read relevant files based on instructions
              → Each turn accumulates history
              → Early content truncated when approaching limit
              → Long sessions may degrade in quality

> /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

# High consumption (reads entire project)
> Help me refactor this project

# Medium consumption (limited scope)
> Refactor all services under src/services/

# Low consumption (precise files)
> Refactor src/services/user.service.ts, extract validation logic to separate file

# Vague instruction: ~80K tokens, $1.60
> Add a user search endpoint to the project

# Precise instruction: ~25K tokens, $0.50 (70% savings)
> 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

<!-- Limit work scope in CLAUDE.md -->
## Current Work Scope
- Primary: src/api/ directory
- Models: src/models/ directory
- Current task: User permission module

## Not Currently Relevant
- src/frontend/ (independent frontend dev)
- src/migrations/ (DB migration complete)
- docs/ (docs maintained separately)

# Don't load all files at once
> ❌ "Read all route files and refactor"
> ✅ "Read src/routes/user.ts and add pagination support"

# Continue after completion
> "Now read src/routes/order.ts and add same pagination"

# Split long tasks into short sessions

# Session 1: Model design
claude "Design user permission DB model, only read prisma/schema.prisma"
# Ctrl+D exit

# Session 2: Middleware
claude "Based on the permission model, implement RBAC middleware"

# Session 3: Route integration
claude "Integrate RBAC middleware into all routes needing permission checks"

# Before: Vague instruction — 156K tokens ($3.12)
> Fix all test failures

# After: Precise instruction — 32K tokens ($0.64)
> Run npm test, only fix 3 failing tests in auth module,
> don't read frontend files

Savings: 80%