Claude Code v2.1.307: /claude-api-Versionskontrolle, Telemetrie von Sicherheitsereignissen und MCP-Zuverlässigkeitskorrekturen

Claude Code v2.1.307 bringt zwei entwicklerorientierte Neuerungen – API-Versions-Pinning für Claude-API-Code und Safety-Telemetrie pro Tool-Aufruf – zusammen mit einer langen Liste von Korrekturen für MCP, Runner und Sitzungsstatus.

Neu: API-Versions-Pinning und Safety-Event-Telemetrie

• /claude-api api-version verschiebt Claude-API-Code auf die API-Version 2026-10-21. Nützlich, wenn generierte API-Aufrufe eine bestimmte datierte Version ansprechen sollen statt der Standardversion des Modells.
• Ein neues OpenTelemetry-Event, claude_code.safety_event, wird für jeden Tool-Aufruf ausgelöst, den eine Berechtigungsregel, der Auto-Modus, eine Sicherheitsprüfung, ein Hook oder die Sandbox gestoppt, nachgefragt oder zurückgewiesen hat. Das liefert eine strukturierte Aufzeichnung jeder Intervention in deinen Agent-Loops, statt sie aus Transkripten abzuleiten.

Wichtige Korrekturen

• 1M-Kontext-Aliasse: Anfragen schlagen nicht mehr mit „model-not-found“ fehl, wenn CLAUDE_CODE_DISABLE_1M_CONTEXT gesetzt ist und das Modell ein Alias mit dem Suffix [1m] ist, z. B. opus[1m].
• Prompt-Caching: Der Beta-Header prompt-caching-scope wird nicht mehr hinter benutzerdefinierten ANTHROPIC_BASE_URL-Gateways oder auf Foundry gesendet, wo er keine Wirkung hatte.
• MCP-Authentifizierung unter macOS: claude -p meldet nicht mehr „needs authentication“, wenn der Login-Schlüsselbund gesperrt ist – es sagt warum, und der nächste Lauf nach dem Entsperren verbindet ohne neue Anmeldung.
• MCP Sleep/Timeout: Server, die mitten im Verbindungsaufbau waren, während ein macOS- oder Linux-Rechner schlief, werden nicht mehr als zeitüberschritten und in Headless-Läufen als fehlgeschlagen gemeldet.
• HTTP-MCP-Doppelaufrufe: Tool-Aufrufe werden nicht mehr zweimal gesendet, wenn die Verbindung mitten im Aufruf schließt; nur schreibgeschützte oder idempotente Tools werden wiederholt.
• SDK-MCP-Tools: Ein Turn startet nicht mehr ohne die neuesten Tools eines SDK-MCP-Servers, wenn eine Hintergrundaufgabe lief.
• Autocompact: Weniger „Autocompact is thrashing“-Fehler in Turns, die viele PDF-Seiten, Bilder oder große Tool-Ergebnisse lesen; /autocompact in Cloud-Sitzungen behält sein Fenster auch über Neustarts hinweg.
• /clear-Persistenz: Eine mit /clear gelöschte Konversation erscheint nach einem Neustart einer Cloud- oder selbstgehosteten Runner-Sitzung nicht mehr wieder.
• Agent SDK setModel(): Modellwechsel werden nicht mehr abgelehnt, wenn die API länger als 5 Sekunden zur Bestätigung braucht – Claude Code wartet jetzt bis zu 15 Sekunden.
• Berechtigungs-UI: /permissions > Recently denied zeigt jetzt den abgelehnten Shell-Befehl, und die Genehmigung einer Zeile nennt den Befehl statt seiner Beschreibung; der lokale Klassifizierer des Auto-Modus beachtet diese Genehmigung jetzt bei einem erneut versuchten Befehl.
• GitHub-MCP-Schreib-Tools: Ein Formular, das ohne Erstellung von etwas im Code-Tab der Desktop-App geschlossen wurde, wenn der Server direkt konfiguriert ist, wurde behoben.

Weitere Verbesserungen

• Nicht parsebare Tool-Aufrufe werden bis zu zweimal wiederholt, bevor der Turn mit einem Fehler endet.
• Zusammen gestartete Fork-Subagenten erfahren jeweils, welcher Start ihr eigener ist, was sitzungsübergreifende Arbeit reduziert.
• Die Browser-Anmeldung zeigt die Erfolgsseite, sobald die Anmeldung abgeschlossen ist, ohne auf das Kontoprofil zu warten.
• Websuche-403-Fehler in Cloud- und selbstgehosteten Runner-Sitzungen zeigen jetzt den Grund des Servers statt eines generischen „Authentication error“.
• Die Verbindungszeit von Remote Control wurde für Sitzungen mit großen eingefügten Bildern oder PDF-Lesevorgängen verbessert.
• Der Hinweis auf erschöpftes WebSearch-Budget teilt Claude jetzt auch mit, Suchmaschinen nicht über einen Browser oder Computer Use abzufragen.

Nutzer selbstgehosteter Runner erhalten zwei spezifische Korrekturen: --use-anthropic-git-proxy-Sitzungen committen keine .claude/settings.local.json mehr, die von einer früheren Sitzung im Clone hinterlassen wurde, und das Archivieren oder erneute Einreihen einer Sitzung während ihres Checkout-Hooks lässt keine Hook-Prozesse mehr laufen und den Runner-Slot belegt.