Deepseek ArtifactsDeepseek Artifacts
Personnalisation du terminal · /statusline en profondeur

Personnaliser la barre de statut Claude Code : scripts et idées

Allez au-delà de la première configuration : le JSON que reçoit votre script statusline, les champs qui méritent l'écran — modèle, tokens, coût, contexte, git — des idées de couleurs et de mise en page, et un script de la communauté à piller sans scrupule.

L'essentiel

  • /statusline écrit le script pour vous. Indiquez votre OS, demandez une portée globale et un fichier .sh/.ps1 séparé, puis approuvez les deux fichiers : une entrée statusLine dans ~/.claude/settings.json plus le script qu'elle désigne.
  • Le script lit un unique objet JSON sur stdin — model.display_name, workspace.current_dir, context_window.used_percentage, cost.total_cost_usd, rate_limits — et affiche exactement ce que vous voulez voir.
  • Demandez les champs en liste numérotée, colorez la barre de contexte par seuils (vert sous 50 %, rouge au-delà de 75 %), arrondissez les tokens en unités K et passez sur plusieurs lignes quand une rangée déborde.
  • Ou installez un script de la communauté : npx contextbricks vous donne le modèle, la branche et le commit git, un compteur de tokens façon briques et une alerte de limite hebdomadaire — à vous de décider quand lancer /compact ou /clear.

Claude Code's Hidden Status Line: Tokens, Model and Project, Your Way

Chaîne : 호두의 AI 분석실 (Waldo AI Lab)5:27

Ouvrir

ContextBricks: My Custom Claude Code Status Line

Script communautaire : Jeremy Dawes6:17

Ouvrir

Status line — official documentation

Docs : code.claude.com/docs

Ouvrir

Les faits de cette page sont recoupés avec la documentation officielle de la status line et les deux enregistrements ci-dessus ; les noms de champs JSON cités correspondent exactement à la référence officielle. Les captures d'écran sont des images tirées de ces enregistrements.

Les captures d'écran proviennent des tutoriels de 호두의 AI 분석실 et de Jeremy Dawes (ContextBricks), utilisées avec attribution et reliées à leur horodatage source à chaque étape.

Personnalisez la barre de statut, étape par étape

Un prompt /statusline bien rédigé, une seule fois

  1. 1

    Un prompt /statusline qui nomme votre OS, la portée et le fichier du script

    Lancez /statusline et posez d'emblée trois choses : votre système (Mac, Linux, Windows ou WSL), la configuration globale de la ligne, et un fichier .sh séparé — .ps1 sous Windows. Sinon, l'agent de configuration devine votre environnement et peut viser le mauvais shell, et un script au niveau du projet n'apparaît que dans un seul dépôt. Le prompt tient en quatre lignes ; gardez-le dans une note pour le réutiliser.

    Word document with the exact Claude Code /statusline prompt asking to set up the status line globally with a separate ps1 or sh script file beside the VS Code editor
    Le prompt /statusline préparé : OS, portée globale, fichier séparé — prêt à coller.Voir à 1:15
  2. 2

    Approuvez les deux fichiers que crée l'agent

    Accordez les autorisations de lecture et d'écriture, et l'agent rapporte exactement ce qu'il a touché : ~/.claude/settings.json contient désormais la configuration statusLine, et un script comme ~/.claude/statusline-command.sh génère le contenu de la ligne. La logique vit dans un fichier séparé — Claude ne modifiera plus tard que le script, pas vos réglages. Redémarrez Claude Code pour voir la ligne.

    Claude Code statusline-setup summary listing files created, a settings.json holding the statusLine configuration and statusline-command.sh that generates the status line content
    Fichiers créés/mis à jour : settings.json porte l'entrée statusLine, le script construit le contenu.Voir à 3:20
  3. 3

    Lisez la spécification de la ligne par défaut avant d'ajouter

    D'origine, la ligne générée affiche le répertoire courant, le nom du modèle comme [Claude Opus 4.5], le style de sortie s'il n'est pas celui par défaut, le mode vim, la branche git quand vous êtes dans un dépôt, et le pourcentage de fenêtre de contexte utilisé — par exemple Claude-project [Claude Opus 4.5] (git:main) 12 %. La configuration étant globale, elle s'applique à toutes les sessions Claude Code de la machine.

    Claude Code panel listing the default status line fields, current directory, model name, output style, vim mode, git branch and context window percentage, with the ordered add request below
    La liste d'affichage par défaut et un exemple rendu de la ligne générée.Voir à 2:45

