How to Refresh CLAUDE.md in Cache

Details

Raw Data

{
  "id": "2afc43c8-aca2-4af4-9801-4b2edffec40e",
  "type": "general",
  "status": "completed",
  "title": "How to Refresh CLAUDE.md in Cache",
  "description": "Explaining how Claude Code reloads CLAUDE.md files",
  "context": {
    "output": "<div style=\"background:#1e1e1e;color:#e0e0e0;padding:20px;border-radius:8px;font-family:'Consolas','Monaco',monospace;\"><h2 style=\"font-family:sans-serif;color:#fff;margin:0 0 16px 0;\">Refreshing CLAUDE.md in Cache</h2><h3 style=\"font-family:sans-serif;color:#61afef;margin:16px 0 12px 0;\">Short Answer: It Already Happened</h3><p style=\"line-height:1.6;\">CLAUDE.md files are loaded <strong>fresh at the start of each session</strong>. Since you're already in this session, you're seeing the <strong>old version</strong> that was loaded when the session started.</p><h3 style=\"font-family:sans-serif;color:#61afef;margin:24px 0 12px 0;\">To Load the New CLAUDE.md</h3><div style=\"background:#2d2d2d;padding:16px;border-radius:6px;margin:12px 0;\"><pre style=\"margin:0;line-height:2;\"><span style=\"color:#c678dd;font-weight:bold;\">Option 1: Start New Session</span>\n<span style=\"color:#7f848e;\">Click the \"+\" button in the dashboard to start fresh.</span>\n<span style=\"color:#7f848e;\">New session = new CLAUDE.md load from disk.</span>\n\n<span style=\"color:#c678dd;font-weight:bold;\">Option 2: /compact Command (CLI)</span>\n<span style=\"color:#7f848e;\">In terminal Claude Code, run:</span>\n<span style=\"color:#98c379;\">/compact</span>\n<span style=\"color:#7f848e;\">This summarizes context and reloads CLAUDE.md.</span>\n\n<span style=\"color:#c678dd;font-weight:bold;\">Option 3: Just Keep Working</span>\n<span style=\"color:#7f848e;\">The current session has the system-reminder showing</span>\n<span style=\"color:#7f848e;\">the changes were detected. I can see them.</span></pre></div><h3 style=\"font-family:sans-serif;color:#61afef;margin:24px 0 12px 0;\">How Claude Code Handles CLAUDE.md</h3><table style=\"width:100%;border-collapse:collapse;margin:12px 0;font-size:14px;\"><tr style=\"border-bottom:1px solid #3d3d3d;background:#2d2d2d;\"><th style=\"padding:8px 12px;text-align:left;color:#e5c07b;\">Event</th><th style=\"padding:8px 12px;text-align:left;color:#e5c07b;\">CLAUDE.md Behavior</th></tr><tr style=\"border-bottom:1px solid #3d3d3d;\"><td style=\"padding:8px 12px;\">Session start</td><td style=\"padding:8px 12px;color:#98c379;\">Loaded fresh from disk</td></tr><tr style=\"border-bottom:1px solid #3d3d3d;\"><td style=\"padding:8px 12px;\">File modified mid-session</td><td style=\"padding:8px 12px;color:#e5c07b;\">Changes shown in system-reminder</td></tr><tr style=\"border-bottom:1px solid #3d3d3d;\"><td style=\"padding:8px 12px;\">/compact</td><td style=\"padding:8px 12px;color:#98c379;\">Reloaded fresh</td></tr><tr style=\"border-bottom:1px solid #3d3d3d;\"><td style=\"padding:8px 12px;\">Context window full</td><td style=\"padding:8px 12px;color:#98c379;\">Auto-compacted, reloaded fresh</td></tr></table><h3 style=\"font-family:sans-serif;color:#61afef;margin:24px 0 12px 0;\">What About Prompt Caching?</h3><p style=\"line-height:1.6;\">Anthropic's prompt caching is automatic and based on content hash. When CLAUDE.md content changes:</p><ul style=\"margin:12px 0;padding-left:20px;line-height:1.8;\"><li>Old cached prefix becomes stale (different hash)</li><li>New content builds new cache on first use</li><li>After ~2-3 turns, new content is cached</li></ul><div style=\"background:#3d2d1a;border:1px solid #f59e0b;padding:16px;border-radius:6px;margin:16px 0;\"><p style=\"margin:0;\"><strong style=\"color:#f59e0b;\">For this session:</strong> The system-reminder above shows the file was modified. I can see the changes. To get the <em>full</em> new CLAUDE.md in my initial context (not just diff), start a new session.</p></div></div>",
    "requestedAt": "2026-01-09T00:00:00.000Z",
    "requestId": "c665f00e-f232-4ed5-a5b5-28a256e7b0fd",
    "choices": [
      {
        "label": "Start new session",
        "value": "Start a new session to load the fresh CLAUDE.md files",
        "primary": true
      },
      {
        "label": "Keep this session",
        "value": "Continue with this session - I can see the changes via system-reminder",
        "primary": false
      }
    ],
    "turnTiming": {
      "totalMs": 35165,
      "ttfeMs": 520,
      "thinkingMs": 34645,
      "toolExecutionMs": 0,
      "toolCallCount": 0,
      "thinkingPct": 99,
      "toolsPct": 0,
      "ttfePct": 1
    }
  },
  "createdBy": "claude",
  "createdAt": "2026-01-08T14:53:43.783Z",
  "updatedAt": "2026-01-08T14:53:49.173Z",
  "requestId": "c665f00e-f232-4ed5-a5b5-28a256e7b0fd",
  "scope": "vibetools",
  "tags": [
    "claude-code",
    "documentation"
  ],
  "targetUser": "claude"
}