STATUSLINE · Ma barre d'état Claude Code : le prompt pour l'installer et comment la modifier

🎯 Ce que tu as ici : le prompt à coller dans Claude Code pour avoir exactement la même barre d'état que moi, puis la méthode pour la modifier (couleurs, seuils, lignes à retirer) sans que la prochaine mise à jour efface ton travail.

📟 Ce qu'elle affiche

Sous chaque réponse de Claude Code, jusqu'à neuf lignes (API et Tokens apparaissent dès que la session a démarré) :

• 📂 Dossier : le dossier courant et la branche git (un point orange s'il y a des fichiers non commités).
• 🤖 Modèle : le modèle Claude utilisé.
• 💰 Coût : vert sous 1 $, jaune de 1 à 5 $, rouge au-delà.
• 📝 Lignes : lignes ajoutées et supprimées pendant la session.
• ⚡ API : la part du temps passée à attendre Claude, et la durée de la session.
• ✎ Tokens : tokens générés, lus, et le taux de cache.
• 📡 Statusline : sa version, avec une flèche quand une mise à jour existe.
• 📊 Contexte : une barre de remplissage de la mémoire de la session, qui vire au rouge.
• 💬 Conseil : une phrase selon l'état de la session (« pense à faire une pause », « session coûteuse, nouvelle session recommandée »...).

💡 Si tu as un abonnement Pro ou Max, le coût affiché est une estimation au tarif de l'API : tu ne le paies pas en plus. Il reste utile pour sentir quand une session devient lourde.

🧩 D'où elle vient

Je ne l'ai pas écrite : c'est le projet open source claude-statusline d'Anthony Marandon, sous licence MIT (tu peux l'utiliser et la modifier librement). J'ai comparé mon fichier à la version publiée, la 2.2.0 : ils sont identiques. Tu installes donc la même chose que moi.

Prérequis : Claude Code, et l'outil jq (vérifie avec jq --version ; sur Mac : brew install jq). Testé par l'auteur sur macOS et Linux. Windows n'est pas vérifié : passe par WSL.

1️⃣ L'installer : le prompt à coller

Ouvre Claude Code et colle ce message tel quel :

Installe pour moi la statusline open source anthonymarandon/claude-statusline (licence MIT). Procède dans cet ordre et arrête-toi au premier problème :

1. Vérifie que jq est installé (jq --version). S'il manque, donne-moi la commande d'installation pour mon système et arrête-toi.
2. Télécharge https://raw.githubusercontent.com/anthonymarandon/claude-statusline/main/statusline-command.sh vers ~/.claude/statusline-command.sh. Lis-le en entier et résume-moi ce qu'il fait. Signale-moi tout appel réseau autre que la vérification de version sur l'API GitHub.
3. Fais une copie de sauvegarde de ~/.claude/settings.json (settings.json.bak), sans m'afficher son contenu.
4. Avec jq, ajoute ou remplace UNIQUEMENT la clé statusLine dans ~/.claude/settings.json :
   {"type": "command", "command": "bash ~/.claude/statusline-command.sh"}
   Toutes les autres clés doivent rester intactes. Vérifie que le fichier est toujours un JSON valide.
5. Teste le script avec un faux contexte et montre-moi la sortie :
   echo '{"model":{"display_name":"Test"},"workspace":{"current_dir":"/tmp"},"cost":{"total_cost_usd":0.42}}' | bash ~/.claude/statusline-command.sh
6. Dis-moi de relancer Claude Code pour la voir.

Pourquoi ce prompt plutôt que la commande d'installation officielle ? Parce que Claude lit le script avant de l'exécuter et sauvegarde ta configuration avant d'y toucher. Si tu préfères l'installeur officiel (il ajoute aussi les commandes /statusline-help, /statusline-update et /statusline-uninstall), lance-le dans ton application Terminal, pas dans Claude Code : il pose une question avec un menu à flèches qui demande un vrai terminal.

curl -fsSL https://raw.githubusercontent.com/anthonymarandon/claude-statusline/main/install.sh | bash

2️⃣ La modifier sans perdre ton travail

Le piège à connaître d'abord : la mise à jour (/statusline-update) télécharge la nouvelle version et remplace ~/.claude/statusline-command.sh, sans sauvegarde. Tout ce que tu as modifié dans ce fichier disparaît.

La parade : travaille sur une copie à toi, et fais pointer Claude Code dessus. Colle ce prompt :

Copie ~/.claude/statusline-command.sh vers ~/.claude/statusline-perso.sh, puis change UNIQUEMENT la clé statusLine.command de ~/.claude/settings.json pour qu'elle lance "bash ~/.claude/statusline-perso.sh". Garde toutes les autres clés, vérifie que le JSON est valide, sans m'afficher le fichier.

Contrepartie honnête : ta copie ne reçoit plus les mises à jour. Quand une nouvelle version sort et qu'elle t'intéresse, demande à Claude de reporter tes changements dessus.

3️⃣ Le prompt pour chaque modification

Le script garde une copie des dernières données envoyées par Claude Code dans ~/.claude/.statusline-debug.json. C'est ce qui permet de tester un changement sans attendre la réponse suivante. Colle ce prompt en remplaçant la ligne entre crochets :

Ma statusline Claude Code est le script ~/.claude/statusline-perso.sh.
Je veux : [décris ton changement, ex. « retirer la ligne Conseil » ou « passer le coût en rouge dès 2 $ »].

1. Lis le script et repère l'endroit exact à changer.
2. Montre-moi la modification avant de l'écrire.
3. Après mon accord, applique-la, puis teste :
   cat ~/.claude/.statusline-debug.json | bash ~/.claude/statusline-perso.sh
   et montre-moi la sortie.
4. Si la sortie est vide ou affiche une erreur, annule la modification.

🎛️ Les changements les plus demandés

Pour savoir quoi demander, voici où ça se passe dans le script :

• Retirer une ligne : tout en bas, chaque ligne affichée est un printf qui commence par son étiquette (📂 Dossier, 💬 Conseil...). Supprimer le printf retire la ligne.
• Changer une couleur : en haut, les variables C_PATH (dossier), C_GIT (branche), C_MODEL (modèle), C_ADD et C_DEL (lignes). Ce sont des codes couleur de terminal : demande simplement « mets le modèle en bleu », Claude trouvera le code.
• Les seuils du coût : la variable cost_cents compte en dix-millièmes de dollar, malgré son nom. 10000 veut dire 1 $, 50000 veut dire 5 $.
• Les seuils du contexte : la barre passe au jaune au-delà de 33 %, à l'orange au-delà de 60 %, au rouge au-delà de 80 %.
• Les phrases de conseil : une suite de conditions juste avant l'affichage (ctx_msg="..."). Tu peux réécrire les phrases à ta façon ou en ajouter.
• Afficher une donnée de plus : regarde ce que Claude Code envoie avec cat ~/.claude/.statusline-debug.json, puis demande à Claude d'ajouter le champ qui t'intéresse.

↩️ Revenir en arrière

• Retrouver ta config d'avant : demande à Claude de restaurer ~/.claude/settings.json.bak.
• Revenir à la version d'origine : remets "bash ~/.claude/statusline-command.sh" dans la clé statusLine.command. Ta copie perso reste sur le disque.
• Tout retirer : supprime la clé statusLine de ~/.claude/settings.json (ou tape /statusline-uninstall si tu as pris l'installeur officiel).

🔎 Vérifié le 01/10/2026 sur le dépôt GitHub du projet (version 2.2.0, licence MIT). Si quelque chose a changé depuis, le dépôt fait foi.