Claude Code v2.1.317 führt Cost-Analytics-API, OTel-Benutzerattribute und Block-on-Failure-Hooks ein

Claude Code v2.1.317 ist ein Wartungsrelease mit einigen Ergänzungen für Teams, die die App über ein Gateway betreiben, per OpenTelemetry überwachen oder auf dem Agent SDK aufbauen.

Kostenberichterstattung im Gateway

Die Admin-API des Claude-Apps-Gateways bietet jetzt GET /v1/organizations/analytics/cost. Sie liefert vergangene Ausgaben über einen Zeitraum, aufgeschlüsselt nach Gesamt, pro Entwickler, pro Tag oder pro IdP-Gruppe. Um die IdP-Gruppierung zu ermöglichen, führen Gateways mit gesetztem admin: nun eine tägliche Aufzeichnung der IdP-Gruppen jedes Entwicklers, die für admin.identity_retention_days aufbewahrt wird.

OpenTelemetry-Attribute

Vier neue Attribute werden an OTel-Metriken, -Events und -Spans angehängt:

• anthropic.plan
• anthropic.seat_type
• anthropic.provider
• anthropic.custom_base_url

Wenn Sie die Claude-Code-Telemetrie bereits in ein Dashboard scrapen, können Sie damit Traces nach Abonnementstufe oder nach dem Provider bzw. der Basis-URL aufteilen, über den die Anfrage lief.

Verhalten von Agent-SDK-Hooks

Hook-Callbacks akzeptieren jetzt onFailure: "block". Bisher ließ ein fehlschlagender Callback die Aktion fortfahren; mit dieser Einstellung blockiert der Fehler stattdessen die Aktion.

Datenschutz- und Planungsschutz

Zwei neue Abfragen reduzieren unerwartete Datenexposition:

• Eine Prüfung fragt nach, bevor ein Web- oder Shell-Tool-Aufruf Ihre Konto-E-Mail-Adresse über das Netzwerk sendet.
• /schedule warnt, wenn eine neue geplante Cloud-Aufgabe Connectors aufgreift, die Sie nicht angefordert haben, und zeigt, wie Sie sie entfernen.

Ebenfalls neu: Hinweise im Code-Tab von Claude Desktop, wenn die remote verwalteten Einstellungen Ihrer Organisation noch nicht geladen wurden und wenn sie geladen sind. Der Auto-Modus zeigt nun einen Hinweis an, wenn seine Prüfung keine Antwort für den Tool-Aufruf eines Subagenten hat, statt die Hauptansicht leer zu lassen.

Notausstieg für selbst gehostete Runner

Setzen Sie CLAUDE_CODE_DISABLE_NESTED_SESSION_ID=1 auf einem selbst gehosteten Runner, damit claude -p innerhalb einer Sitzung die ID und das Transkript dieser Sitzung verwendet und so das Verhalten vor der Änderung wiederherstellt.

Wichtige Fehlerbehebungen

• Projekt- und lokale MCP-Server trennten die Verbindung nach dem ersten Turn in einigen Desktop-Sitzungen.
• Der Auto-Modus schlug jeden Turn fehl, wenn eine LLM-Gateway-Basis-URL 403/422 an die serverseitige Sicherheitsprüfung zurückgab (403 mit apiKeyHelper bleibt unverändert).
• claude auth status beendete sich, bevor eine langsame Token-Aktualisierung gespeichert wurde, was Sie beim nächsten Lauf abmelden konnte.
• claude --from-pr meldete „No conversations found“ für ältere verlinkte Sitzungen in Projekten mit vielen Sitzungen.
• claude -p beendete sich mit 0, wenn eine volle Festplatte oder ein Quota das Transkript oder die Schreibvorgänge in ~/.claude.json verlor; jetzt wird ein Fehler ausgegeben und mit 1 in Text- und JSON-Ausgabe beendet. Volle NFS-Exporte werden möglicherweise übersehen.
• Änderungen an Einstellungsdateien, die in der ersten Sekunde nach dem Start vorgenommen wurden, traten erst bei einer weiteren Einstellungsänderung in Kraft.
• Alte Transkripte wurden nicht bereinigt, wenn Läufe die Bereinigung übersprangen, z. B. mit --setting-sources.
• Das Claude-Apps-Gateway verbarg den Bedrock-Fehler „Input is too long.“, wodurch Sitzungen jeden Turn mit „upstream rejected the request“ fehlschlugen, statt zu komprimieren.

Es gibt ein weiteres Dutzend Fehlerbehebungen für Agent-Teams, /team-onboarding, /loop-Aufwachsignale, Cloud-Sitzungstitel, aus claude.ai synchronisierte Skills und die Ausführlichkeit von Screenreadern – die vollständige Liste steht in den Release Notes.