Métriques Claude Code
Claude Companion
Un familier pixel qui veille sur votre Claude Code et réagit en temps réel : app de barre de menus macOS, plugin Stream Deck, bientôt Windows. Sessions live, /loop, tokens, coût et burn rate, le tout lu 100 % en local.
0
appel API · 100% local
App macOS
Une app de barre de menus
La version macOS autonome : un companion dans votre barre de menus qui affiche vos stats Claude Code sans Stream Deck. Même moteur que le plugin, donc les chiffres correspondent toujours.
Ce qu’elle fait
Sessions live, fleet, loops, tokens, coût par projet, burn rate, model mix, compteurs, activité, compte. Affichez, masquez, réordonnez.
Le companion vit en haut de l’écran, à côté de l’horloge. Son humeur suit votre fleet (working, waiting, done), avec un clignotement optionnel quand une session vous attend.
Voyez quelles sessions tournent en boucle : un marqueur ↻, un carré LOOP dans le fleet, une carte Loops dédiée avec cadence et compte à rebours. Lu directement dans le transcript.
Soyez prévenu quand une session vous attend, qu’un travail est livré ou qu’un /loop se termine, même app fermée. Contrôles master, par session et nouvelles sessions, formulation ajustable.
Cliquez une session pour aller droit à sa fenêtre ou son onglet, même en arrière-plan. Ghostty, Terminal.app, iTerm2 et autres.
Elle réagit, dans votre barre de menus
RUN La fleet tourne, tout est vert.
Trois thèmes, clair/sombre automatique
Aussi sur votre Stream Deck
La même chose sur du matériel : une petite créature pixel vit sur une touche et réagit à votre fleet en temps réel, entourée de tuiles live.
RUN La fleet tourne, tout en un coup d’œil.
Le companion réagit
une session tourne
une session vous attend
travail livré
tout est calme
Les 13 tuiles
Votre familier pixel réactif, 12 skins.
Le compte live de chaque session en une tuile : RUN, INPUT, END.
Combien de sessions dans un état donné : RUN, INPUT ou END.
Une session précise, son % de contexte, avec un ↻ si elle tourne en /loop.
Combien de sessions tournent un /loop, avec le compte à rebours du prochain run.
Streak et heatmap sur 12 semaines.
Usage de tokens par heure, votre pic.
Aujourd’hui, lifetime, ou sparkline 24 h.
Dépense équivalent-API, du jour au lifetime.
Dépense par projet et par modèle.
Tokens par minute sur la dernière heure.
Compteur jour/semaine : permissions, runs, sous-agents, loops lancés ou itérations.
Un récap partageable de vos stats.
Local-first & vie privée
Claude Companion est conçu pour être d’un ennui rassurant avec vos données.
- ›Lit vos fichiers Claude Code locaux sous ~/.claude, en lecture seule.
- ›Aucun appel réseau, aucune API. Ni compte, ni clé.
- ›Aucune télémétrie. Rien n’est collecté, stocké à distance, ni partagé.
- ›Les coûts sont une estimation équivalent-API, pas une facture, et ne quittent jamais votre machine.
Installation
Installez l’app macOS, ou le plugin depuis l’Elgato Marketplace puis glissez n’importe quelle tuile sur une touche. Tokens, coût, coût projet et activité fonctionnent immédiatement.
Sessions live : pourquoi un hook
Certaines tuiles ont besoin de savoir si une session travaille, attend, ou a fini : un état que Claude Code ne stocke nulle part. Un petit hook le capte.
-
Sans rien
Tokens, coût, coût projet et activité marchent déjà : Claude Code écrit les transcripts.
-
Ce qui manque
L’état live (
working,waiting,done) n’existe dans aucun fichier. -
Le hook
Un plugin écoute les événements de Claude Code et écrit l’état dans
~/.claude/deck-state, lu par l’app.
La détection de /loop ne demande aucun réglage : la tuile Session affiche un ↻, la tuile Loops compte les boucles actives, et tout est lu directement dans le transcript, toujours 100 % local.
Dans Claude Code, l’activer installe les hooks automatiquement :
Une commande à la fois : copiez, collez, validez, puis la suivante.
- 1
/plugin marketplace add https://github.com/denisvinciguerra/claude-companion-hooks - 2
/plugin install claude-companion@claude-companion - 3
/reload-plugins
FAQ
Faut-il une clé API Claude ou Anthropic ? +
Non. Claude Companion lit seulement les fichiers que Claude Code écrit déjà sur votre machine. Aucun appel API, aucune clé à saisir.
Le coût affiché est-il ma vraie facture ? +
Non. Sur un abonnement forfaitaire il n’y a pas de facture au token : la tuile coût montre une estimation équivalent-API, étiquetée comme telle.
Une tuile affiche un tiret ou zéro. +
Il n’y a pas encore de données locales pour cette métrique. La tuile se remplit au fil de votre usage de Claude Code.
Le companion dort toujours, ou mes tuiles Fleet/Session sont vides. +
Ces tuiles live nécessitent le plugin optionnel pour Claude Code (voir Installation). Tokens, coût et activité fonctionnent sans lui.
Téléchargements
Le dépôt GitHub est privé pour l’instant, il s’ouvre bientôt.