Mod ou status line no Claude Code: qual usar para acompanhar a janela de contexto?

Fala aí, beleza? O contexto do Claude Code enche em silêncio, e você só percebe quando a qualidade das respostas cai ou quando o /compact chega batendo na porta

Até pouco tempo atrás, a forma mais comum de ficar de olho nisso era a status line, aquela barra no rodapé

Porém, desde o Claude Code 2.1.287 (lançado em 1º de outubro de 2026), os mods chegaram e já vêm ligados por padrão, sem nada pra ativar

E aí surgiu uma escolha nova: continuar com a status line ou usar um mod como o token-weather, que desenha uma previsão do tempo da sua janela de contexto logo acima do prompt 😀

Bora comparar os dois e ver qual faz mais sentido pro seu dia a dia?

O que é a status line do Claude Code e o que ela mostra da janela de contexto?

A status line é uma barra personalizável na parte de baixo do Claude Code

Ela roda o shell script que você configurar, recebe os dados da sessão em JSON pelo stdin e mostra na tela o que o script imprimir

Ou seja: ela não mostra nada "de fábrica", ela mostra o que VOCÊ mandar mostrar

Se quiser se aprofundar no conceito, tem um post só sobre o que a status line mostra aqui no blog

Quais campos de contexto a status line recebe:

No JSON que chega pro seu script, os campos ligados à janela de contexto são:

• context_window.total_input_tokens
• context_window.total_output_tokens
• context_window.context_window_size
• used_percentage

O context_window_size vale 200.000 tokens por padrão, ou 1.000.000 em modelos com contexto estendido

Tome cuidado com um detalhe: o used_percentage é calculado só com tokens de entrada, somando input_tokens, cache_creation_input_tokens e cache_read_input_tokens

Então se você montar uma conta própria juntando entrada e saída, o número não vai bater com essa porcentagem, e tá tudo bem, são medidas diferentes

Como configurar a status line:

O jeito manual é adicionar o campo statusLine no ~/.claude/settings.json, com type igual a command e o command apontando pra um script ou pra um comando inline

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

O jeito preguiçoso (e isso é bom!) é usar o comando /statusline e descrever o que você quer

O Claude gera o script, salva e configura as settings sozinho, next, next e finish haha

Quando a status line atualiza?

Ela é orientada a eventos, atualiza quando:

• chega uma nova mensagem do assistente
• o /compact termina
• o modo de permissão muda
• o modo vim é alternado
• o comando da statusLine é alterado

Além disso, existe o campo opcional refreshInterval, que roda o comando de novo a cada N segundos, com mínimo de 1 segundo

O que é o mod token-weather e como ele desenha a previsão do contexto?

Antes do token-weather, vale entender o que é um mod

Que mod? Mods são pequenas funções em JavaScript ou TypeScript que se conectam a eventos dentro do Claude Code

Eles podem reescrever prompts, bloquear ou reescrever chamadas de ferramenta, tratar pedidos de permissão e substituir partes da interface

Se você já mexeu com hooks em qualquer framework, a ideia é bem semelhante: você pluga uma função num momento específico do ciclo de vida

Os mods são distribuídos dentro de plugins e instalados com o comando /plugin (se a diferença entre plugins, skills e status lines ainda tá confusa, vale dar uma olhada)

De onde vem o token-weather:

O token-weather fica no repositório anthropics/claude-code-playground, na pasta claude-code/mods/token-weather

Ele é um mod de exemplo, então dá pra encarar como referência do que um mod consegue fazer

E é pequeno: cerca de 80 linhas, um único módulo de hooks que desenha uma linha de interface

Como ele lê o contexto:

Depois de cada turno do loop principal, o mod chama $.session.usage() pra ler os tokens de contexto, o tamanho da janela e a porcentagem

E se liga nisso: a chamada é gratuita, porque não pede detalhamento, então não dispara requisição de contagem de tokens

O que aparece na faixa acima do prompt:

