Barre de statut personnalisée Claude Code avec surveillance VPS en temps réel

Barre de statut personnalisée pour Claude Code : Surveillance VPS en temps réel

Les développeurs gérant Claude Code sur plusieurs serveurs perdent souvent du temps à changer de contexte pour vérifier l'état de leur infrastructure. La solution ? Une barre de statut personnalisée qui affiche les métriques clés des sessions et la surveillance VPS directement dans l'éditeur — sans basculer de contexte.

Architecture du système

Le système de surveillance repose sur deux composants principaux : un démon en arrière-plan pour interroger les serveurs et un script client pour afficher les données. Le démon vps-poller.sh exécute des requêtes SSH vers vos serveurs toutes les 30 secondes, récupérant quatre métriques essentielles :

• Utilisation de la RAM
• Charge CPU
• Espace disque utilisé
• Temps de fonctionnement du système

Les données sont mises en cache sous forme de fichiers JSON dans /tmp/, permettant au script client statusline.sh de récupérer les dernières infos instantanément sans appels réseau supplémentaires. Cela garde l'interface de Claude Code fluide et réactive.

Avantages clés de l'architecture :

• Faible surcharge réseau grâce au cache
• Zéro latence d'affichage
• Conception modulaire : le démon s'exécute indépendamment
• Gestion simultanée de plusieurs serveurs

Mise au point automatique sur le serveur actif

Vous travaillez avec plusieurs instances VPS ? Le plus gros désagrément, c'est de savoir quel serveur est en cours d'utilisation. Ce système y remédie en analysant automatiquement les logs de Claude Code.

Le script examine les 20 derniers Ko du transcript de session, en utilisant deux stratégies pour identifier le serveur actif :

• Détecte les commandes SSH (ssh, scp, sftp) et associe les adresses IP à votre liste de serveurs préconfigurés
• Recherche de secours par noms de serveurs MCP si vous utilisez exclusivement le Protocole de Contexte de Modèle

Exemple en action :

# Travail sur le serveur 'main' via SSH
▶ main●(R:42% D:55%) new● sec●

# Passage à 'sec' via MCP
main● new● ▶ sec●(R:61% D:70%)

# Serveur 'new' sous forte charge (toujours mis en évidence)
▶ main●(R:42% D:55%) new◉(R:92%) sec●

Les indicateurs de statut incluent :

• ● — tout va bien
• ◉ — charge élevée (RAM > 85 % ou disque > 90 %)
• ✗ — serveur injoignable
• ↻ — redémarré récemment
• ▶ — serveur actuellement actif

Intégration API Claude et suivi des coûts

La barre de statut se connecte à l'API Claude pour afficher les limites d'utilisation en temps réel et les estimations de coût de session. Elle détecte automatiquement votre type de compte :

• Abonnés Claude Max voient les coûts théoriques de session
• Utilisateurs API obtiennent la dépense réelle

Métriques API Claude affichées :

• Modèle actif — modèle actuel (ex. : Opus 4.6)
• Remplissage du contexte — barre de progression avec code couleur (vert → jaune → rouge)
• Quota restant — pourcentage utilisé pour les limites sur 5 heures (H) et hebdomadaires (W)
• Coût de session — dépense API estimée

Les données API sont mises en cache pendant 2 minutes pour réduire la charge, en récupérant les jetons OAuth depuis le magasin de credentials de votre système.

Installation et configuration

La mise en place est simplifiée pour un déploiement rapide, idéalement via Claude Code lui-même.

Installation rapide via Claude Code :

Clonez https://github.com/CreatmanCEO/claude-statusline et exécutez install.sh --ru

Installation manuelle pour les utilisateurs avancés :

git clone https://github.com/CreatmanCEO/claude-statusline.git ~/claude-statusline
bash ~/claude-statusline/install.sh --ru

Configuration surveillance VPS :

• Ajoutez les serveurs à ~/.claude/statusline.conf
• Définissez SHOW_VPS=remote
• Listez les serveurs dans VPS_SERVERS
• Lancez le démon : ~/claude-statusline/vps-poller.sh start

Notes par plateforme :

• Linux/macOS : support complet des fonctionnalités
• Windows : installation uniquement via Claude Code (ignorez PowerShell)
• Nécessite bash et jq préinstallés pour le traitement JSON

Fonctionnalités clés

• Surveillance VPS instantanée — état des serveurs sans changer d'outil

• Mise au point automatique — détecte le serveur actif depuis les logs Claude Code

• Intégration API Claude — limites en temps réel et coût de session

• Légère — pur bash + jq, sans Node.js ou runtime lourd

• Multiplateforme — Linux, macOS, Windows (avec limites)

Correctifs de compatibilité

Le développement et les tests ont résolu les principaux problèmes :

Permissions Windows :

• chmod échoue en PowerShell
• Correctif : instructions d'installation via Claude Code uniquement

Stockage jetons OAuth :

• Windows : .credentials.json
• Unix : .credentials
• Correctif : le script vérifie les deux

Guillemets JSON imbriqués :

• echo altère le JSON
• Correctif : passage à printf avec échappement correct

Chemin bash Windows :

• command -v bash renvoie des chemins avec espaces
• Correctif : appel direct à bash, sans vérification de chemin

Tous les correctifs ont été déployés en un jour après le lancement — la vitesse de l'open source en action.

Fonctionnalités avancées et personnalisation

Adaptez la barre de statut à votre flux de travail avec plusieurs modes d'affichage.

Segments personnalisables :

• Infos Git : branche actuelle et état des changements
• Stats code : lignes ajoutées/supprimées cette session
• Minuteur de session : temps passé à travailler
• Outils système : support MCP et autres protocoles

Optimisations performances :

• Empreinte minimale : démon utilise <1 % CPU
• Cache intelligent : mises à jour seulement sur changements
• Chargement paresseux : ignore les modules inutilisés

Le projet évolue grâce aux retours de la communauté. À venir : plus de protocoles de surveillance, ajustements UI et intégrations outils dev.

— Editorial Team