Claude Code Usage Status Line

Des pictos à la place des labels

• ⌛ la fenêtre glissante de 5 heures
• 📅 les 7 jours, tous modèles confondus
• F la jauge du modèle en cours, ici Fable
• 💰 le solde ou les crédits restants
• 💸 le coût de la session, sur un compte facturé à l'API
• 🧠 la fenêtre de contexte

Les jauges par modèle gardent une initiale (F, s, o) et pas un picto : le libellé vient de l'API et change avec le modèle, une icône figée finirait par mentir.

Lisible sur les trois OS

Sous Linux, l'ancien symbole de session me sortait un carré. Ce n'était pas un problème d'encodage, la sortie est bien en UTF-8 : le caractère vivait dans un bloc Unicode que les polices monospace ne couvrent tout simplement pas.

Les pictos retenus sont des emoji à présentation couleur par défaut, donc rendus d'office par Segoe UI Emoji, Apple Color Emoji ou Noto Color Emoji selon le système. Sur une distribution Linux minimale, installez fonts-noto-color-emoji et c'est réglé.

Jauge par modèle et crédits

Sur les comptes migrés, Anthropic ne renvoie plus deux jauges fixes Sonnet et Opus mais une fenêtre hebdomadaire attachée au modèle en cours. La lettre affichée suit donc le modèle, F pour Fable.

Quand la fenêtre sature et que les crédits prennent le relais, le segment 💰 passe en mode détaillé et montre le dépensé, le plafond et le reste : 💰 €12.56/€14 (left €1.44). Les comptes non migrés conservent l'ancien affichage, avec s et o.

Répertoire condensé

Au lieu d'afficher ~/My Projects/Brol, le statusline n'affiche plus que Brol. Le chemin complet est rarement utile dans un terminal déjà positionné dans le projet : la feuille suffit à se repérer, et ça libère de la place pour les métriques.

Un préfixe ~ apparaît devant une valeur (par exemple ~5%) lorsque la donnée est périmée, c'est-à-dire quand le cache a expiré mais que l'API est en backoff 429 ou indisponible.

Projet auto-détecté

Affiche le nom du répertoire courant (feuille du chemin). Vous savez toujours sur quel projet vous travaillez, sans polluer la ligne avec le chemin complet.

Modèle actif

Voyez quel modèle est utilisé (Opus, Sonnet, Haiku ou GLM) directement dans la barre de statut. Le provider est détecté automatiquement.

Pourcentages d'utilisation

Fenêtre de 5 heures, 7 jours et jauge du modèle en cours (Sonnet et Opus séparés sur les comptes non migrés), avec indicateurs colorés : vert, jaune, rouge.

Compte à rebours

Sachez exactement quand vos limites se réinitialisent. Le décompte ↻ s'affiche à côté de chaque métrique concernée.

Fenêtre de contexte

Surveillez l'utilisation de votre fenêtre de contexte pour éviter d'atteindre la limite en pleine conversation.

Support z.ai / GLM

Affichage du solde de votre compte z.ai (💰 9.88$) avec conversion automatique vers la devise de votre choix (EUR, GBP, CAD…).

Indicateur de données périmées

Un préfixe ~ devant une valeur signale que le cache a expiré mais que l'API est indisponible (backoff 429). Vous savez toujours ce que vous lisez.

Cache intelligent et backoff

Cache de 1 minute par provider pour ménager les API. En cas de 429, backoff automatique de 5 minutes pour éviter de faire exploser les rate limits.

Zéro configuration (Claude)

Lancez l'installateur et c'est tout. Lit vos identifiants Claude automatiquement depuis ~/.claude/.credentials.json (et le Keychain sur macOS).

Étape 1 : récupérer le JWT

1. Ouvrir z.ai/manage-apikey/billing dans votre navigateur habituel
2. Se connecter (et résoudre le captcha si demandé)
3. Ouvrir les DevTools avec F12, aller dans l'onglet Network
4. Rafraîchir la page avec F5
5. Cliquer sur la requête nommée accountBalance
6. Dans Headers, copier la valeur de Authorizationsans le préfixe Bearer (le token commence par eyJhbGciOiJIUzUxMiJ9)

Étape 2 : sauvegarder le JWT

Un binaire compagnon ClaudeUsageStatusline.ZaiRefresh est fourni avec l'installation. Il valide le format du token et l'écrit dans ~/.claude/.zai-credentials.json.

Windows :

& "$env:LOCALAPPDATA\ClaudeUsageStatusLine\ClaudeUsageStatusline.ZaiRefresh.exe"

Linux / macOS :

~/.local/bin/ClaudeUsageStatusline.ZaiRefresh

Étape 3 (optionnelle) : devise d'affichage

Le solde est retourné en USD par défaut. Pour l'afficher en EUR (ou toute autre devise), éditez appsettings.json à côté de l'exécutable :

{
  "Zai": {
    "NativeCurrency": "USD",
    "DisplayCurrency": "EUR",
    "ExchangeRateCacheHours": 24
  }
}

Les taux sont récupérés une fois par jour depuis une API gratuite et mis en cache localement.

Quand rafraîchir le JWT ?

Le JWT de session n'a pas de date d'expiration explicite : sa durée de vie est contrôlée par les serveurs de z.ai. Il sera éventuellement invalidé après une période d'inactivité ou une déconnexion explicite.

Signes qu'il faut le renouveler :

• Le statusline affiche z.ai: token missing et vous invite à suivre les instructions de la nouvelle fenêtre
• Le préfixe de donnée périmée (~💰) persiste
• Les logs contiennent 401 Unauthorized

Dans les deux cas, ZaiRefresh s'ouvre tout seul dans une fenêtre : il n'y a plus qu'à coller un JWT frais.