Pular para o conteúdo principal

Personalização da Statusline

Intermediário

A statusline é a faixa persistente que o Claude Code exibe sobre a sua sessão. Personalizá-la mantém os fatos com que você se importa — qual modelo, onde você está, quanto contexto resta, sua branch do git — sempre à vista.

O que você pode exibir

  • Modelo em uso (para que você não rode acidentalmente um caro em uma tarefa trivial).
  • Diretório / projeto atual.
  • Orçamento de contexto — quão cheia está a janela, uma deixa para /compact.
  • Estado do git — branch, sujo/limpo e em qual worktree você está.

Como funciona

Você aponta a statusline para um script (configurado nas configurações) que recebe os dados da sessão e imprime uma linha. Como é apenas um script, você pode exibir qualquer coisa que consiga computar.

#!/usr/bin/env bash
# reads session JSON on stdin; prints a status line
input=$(cat)
model=$(echo "$input" | jq -r '.model.display_name // "claude"')
branch=$(git branch --show-current 2>/dev/null)
printf "%s · %s · %s" "$model" "$(basename "$PWD")" "${branch:-no-git}"

(Os campos exatos de entrada estão documentados — verifique antes de depender de uma chave específica.)

Não quer programar?

Ferramentas da comunidade (por exemplo, ccstatusline) fornecem statuslines prontas e configuráveis que você pode usar em vez de escrever a sua. Trate qualquer script de terceiros como código a revisar antes de confiar nele.

:::tip O campo mais útil Para a maioria das pessoas, orçamento de contexto + modelo ganham seu lugar: eles evitam as duas surpresas mais comuns — ficar sem contexto no meio da tarefa e queimar o modelo errado (mais caro). :::

Próximos passos