Décider ce que la ligne affiche

  1. 4

    Demandez les champs voulus — numérotés

    Formulez les ajouts en liste ordonnée et l'agent renvoie un ordre d'affichage numéroté. Cette exécution a donné : nom du modèle, une barre de progression de 20 caractères, un pourcentage type 20 %, les tokens en 40000/200000, git:main, puis le répertoire du projet — rendu ainsi : Claude 3.5 Sonnet [==== ] 20% 40000/200000 git:main Claude-project. Les changements atterrissent dans le script ; redémarrez Claude Code pour les voir.

    Claude Code statusline-setup reply listing the display order from model name to project name with an example line reading Claude 3.5 Sonnet, progress bar, 20 percent, 40000/200000, git:main
    Ordre d'affichage 1-6 avec une ligne d'exemple, inscrits dans le script.Voir à 3:45
  2. 5

    Donnez à chaque élément une couleur qui a du sens

    Demandez une couleur par élément et le script reçoit des codes ANSI avec seuils. La table arrêtée ici : modèle en cyan ; barre de progression verte sous 50 %, jaune de 50 à 75 %, rouge au-delà de 75 % ; le pourcentage suit la barre ; tokens en magenta ; branche en vert ; projet en bleu ; séparateurs en gris. Gardez le rouge pour la barre de contexte : la couleur d'alerte reste réservée à la vraie pression.

    Element and color table for a Claude Code status line, model name cyan, progress bar green under 50 percent, yellow from 50 to 75, red above 75, tokens magenta, git branch green
    Table des couleurs élément par élément, avec seuils pour la barre de progression.Voir à 4:15
  3. 6

    Arrondissez les tokens en unités K et vérifiez avec /context

    Les compteurs bruts comme 21373/200000 se lisent mal. Demandez des unités K et la ligne affiche 21k/200k — l'agent précise que la valeur est arrondie. Vérifiez ensuite : lancez /context dans la même session et comparez ; les totaux concordent. Une bizarrerie de la démo : après arrondi, une session à 22k et une à 23K peuvent s'afficher pareil — largement assez pour une ligne qu'on lit d'un coup d'œil.

    Claude Code statusline-setup formatting tokens in k units, changing 21373 of 200000 tokens to 21k/200k, beside the status line color table and a rendered example
    21373/200000 devient 21k/200k ; /context confirme les mêmes totaux.Voir à 4:30
  4. 7

    Lancez deux sessions et vérifiez que chaque ligne se suit

    Ouvrez deux terminaux et lancez Claude Code dans chacun. Chaque ligne de statut ne rapporte que sa propre session : 11 % et 22k/200k à gauche, 9 % et 18k/200k à droite, pendant que /context dans chaque fenêtre concorde avec sa ligne. Voilà pourquoi branche et projet ont leur place sur la ligne — avec plusieurs onglets ouverts, vous voyez d'un coup d'œil laquelle pèse, sans lancer /context partout.

    Two terminal panels side by side each running Claude Code with its own status line, one showing 11 percent and 22k/200k tokens, the other 9 percent and 18k/200k
    Deux sessions Claude Code, chaque ligne de statut rapportant son propre contexte.Voir à 5:15

Piller un script, le lire chaque jour

  1. 8

    Économisez l'écriture : installez un script communautaire via npx

    Pas besoin d'écrire le script vous-même. ContextBricks s'installe en une commande — npx contextbricks —, écrit ~/.claude/statusline.sh et met à jour settings.json, sauvegarde créée au préalable. Sa liste : nom du modèle, message git repo:branch [commit], indicateurs de modifications non commitées, ahead et behind, lignes modifiées dans la session, usage du contexte en temps réel visualisé en briques, et une répartition des tokens. Désinstallation par ./uninstall.sh ; le chemin de sauvegarde affiché restaure le script précédent.

    Terminal running npx contextbricks showing installation complete, statusline.sh installed under .claude, settings.json updated with a backup, and the list of what the status line will show
    npx contextbricks : script installé, settings.json mis à jour, capacités listées.Voir à 0:20
  2. 9

    Lisez le compteur pendant que l'agent travaille

    La ligne personnalisée fait la différence en pleine session. Dans la démo, elle affiche [Sonnet 4.5], +2381/-0 lignes, puis une barre de contexte à 18 % (36k/200k tokens) avec le détail sys:4k tools:16k mcp:2k mem:10k msg:4k et 163k libres. L'auteur compte les tokens en analysant la transcription de la conversation — une estimation, pas un chiffre d'API —, à ses yeux assez exacte pour décider quand compacter ou effacer.

    Claude Code writing planning documents with the ContextBricks status line showing Sonnet 4.5, lines added and removed, an 18 percent context bar at 36k of 200k tokens and 163k free
    36k/200k tokens avec répartition par catégorie, pendant la rédaction des documents de planification.Voir à 5:00
  3. 10

    Clôturez sur signal : le commit atterrit, la limite hebdomadaire approche

    Après un commit git, la ligne récupère branche et commit : contextbricks:master [ffe9523] Add comprehensive planning documentation. Le bord droit ajoute un second signal — Approaching weekly limit. Entre le pourcentage de contexte, le marqueur de commit et l'alerte de limite, vous savez quand lancer /compact ou /clear volontairement au lieu de laisser la compaction automatique interrompre la tâche.

    Claude Code status line after a commit showing contextbricks master with commit ffe9523 message, a 19 percent context bar at 38k of 200k tokens and an Approaching weekly limit warning
    Branche et commit apparaissent dans la ligne ; l'alerte de limite hebdomadaire à droite.Voir à 6:02

