/statusline în Claude Code CLI

Configurare și Securitate Claude Code 2.1+

Configurează linia de stare din partea de jos a Claude Code: descrii ce vrei să vezi, iar Claude generează scriptul și actualizează setările.

Sintaxă & invocare
/statusline [descriere]

Ce face /statusline

Linia de stare (status line) este un rând personalizabil afișat deasupra indicatorilor din subsolul interfeței. Rulează un script shell care primește pe stdin date JSON despre sesiune, cum ar fi modelul, directorul curent, procentul de context folosit și costul estimat, și afișează ce tipărește scriptul.

/statusline acceptă instrucțiuni în limbaj natural. Claude Code generează un script în ~/.claude/ și actualizează automat setările; aprobi editările de fișiere dacă ți se cer. Fără argumente, configurează linia de stare pornind de la promptul shell-ului tău.

Configurația ajunge în câmpul statusLine din setări, cu "type": "command" și calea scriptului în command. Câmpurile opționale padding și refreshInterval (rulare la fiecare N secunde) ajustează afișarea. Linia de stare rulează local și nu consumă tokeni API.

Sintaxă și opțiuni

Opțiune / Parametru Descriere
[descriere] Ce vrei să afișeze linia de stare, în limbaj natural. Fără argument, se configurează după promptul shell-ului.
delete / clear / remove Ceri eliminarea liniei de stare, de exemplu /statusline delete.

Exemple practice de terminal

Exemplul 1: Modelul și procentul de context cu bară de progres

> /statusline arată numele modelului și procentul de context cu o bară de progres

Exemplul 2: Configurarea manuală în ~/.claude/settings.json

Scriptul trebuie să fie executabil (chmod +x ~/.claude/statusline.sh). Claude Code reîncarcă setările automat.

{
  "statusLine": {
    "type": "command",
    "command": "~/.claude/statusline.sh",
    "padding": 2
  }
}

Exemplul 3: Eliminarea liniei de stare

> /statusline delete

Greșeli frecvente și bune practici

  • Folosești tput cols în script ca să afli lățimea terminalului. Claude Code capturează ieșirea scriptului, așa că citești variabilele COLUMNS și LINES.
  • Aștepți ca un ceas sau starea git să se actualizeze singure. Scriptul rulează la evenimente (mesaj nou, terminarea /compact, schimbarea modului de permisiuni); pentru actualizări periodice setezi refreshInterval.
  • Nu observi că o linie de stare personalizată ascunde majoritatea indiciilor de taste din subsol, inclusiv esc to interrupt.

Comenzi înrudite