2026-08-02T00:12:44.253Z

Claude-Code-Überwachung: Erlaubnis für die Festnahme und fehlende Ergebnisse

Ein praktisches dreischichiges Design zur Kombination von Claude Code Telemetrie, Lebenszyklushaken und deterministischen Kontrollen, so dass die Aktivität nicht für ein gesundes Ergebnis verwechselt wird.

Die Überwachung von Claude Code braucht drei Schichten, nicht ein Dashboard. Verwenden Sie den offiziellen OpenTelemetry Feed von Claude Code für Verbrauch und Aktivität, Lebenszyklushaken für Wartezeiten und Terminalfehler und eine Projekt eigene Überprüfung für das tatsächlich angeforderte Ergebnis. Wenn Sie die dritte Schicht auslassen, kann eine Sitzung saubere Spuren, erfolgreiche Tool Anrufe und eine polierte endgültige Antwort haben, während das erwartete Patch, das Testresultat oder die Datei noch fehlt. Die angemessene Standardlage ist absichtlich gering: Exportieren Sie bearbeitete Metriken und Ereignisse, protokollieren Sie sechs Lebenszyklusereignisse ohne ihre freie Textnutzlasten und bewerten Sie dann das letzte Ereignis gegen eine Aufgabenspezifische Fertigungsvorhersage. Sammeln Sie keine Anzeigen oder Rohwerkzeuginhalte, nur um zu entscheiden, ob ein Lauf Aufmerksamkeit benötigt. Dieser Leitfaden baut diese Gestaltung aus den aktuellen Claude Code Schemata auf und testet die Entscheidungsordnung gegen sieben Sitzungen. Es geht nicht davon aus, dass ein Tool Call Fortschritt ist, dass eine Pause Fehler ist oder dass Stop bedeutet, dass die Arbeit abgeschlossen ist. Beginnen Sie mit drei verschiedenen Fragen. Die Überwachung wird klarer, wenn jedes Signal eine Frage beantwortet und es verboten ist, die anderen beiden zu beantworten. Schicht Eine Frage, auf die sie antworten kann. Signale Was sie nicht beweisen kann Telemetrie Was hat Claude Code konsumiert oder ausgeführt? Sitzungen, API Anfragen, Token, geschätzte Kosten, Tool Ergebnisse, Tool Entscheidungen, Dauer ob das gewünschte Ergebnis korrekt ist Lebenszyklus Warum ist diese Sitzung still oder endet? Erlaubnisantrag, Benachrichtigung, Hintergrund Aufgabe, geplante Aufwachen, Stopp, API End Turn, Sitzungsende ob eine Datei, ein Test oder ein externes Ergebnis gültig sind Ergebnis Hat diese Aufgabe das verheißene Ergebnis gebracht? Dateihash, Test Ausgangsstatus, Schemavalidierung, API Antwort, signiertes Artefakt Warum die Sitzung wartete oder wie viel es kostete Das offizielle Überwachungsdokumente des Claude Codes stellt Metriken durch das OTel Metrikprotokoll, Ereignisse durch Logs/Ereignisse und optional verteilte Spuren dar. Dokumentierte Metriken umfassen die Sitzungszahl, veränderte Linien, Kommitte, Pull Anfragen, Aktivzeit, Token und geschätzte Kosten. Ereignisse fügen eine schnelle Korrelation, API Ergebnisse, Tool Ergebnisse und Berechtigungsentscheidungen hinzu. Das ist ein hervorragender Beweis für die erste Schicht. Es ist kein Abschlussvertrag. Die Unterscheidung zählt bei gewöhnlicher Arbeit. Ein erfolgreiches Write Tool Ereignis sagt, dass ein Schreiben abgeschlossen ist. Es heißt nicht, dass die beabsichtigte Datei an der richtigen Stelle geschrieben wurde, dass das daraus resultierende Programm sie kompiliert oder dass der Benutzer diese Datei angefordert hat. Token und Kostenkurven können den verflüssigen Verbrauch aufdecken, aber eine kostengünstige Sitzung kann immer noch einen Schritt vor dem Lieferwert stoppen. Hinzufügen von Lebenszyklusbeweisen mit Claude Code Hakchen Claude Codes Referenzhaken bietet eine zweite Schicht, die ein ausschließlich nutzbares Dashboard verpasst. Vier Ereignisse sind besonders nützlich: PermissionRequest wird ausgelöst, wenn ein Berechtigungsdialog angezeigt wird. Wenn es sich um das jüngste ungelöste Ereignis handelt, wartet die Sitzung auf eine Person; sie ist nicht im Stillstand. Stop schießt, wenn der Hauptagent fertig ist. Die aktuelle Eingabe kann background tasks und session crons umfassen, so dass eine gestoppte Wende noch auf eine Shell Taske, Subbagent, Monitor Taske, Workflow, MCP Taske oder geplante Aufwachen warten kann. StopFailure wird anstelle von Stop abgefeuert, wenn ein API Fehler die Runde beendet. Seine dokumentierten Fehlerklassen umfassen Rate Limit, Überlastung, Authentifizierung, Abrechnung, ungültige Anfrage, fehlende Modell, Serverfehler und maximale Ausgabe Token. SessionEnd dokumentiert, warum die Sitzung beendet wurde. Es ist nützlich für die Reinigung und Prüfung, kann aber die Beendigung nicht blockieren. PostToolUse , PostToolUseFailure , Notification und PreCompact fügen einen nützlichen Kontext hinzu. Halten Sie ihre Semantik schmal: jüngste PostToolUse ist ein Beweis für Aktivität; wiederholte PostToolUseFailure ist ein Beweis für Werkzeugprobleme; PreCompact markiert einen Kontextübergang, der sich mit späteren Verhaltensweisen korrelieren lässt. Keines ist ein universelles Gesundheitsurteil. Bei einem Datenschutzminimal Sammler behalten Sie nur einen Zeitstempel, einen lokalen Hash Sitzungsidentifikator, den Ereignisnamen, den Werkzeugnamen, die Fehlerklasse, den Benachrichtigungstyp und die Anzahl der Hintergrund Tätigkeiten oder geplanten Aufwachen. Verlassen Sie transcript path , cwd , last assistant message , Bash Befehle, Tool Eingabe und Benachrichtigungstext, es sei denn, ein diagnostiziertes Nutzungsfall rechtfertigt diese. Die offiziellen OTel Standards unterstützen dieselbe Einschränkung. Schnelltext, Assistenzreaktionstext, Tool Argumente, Tool Input /Output Inhalte und Roh API Behörden sind standardmäßig deaktiviert. Wenn Sie OTEL LOG RAW API BODIES aktivieren, können Sie die gesamte Gesprächsgeschichte aufdecken; es sollte niemals ein zufälliger Fehlerbehebungsschalter sein. Verwandeln Sie die neuesten Beweise in einen Staat Die Entscheidung hier unten ist klein genug, um zu überprüfen. Es klassifiziert das letzte Ereignis für jede Sitzung, während ein externer Verifier outcome verified bereitstellt, wenn eine Wende aufhört. Der Befehl ist absichtlich. Ein Terminal API Fehler übertrifft ein aktuelles Aktivitätsereignis. Eine ungelöste Zustimmung wartet, keine Zeitpause. Hintergrundarbeit verhindert, dass ein Stop Ereignis als Vollendung behandelt wird. Erst nach Ausschluss dieser Fälle entscheidet der Prüfer zwischen complete und outcome missing . Die aufbewahrte Prüfvorrichtung verwendet sieben Sitzungen und eine 15 minütige Beispielschwelle: Wenn das Gerät mit einem festen Zeitstempel ausgeführt wird, werden alle sieben Linien reproduziert: Das ist eine Entscheidungsregel, kein Produktions Demon. Die 15 minütige Schwelle ist falsch für einen zweiminütigen Fliederjob und falsch für einen zweistündigen Aufbau. Setzen Sie die Frische von der erwarteten Cadenz und Dauer der Arbeit und halten Sie dann einen uncertain Pfad für fehlende oder widersprüchliche Beweise. Definition der Vollendung außerhalb des Gesprächs Der einzige Anwendungsspezifische Eingang des Klassifiziers ist outcome verified . Dieses Bit sollte möglichst aus einer deterministischen Prüfung stammen, nicht aus der Suche nach der letzten Assistentennachricht für done. Für eine Code Änderungs Aufgabe kann eine nützliche Fertigstellung all dies erfordern: 1. die erwarteten Akten unterscheiden sich vom Ausgangsaufwand; 2. der gerichtete Prüfbefehl erfolgreich abläuft; 3. die erzeugten Artefaktdekode oder das Paket können importiert werden; 4. das Ergebnis bleibt im zugelassenen Repository und in seinem Anwendungsbereich. Für eine Dokumentations Aufgabe benötigen Sie die Zieldatei, Frontmatter oder Schemavalidierung, alle zitierten lokalen Pfade und jeden Link Checker, dem das Repository bereits vertraut. Überprüfen Sie die erwartete Datei, analysieren Sie sie, validieren Sie die erforderlichen Spalten und vergleichen Sie die Zeilenzahl mit der Quellgrenze. Für eine API Änderung führen Sie den Vertragstest aus, anstatt eine HTTP Anfrage zu akzeptieren, die einfach zurückgegeben wird. Der Monitor sollte den Namen des Verifiziers, den Ausstiegstatus, die Beobachtungszeit und eine Zusammenfassung des Ergebnisses speichern. Wenn kein deterministisches Prädikat existiert, registrieren Sie outcome unknown . Ein unbekanntes Ergebnis kann eine Überprüfung verlangen; es sollte nicht schweigend gesund werden. Warnung über die nächste sichere Aktion Sieben Staaten brauchen nicht sieben Alarmgeräusche. Verweisen Sie jeden Zustand auf die kleinste nützliche Aktion: Staat Vorläufige Aktion working Mach nichts. waiting human die zuständige Person mit der Genehmigungskategorie unterrichten, ohne sie zu genehmigen waiting background die Abhängigkeit und ihre Frische zeigen; die Sitzung nicht neu starten failed: die Fehlerklasse und das Begrenzte Wiederversuchsrichtlinien aufzeigen outcome missing die fehlerhafte Fertigstellung zu zeigen und die Arbeiten für die Inspektion zu bewahren stalled Überprüfen Sie die Reichbarkeit und die erwartete Dauer, bevor Sie einen begrenzten Schub vorschlagen complete Beweise aufbewahren und das Problem schließen Diese Routing verhindert zwei teure Fehler. Erstens vermeidet es, einen Agenten, der richtig auf Autorität wartet, erneut zu versuchen. Zweitens vermeidet es, einen Gesprächsstillstand zu feiern, wenn die Projektbeweise besagen, dass das Ergebnis fehlt. Automatisierte Wiederherstellung erfordert strengere Grenzen als Überwachung. Ein Ausfall der Rate Limit kann nach einem Backoff wieder ausgelöst werden; ein Authentifizierungsfehler benötigt in der Regel eine Person; ein Genehmigungs Anruf darf nicht automatisch genehmigt werden, nur weil es alt ist. Nach jedem Eingriff, laufen Sie den Abschlussprädikat wieder aus. Ein erfolgreiches Kommando ist ein Beweis für Aktivität, nicht ein Beweis dafür, dass die ursprüngliche Aufgabe wiederhergestellt wurde. Das Entwurf wird ohne übermäßige Sammlung angewendet. Eine praktische Einführung kann schrittweise bleiben: 1. Claude Code Telemetrie mit Metriken und Ereignissen aktivieren, so dass alle Inhaltsprotokolle ausgeschaltet werden. 2. Bestätigen Sie, dass claude code.session.count oder claude code.user prompt den Sammler erreichen, bevor Sie Alarme erstellen. 3. Fügen Sie lokale Haken für PermissionRequest , Stop , StopFailure , Notification , PreCompact und SessionEnd hinzu. 4. Normalisieren Sie diese Haken Nutzkosten in den minimalen Umschlag; Hash Identifikatoren lokal und Drop Paths und freien Text. 5. Definieren Sie einen deterministischen Abschlussprädikat für eine Konsequenz Aufgabe. 6. Wiederholen Sie synthetische Ereignisse für jeden Staat, bevor Sie jemanden benachrichtigen. 7. Hinzufügen eines Alarms nur, wenn der Besitzer und die nächste Sicherheitsaktion explizit sind. Version der Normalisierung. Claude Code dokumentiert Mindestversionen für mehrere Felder, und Transkriptinterne sind ausdrücklich kein stabiles Vertrag. Sie bevorzugen die Haken und OTelfelder, die in der aktuellen Dokumentation aufgedeckt werden; bauen Sie keinen langlebigen Monitor auf, indem Sie Endpixel abschraben oder davon ausgehen, dass sich eine private Transkriptform nie ändern wird. Die nützliche Grenze für Sidewisp Claude Code liefert bereits starke Rohsignale. Die operative Lücke verwandelt diese Signale in eine eingeschränkte Gesundheitsentscheidung: Arbeiten, Warten, Versagen, Verfall oder Verfehlung des versprochenen ErgebnissesDann werden die Beweise und der sicherste nächste Schritt angezeigt. Sidewisp befindet sich derzeit in einer privaten Vorschauphase. Seine öffentliche Website und das Artikel System sind live, aber Produktion Claude Code Überwachung Adapter, Agent Gesundheit Sammlung und Wiederherstellung sind im Allgemeinen nicht versandt. Die beabsichtigte Rolle ist eine Gesundheitsschicht neben bestehenden Laufzeiten, nicht eine Ersatzlaufzeit, ein obligatorisches Modell Gateway oder ein autonomer Fixer. Wenn diese Grenze übereinstimmt, wie Sie Codierungsagenten bedienen, ist die private Vorschau Warteliste der passende nächste Schritt. Bis dahin ist das dreischichtliche Muster in diesem Leitfaden alleine nutzbar: Telemetrie für Aktivitäten, Haken für den Lebenszyklus und deterministische Kontrollen für Ergebnisse.