AI News
Alle Meldungen
Offiziell

Claude Code 2.1.328 bringt neue Optionen für Self-hosted Runner und Orchestrator-Metriken

Das Release ergänzt --repository-folder, --metadata und neue Orchestrator-Metriken für Self-hosted Runner. Das eingebaute gh api ist dort nun standardmäßig deaktiviert.

Produkte · · 2 Min. Lesezeit

Anthropics Claude Code 2.1.328 vom 19. November 2026 bringt eine Reihe von Optionen und Orchestrator-Metriken für Self-hosted Runner. In diesem Setup startet ein vom Nutzer kontrollierter Host die Claude-Code-Sessions. Zudem ändert das Release das eingebaute gh api: Es ist nun überall dort standardmäßig deaktiviert, wo Einstellungen Claudes GitHub-Tools namentlich absichern. Laut Release Notes schaltet --use-anthropic-gh true das Tool wieder ein. Die Änderung steht unter Changed und nicht unter Added. Bestehende Setups, die auf das eingebaute gh api angewiesen sind, brauchen also dieses Flag, um es weiter nutzen zu können.

Die konkreteste Änderung betrifft Repository-Ordner bei --capacity 1. Bisher lag die Arbeitskopie eines Repositorys für eine Session an dessen Pfad unter dem Basisordner des Runners. Mit der neuen Option --repository-folder kann ein Betreiber diesen Ordner stattdessen selbst festlegen. Die Release Notes weisen darauf hin, dass der Pfad unter dem Basisordner kein symbolischer Link sein darf. Im selben Release lehnt ein Runner bei --capacity 1 eine Session außerdem früher ab, wenn der Pfad eines Repositorys, in das er pusht, ein symbolischer Link ist.

Das zweite Thema ist Labelling. Die Option --metadata key=value bei claude --environment versieht eine Session mit einem Label für den spawn-runner-Hook. --hook-label bei claude self-hosted-runner orchestrator gibt ausgewählte Session-Labels an denselben Hook weiter. Ein verwandter Fix sorgt dafür, dass --correlation-id von claude --environment diesen Hook erreicht, was bisher nicht geschah. Was spawn-runner mit den Labels macht, sagen die Release Notes nicht. Die Optionen beschreiben also, wie Daten zum Hook gelangen, nicht aber, was der Hook damit anfängt. Die beiden Session-UUID-Variablen CLAUDE_RUNNER_SESSION_UUID und CLAUDE_CODE_REMOTE_SESSION_UUID werden nun beide für die Session sowie für ihre checkout-, post-session- und spawn-runner-Hooks gesetzt.

Für Betreiber erhält der Orchestrator zwei Metriken auf seinem /metrics-Endpoint. Die erste, claude_code_self_hosted_orchestrator_sessions_given_up_total, zählt nach Ursache, wie oft Anthropic den Start eines Runners für eine Session aufgegeben hat. Die zweite, claude_code_self_hosted_orchestrator_session_queue_wait_by_reason_seconds, erfasst die Wartezeit in der Queue nach Grund. Laut Release Notes soll sie ermöglichen, die Wartezeit einer wieder geöffneten Session von der einer neuen zu unterscheiden. Welche Ursachen und Gründe die Metriken verwenden, führen die Notes nicht auf.

Eine Gruppe von Runner-Fixes ist konkreter als die Liste der Features. Ein Proxy oder Webfilter, der eine Abfrage mit HTTP 200 und einem Body wie {} beantwortete, stoppte bisher alle laufenden Sessions. Nun wiederholt der Runner eine solche Abfrage stattdessen. Nach einem vorübergehenden Festplattenfehler konnte ein Start die Objects oder Refs eines aufbewahrten Klons löschen, samt Commits, die nur dort existierten. Ein solcher Start schlägt jetzt fehl. Runner auf Hosts mit langsamer oder zurückgestellter Uhr stoppten bisher, sobald ihr Token ablief. Ein Runner, dessen Setup nach der Registrierung scheitert, meldet sich nun mit Angabe eines Grundes ab. Laut Release Notes kann das Ende einer Session auf einer defekten Festplatte standardmäßig 25 Sekunden länger dauern, weil der post-session-Hook bei hängender Festplatte nicht mehr übersprungen wird.

Insgesamt ist das Release umfangreich: Über die genannten Punkte hinaus enthält es 19 Verbesserungen und 91 Bugfixes. Viele davon betreffen Desktop-, Terminal- und Code-Mode-Funktionen statt der Runner. Die Self-hosted-Änderungen sind in den Notes unter eigenen Labels zusammengefasst.

Was sich ändert

Art: Inkompatible Änderung · Betrifft: Claude Code 2.1.328, gh api, --use-anthropic-gh, --repository-folder, --metadata, claude self-hosted-runner orchestrator

Warum es wichtig ist

Wer Self-hosted Runner für Claude Code betreibt, erhält neue Labels, Metriken und eine geänderte Voreinstellung beim GitHub-Tool, die beeinflussen kann, wie Sessions GitHub erreichen. Teams mit symbolisch verlinkten Repository-Pfaden könnten erleben, dass Sessions früher abgelehnt werden.

Was Sie tun können

Betreiber von Self-hosted Runnern sollten prüfen, ob sie auf das eingebaute gh api angewiesen sind und ob Repository-Pfade bei --capacity 1 symbolische Links sind.

Originalquelle

Wo wir es gesehen haben

1 Quelle

Claude Code changelog

KI hat diese Zusammenfassung aus den genannten Quellen geschrieben und ins Deutsche übersetzt. Niemand hat sie vor der Veröffentlichung einzeln geprüft. Bitte prüfen Sie die Originalquelle, bevor Sie sich darauf verlassen. So funktioniert es