Watchtower : Un proxy local pour surveiller le trafic de l'API de code Claude

Ce que fait Watchtower

Watchtower est un proxy HTTP local combiné à un tableau de bord web en temps réel. Il intercepte tout le trafic API entre Claude Code (ou le Codex CLI) et leurs API backend. Cela permet aux développeurs de voir chaque requête, flux d'événements envoyés par le serveur (SSE), définition d'outil, prompt système, utilisation des tokens et limite de débit en temps réel.

Fonctionnalités clés et motivation

L'outil a été construit en utilisant Claude Code lui-même. Selon le créateur, Claude Code envoie généralement 2-3 appels API par message utilisateur : un pour les vérifications de quota, un autre pour le comptage des tokens, puis la requête de streaming réelle. Il génère également des sous-agents avec des prompts système complètement différents et des ensembles d'outils plus petits. Le prompt système principal seul serait rapporté à plus de 20 000 tokens. Normalement, cette communication interne n'est pas visible pour l'utilisateur.

Configuration et utilisation

L'installation se fait via npm :

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

Pour l'utiliser, exécutez Claude Code en le pointant vers le proxy en définissant une variable d'environnement :

ANTHROPIC_BASE_URL=http://localhost:8024 claude

L'interface du tableau de bord s'ouvre dans votre navigateur à http://localhost:8025.

Détails du projet

L'ensemble du projet—y compris le serveur proxy, la détection des fournisseurs, l'analyse SSE et l'interface utilisateur du tableau de bord—a été construit en utilisant Claude Code. Il est publié sous licence MIT, est gratuit et open source, et n'a pas de niveaux payants ni d'exigences de compte.

Le créateur affirme que cet outil est utile pour les développeurs qui souhaitent voir les traces de raisonnement, comprendre les modèles de consommation de tokens, ou apprendre comment fonctionne le harnais d'agent afin de construire eux-mêmes de meilleurs agents d'IA.