Claude Code v2.1.248: Eingeschränkter Modus, Cache-TTL und Sitzungsbehebungen

Claude Code v2.1.248 wurde mit einem neuen eingeschränkten Ausführungsmodus, pro-Agent-Cache-TTL-Konfiguration und einer Reihe von Stabilitätsverbesserungen für Prompt-Caching und Sitzungsverwaltung veröffentlicht.

Eingeschränkter Modus

Sie können Claude Code jetzt mit --restricted ausführen (oder CLAUDE_CODE_RESTRICTED=1 setzen). Dadurch werden alle integrierten Tools entfernt, die Befehle oder Code ausführen, sowie WebFetch, sofern nicht explizit in --tools aufgeführt. Dateioperationen bleiben im Arbeitsverzeichnis, bypassPermissions wird verweigert, und Benutzer-/Projekt-/lokale Einstellungsdateien werden ignoriert. Dies ist nützlich für die Überprüfung nicht vertrauenswürdigen Codes oder für CI-Umgebungen.

Cache-TTL pro Agent

Sie können jetzt eine Prompt-Cache-TTL im Agent-Frontmatter über experimental.cacheTtl festlegen: "5m" oder "1h". Dies gilt, wenn keine Subagent-TTL konfiguriert ist, und gibt Ihnen eine feinere Kontrolle über den Cache-Ablauf für bestimmte Agenten.

Self-Hosted Runner und Einstellungsdiagnose

Der Befehl claude self-hosted-runner erhält ein neues Flag --client-label (oder SELF_HOSTED_RUNNER_CLIENT_LABEL), um das Standard-Label (Hostname) zu überschreiben. Beim Start wird nun gewarnt, wenn serververwaltete Einstellungen nicht geladen werden können, und /doctor und /status erklären den Fehlergrund. Außerdem können Enterprise-Mitglieder über /usage-credits höhere Limits bei Administratoren anfragen (AWS Marketplace, Self-Service, Testversionen).

Cross-Session-Messaging

Für Cross-Session-Messaging auf derselben Maschine wurden SendMessage und ListAgents hinzugefügt, die jetzt auf Bedrock, Vertex, Foundry und bei deaktivierter Telemetrie unterstützt werden.

Wichtige Korrekturen

• Prompt-Cache-Misses in langen Sitzungen (etwa stündlich), die durch erneutes Rendern von Tools nach OAuth-Refresh verursacht wurden – behoben.
• ScheduleWakeup-Tooldefinition änderte sich bei Überschreitung, was Cache-Misses bei --resume verursachte – behoben.
• Desktop/Cowork-Sitzungen verschwanden nach 30 Tagen – behoben; die neue Einstellung desktopSessionCleanupPeriodDays begrenzt die Ausnahme.
• Login-Schleife, wenn ein anderer Prozess die Token-Refresh-Sperre hielt – gibt jetzt einen wiederholbaren Fehler zurück.
• Windows: Die Agentenliste reagiert jetzt wieder auf Tastatur nach dem Ablösen oder im win32-Eingabemodus.
• /login mit gesetztem ANTHROPIC_API_KEY fällt auf die API-Key-Anmeldung zurück, anstatt mit OAuth zu scheitern.
• Modellnamen in /model werden als Code gerendert (z. B. [1m] wörtlich).
• Agenten überspringen die Workspace-Vertrauensaufforderung, wenn CI gesetzt ist – behoben, sodass sie angezeigt wird.
• Die Agentenansicht erweckt keine veralteten Hintergrundsitzungen mehr; beendete Sitzungen werden als beendet angezeigt.
• Doppelte Prozesse bei fortgesetzten Sitzungen – verhindert.
• Löschung von Sitzungen mit zusammengeführten, aber nicht gepushten Zweigen – erlaubt.
• Ungültige Hook-Antworten zeigen jetzt Hook-Name und Schemafehler an.
• Ungültiges JSON von Hooks wird als Fehler gemeldet, nicht stillschweigend als Text behandelt.
• /mcp listet Connector-Einträge unter dem tatsächlichen Geltungsbereich auf, und MCP-Server mit headersHelper führen den Helper bei 401 erneut aus, anstatt auf OAuth zurückzugreifen.