Watchtower: Ein lokaler Proxy zur Überwachung des Claude Code API-Datenverkehrs

Was Watchtower macht

Watchtower ist ein lokaler HTTP-Proxy kombiniert mit einem Echtzeit-Web-Dashboard. Es fängt den gesamten API-Verkehr zwischen Claude Code (oder der Codex CLI) und deren Backend-APIs ab. Dadurch können Entwickler jede Anfrage, Server-Sent Events (SSE)-Streams, Tool-Definitionen, System-Prompts, Token-Verbrauch und Rate-Limits in Echtzeit sehen.

Wichtige Funktionen und Motivation

Das Tool wurde mit Claude Code selbst erstellt. Laut dem Entwickler sendet Claude Code typischerweise 2-3 API-Aufrufe pro Benutzernachricht: einen für Quotenprüfungen, einen weiteren für Token-Zählungen und dann die eigentliche Streaming-Anfrage. Es startet auch Subagenten mit völlig anderen System-Prompts und kleineren Tool-Sets. Der Haupt-System-Prompt allein soll über 20.000 Token umfassen. Normalerweise ist diese interne Kommunikation für den Benutzer nicht sichtbar.

Einrichtung und Verwendung

Die Installation erfolgt über npm:

npm install -g watchtower-ai && watchtower-ai

Um es zu verwenden, führen Sie Claude Code aus und leiten Sie es über den Proxy, indem Sie eine Umgebungsvariable setzen:

ANTHROPIC_BASE_URL=http://localhost:8024 claude

Das Dashboard-Interface öffnet sich in Ihrem Browser unter http://localhost:8025.

Projektdetails

Das gesamte Projekt – einschließlich des Proxy-Servers, Provider-Erkennung, SSE-Parsing und des Dashboard-UI – wurde mit Claude Code erstellt. Es ist unter der MIT-Lizenz veröffentlicht, kostenlos und Open Source, und hat keine kostenpflichtigen Stufen oder Kontoanforderungen.

Der Entwickler erklärt, dass dieses Tool nützlich für Entwickler ist, die Reasoning-Traces sehen, Token-Verbrauchsmuster verstehen oder lernen möchten, wie der Agent-Harness funktioniert, um selbst bessere KI-Agenten zu bauen.