Ce que votre script peut lire — champ par champ

Tout ce qui s'affiche vient d'un unique objet JSON que le script reçoit sur stdin — au démarrage de la session puis après chaque mise à jour : nouveau message de l'assistant, /compact terminé, changement de mode de permission. Voici les champs officiels qui méritent une ligne.

  • 1Modèle et effort — model.display_name comme étiquette (Sonnet 4.5, Opus 4.5), et effort.level si vous voulez afficher le niveau de raisonnement à côté.
  • 2L'endroit — workspace.current_dir est le champ privilégié pour le répertoire courant, workspace.project_dir le répertoire de lancement, et workspace.repo.owner/.name identifient le dépôt extrait du remote origin ; la branche s'obtient avec git branch --show-current.
  • 3Contexte — context_window.used_percentage et remaining_percentage sont précalculés, context_window.current_usage sépare input, output, création et lecture de cache, et context_window.context_window_size vaut 200000 par défaut (1000000 étendu).
  • 4Argent et temps — cost.total_cost_usd pour le coût de la session (remis à zéro par /clear), cost.total_duration_ms et total_api_duration_ms pour horloge réelle versus attente API, plus cost.total_lines_added et total_lines_removed.
  • 5Limites — rate_limits.five_hour et rate_limits.seven_day exposent used_percentage et resets_at sur les offres Pro et Max ; la doc inclut aussi un objet prompt_cache avec hit_ratio et expires_at pour des lignes conscientes du cache.

Détails pratiques de la doc : chaque echo ou print est sa propre ligne — les mises en page multi-lignes ne sont que des print supplémentaires ; les codes ANSI les colorent ; les variables d'environnement COLUMNS et LINES donnent la largeur du terminal ; et tout champ conditionnellement absent mérite un repli jq comme .context_window.used_percentage // 0, pour que la ligne survive aux premières secondes de session.

Quand la ligne fait des siennes

La plupart des lignes de statut cassées tiennent à cinq causes — et chaque réparation est à un prompt ou à une commande.

  • 1Ligne vide ou tirets (--) — ce sont des champs nuls avant la première réponse d'API. La doc recommande des replis jq (// 0, // empty), et l'invite de confiance du workspace doit être acceptée, sinon la ligne reste vide.
  • 2Le script ne s'exécute pas — rendez-le exécutable avec chmod +x, écrivez sur stdout plutôt que stderr, et lancez claude --debug pour voir ses erreurs.
  • 3Des chiffres faux — l'auteur de ContextBricks raconte que Claude s'est trompé plusieurs fois de suite sur le calcul des tokens. Demandez à l'agent de déverser le JSON brut dans un fichier de debug et de réécrire le script d'après lui ; comparez ensuite avec /context.
  • 4Confusion de shells sous Windows — Claude Code utilise Git Bash s'il est installé, sinon PowerShell ; des slashs dans les chemins et le script dans son propre fichier .ps1.
  • 5Trop sur une ligne — demandez du multi-lignes (le chemin et les infos du dépôt passent en deuxième ligne), ou allégez : tokens en unités K, une seule couleur de séparateur, et supprimez les champs que vous ne regardez jamais.

Et pour sortir complètement : /statusline delete (ou /statusline clear) retire la fonctionnalité, le uninstall.sh d'un installateur communautaire l'annule, et la sauvegarde des réglages laissée par l'installateur restaure votre script précédent.

FAQ barre de statut Claude Code

Guides liés