Depois de cada turno, o token-weather mostra:

• um ícone e uma palavra de clima
• a porcentagem usada
• os tokens usados do total da janela
• um gráfico dos últimos 12 turnos
• quanto o último turno adicionou

As faixas de clima do token-weather:

É uma leitura bem intuitiva: bateu tempestade, é hora de pensar no que você vai fazer com essa sessão antes que o compact chegue 🙂

Status line x token-weather: comparação lado a lado

Resumindo a tabela: a status line é uma tela em branco que você pinta, o token-weather é um quadro pronto que você pendura na parede

Quando usar cada um?

Quando a status line faz mais sentido:

• você quer controle total do que aparece
• já tem uma barra com outras informações e só quer somar a porcentagem de contexto nela
• prefere não instalar código de terceiros
• quer algo pronto em segundos com o /statusline

Quando o token-weather faz mais sentido:

• você quer ver a tendência e o salto do último turno sem programar nada
• trabalha no CLI ou na aba Code do Claude Desktop
• aceita instalar um plugin vindo do repositório playground da Anthropic, depois de ler o código

Dá pra ter os dois?

Os dois ocupam lugares diferentes da tela: a status line fica no rodapé e o token-weather na faixa acima do prompt

Mas não existe confirmação oficial de como eles convivem juntos, então se for combinar, observe o comportamento na sua máquina antes de confiar cegamente nos números de um ou de outro

Como instalar o token-weather?

Bora ver na prática?

1. Confirme que seu Claude Code está na versão 2.1.287 ou superior

Erro comum deste passo: tentar rodar o mod numa versão anterior e achar que ele está quebrado, quando na verdade os mods nem existiam ainda

2. Clone o repositório e entre na pasta dos mods

git clone https://github.com/anthropics/claude-code-playground
cd claude-code-playground/claude-code/mods

3. Teste numa sessão, sem instalar nada de vez

claude --plugin-dir ./token-weather

4. Gostou? Instale de vez no escopo de usuário

claude plugin marketplace add ./
claude plugin install token-weather@claude-code-playground-mods --scope user

Erro comum: esperar ver a faixa de clima na extensão do VS Code ou numa execução headless

Lá a interface do mod não aparece, só os handlers rodam, então não adianta procurar a previsão por lá haha

Atenção com a segurança dos mods:

Tome cuidado! Mods não rodam em sandbox

Um mod é código que roda com as suas permissões: pode ler e gravar arquivos, iniciar processos, fazer requisições de rede e ler variáveis de ambiente e arquivos de settings, incluindo chaves de API

E mesmo se você ligar o sandbox, ele isola os comandos Bash do Claude, mas um processo iniciado por um mod roda fora dele

A orientação é instalar mods só de autores e marketplaces confiáveis

Se você administra isso numa empresa, existe uma página oficial de administração de mods para organizações em code.claude.com/docs/en/plugins/mods/admin

Veredito: qual usar para acompanhar a janela de contexto?

Pra maioria das pessoas, a status line continua sendo o padrão: é leve, é um script seu e você decide exatamente o que aparece

E com o /statusline o esforço de criar é praticamente zero

O token-weather brilha pra quem quer leitura visual de tendência pronta, com aquele gráfico de 12 turnos e o salto do último turno, e trabalha no terminal ou na aba Code do Desktop

Só lembra que ele é um mod de exemplo recém-lançado, então vale tratar como referência

São cerca de 80 linhas: leia antes de instalar, é rapidinho e evita surpresa com um código que roda com as suas permissões

Próximo passo:

Quer começar agora? Roda o /statusline e pede pra ele mostrar a porcentagem de contexto usada

Em segundos você já tem o termômetro no rodapé

Se depois bater a curiosidade da previsão visual, testa o token-weather com claude --plugin-dir ./token-weather numa sessão, e só então instala no escopo de usuário

E aí, vai de rodapé ou de previsão do tempo? =)

Até o próximo post!