O painel de controle: custo e saúde das suas sessões
Cada mensagem ao Claude gasta um pouco do limite do seu plano. Com várias sessões rodando, o gasto cresce rápido, e o contexto enche de coisa que nem é usada. Nesta aula você entende o que é custo aqui, aprende a medir com /usage e /context e monta um painel de controle simples para manter tudo leve e à vista.
1O que é custo aqui: tokens, contexto e limites do plano
2Medir com /usage e /context e enxugar as skills
3Diagnosticar a instalação e conferir mods sem susto
4Quando chamar um modelo mais forte e deixar o consumo à vista
Objetivo: medir e controlar o consumo do Claude com /usage, /context, /skill-doctor, /doctor, /advisor, /recap e a status line.
01 · Seis pontos do painel de controle
Toque ou clique em cada ponto.
Aula 701 · Seis pontos do painel de controleToque ou clique em cada ponto.
1/7
Medir
Antes de cortar, meça. O /usage mostra o custo da sessão, quanto do plano você já usou e estatísticas. O /context mostra uma grade colorida do que está ocupando o contexto. No app Desktop, o anel ao lado do seletor de modelo mostra o uso.
Role a página: cada etapa abaixo acende a sua parte do diagrama.
1/7
Medir
Antes de cortar, meça. O /usage mostra o custo da sessão, quanto do plano você já usou e estatísticas. O /context mostra uma grade colorida do que está ocupando o contexto. No app Desktop, o anel ao lado do seletor de modelo mostra o uso.
2/7
Contexto
Skill é uma pasta com um arquivo SKILL.md de instruções que o Claude pode usar. A lista com nome e descrição de todas as skills entra no contexto a cada mensagem, usadas ou não. O /skill-doctor mostra as que você não usa, quanto custam e onde desligar cada uma.
3/7
Configuração
O /doctor diagnostica a instalação e a configuração. Dentro da sessão, ele propõe correções e espera você confirmar. No terminal, o claude doctor só lê e mostra o resultado.
4/7
Decisões
Fable, Opus e Sonnet são nomes de modelos do Claude: o Fable é o mais forte e o Sonnet o mais leve. O /advisor liga um desses modelos para o Claude consultar nos momentos-chave. É mais um modelo trabalhando, então consome mais. Use só onde há decisão grande.
5/7
Retomada
O /recap devolve, na hora, um resumo de uma linha da sessão. Serve para voltar a uma sessão sem reler tudo e para conferir se ela ainda está no rumo.
6/7
Consumo
A status line é a barra no rodapé do Claude Code. Ela pode mostrar a pasta, o modelo, o uso do contexto e os limites do plano em %. O jeito mais fácil de montar é o comando /statusline, dizendo o que você quer ver.
7/7
Painel montado
Consumo medido, contexto enxuto, instalação sadia, modelo forte só onde vale, retomada em uma linha e limites à vista: é isso que deixa várias sessões baratas de manter.
Medir primeiro, depois enxugar, diagnosticar, reforçar só onde vale e deixar o consumo à vista.
02 · O que é custo aqui
Quatro ideias para entender de onde vem o gasto. Sem fórmula, sem preço.
1. Tokens
Tokens são pedaços de texto. O modelo lê tokens (a sua mensagem e tudo o que vem junto) e escreve tokens (a resposta).
É assim que o uso é medido: quanto mais tokens, mais uso.
Na práticaUma pergunta curta numa conversa nova gasta pouco. A mesma pergunta numa conversa longa gasta mais, porque o histórico vai junto.
2. Contexto
Contexto é tudo o que a sessão carrega a cada mensagem: o histórico da conversa, os arquivos abertos e a lista de skills.
Quanto mais contexto, mais tokens por mensagem. Duas coisas ajudam sozinhas: o cache (o Claude guarda partes que se repetem para gastar menos) e a compactação automática (quando o contexto enche, ele resume o histórico). Mesmo assim, contexto inchado continua pesando.
Como verDigite /context na sessão: aparece uma grade colorida do que ocupa o contexto.
3. Limites do plano
Nos planos Pro e Max, o uso vem incluído na assinatura, com limites de sessão e limites semanais. Os limites são compartilhados entre os modelos.
Quando passa do limite, o Claude avisa ("You've hit your session limit" ou "weekly limit") e você espera o limite voltar.
Como verDigite /usage: mostra o custo da sessão, quanto do plano já foi usado e estatísticas. Os apelidos /cost e /stats abrem o mesmo.
4. O que soma
Cada sessão, e cada teammate de um time, tem o próprio contexto. Então o consumo cresce com o número de sessões ativas ao mesmo tempo.
O advisor também soma: é um modelo mais forte sendo consultado além do principal.
Para a AnaTrês clientes, três sessões, cada uma com o seu histórico: o gasto é de três conversas, não de uma.
03 · O painel na agência da Ana
Ana tem uma agência com 3 clientes. A padaria recebe um relatório semanal, a clínica recebe os posts da semana e a loja de roupas tem uma planilha de preços. Cada cliente tem a sua sessão.
1. Enxugar
Ana roda /skill-doctor na sessão da padaria, a do relatório semanal. O relatório abre na aba Stats do /plugin, o menu onde você ativa e desativa plugins (pacotes de extensões do Claude Code). Ele mostra duas skills que ela instalou, testou uma vez e nunca mais usou, e diz onde desligar cada uma.
Skill pessoal fica em ~/.claude/skills/[nome]/ e skill do projeto em .claude/skills/[nome]/: para desligar, apague ou mova a pasta. Skill que veio num plugin se desativa pelo /plugin. Skill que veio do claude.ai se desliga na sua conta.
Se o relatório vier vazioTudo bem: você não tem skill instalada. O /skill-doctor não lista as skills que já vêm com o Claude Code.
2. Diagnosticar
Uma sessão começou a dar aviso estranho ao abrir. Antes de mexer em arquivo, Ana roda claude doctor no terminal: ele só lê e mostra o que achou.
Depois, dentro da sessão, roda /doctor. Ele propõe a correção e espera o OK dela. Nada muda sem confirmação.
RegraPrimeiro olhar (claude doctor), depois corrigir (/doctor), sempre com o seu OK.
3. Reforçar
A planilha de preços da loja vai ganhar uma coluna nova, com uma regra de desconto por coleção. É uma decisão grande. Ana liga /advisor opus nessa sessão: o Claude passa a consultar o Opus, um modelo mais forte, nos momentos-chave.
Na sessão da clínica, que monta os posts da semana sempre no mesmo formato, o advisor fica desligado. Ali ele só gastaria mais.
RegraModelo forte onde há decisão grande; tarefa repetitiva fica sem advisor.
4. Enxergar
Ana digita na sessão: /statusline mostre a pasta, o modelo e o uso do contexto e do limite de 5 horas em %. O Claude monta um pequeno script (um arquivo com comandos que o computador roda sozinho) e grava a configuração no arquivo ~/.claude/settings.json.
Por que 5 horas: o limite de sessão do plano funciona numa janela de 5 horas, e a status line oficial mostra em % o uso dessa janela (5h) e o da semana (7d). A partir daí, o rodapé mostra o consumo o tempo todo. No fim do dia, Ana usa /recap em cada sessão.
Para mudarQuer ver outra coisa no rodapé? Rode /statusline de novo com outro pedido, por exemplo "mostre também o uso da semana em %".
04 · Mods sem susto
Um mod muda como o Claude Code aparece e se comporta. Antes de instalar um, entenda quatro palavras.
1. Mod
Plugin é um pacote de extensões do Claude Code: pode trazer skills, comandos, hooks. Mod é um plugin que muda como o Claude Code aparece e se comporta: desenha uma faixa, a status line, um painel, um aviso ou um comando novo.
O /plugin, digitado na sessão, abre o menu dos plugins: é ali que você ativa, desativa ou desinstala. Exemplo de mods: o repositório inema-mods tem 18 mods em português, testados.
2. Hook
Hook é um comando que roda sozinho quando algo acontece no Claude Code: ao iniciar a sessão, antes de usar uma ferramenta e assim por diante.
Os mods usam hooks. Por isso um mod pode agir sem você pedir.
3. Sandbox
Sandbox é uma área isolada, onde um programa roda sem acesso ao resto do computador. Mods não têm sandbox.
Ou seja: um mod roda com o mesmo acesso que o seu Claude Code. Por isso se confere antes.
4. Conferir
Antes de instalar, rode claude plugin validate apontando para a pasta do mod. Ele lista os eventos em que o mod roda (hooks:) e o que ele pede (calls:). Se algo parecer demais, não instale. Para instalar, siga o README do mod.
Se um mod der problema, claude --safe-mode abre o Claude Code sem nenhuma customização, e você desativa o mod no /plugin com calma.
05 · Onde ficam as skills (e como mover sem terminal)
Antes de desligar, ache a pasta. Três coisas que confundem na primeira vez.
1. O ~
O sinal ~ (til) é um atalho para a sua pasta pessoal, a pasta com o seu nome de usuário no computador.
Então ~/.claude/skills quer dizer: dentro da sua pasta pessoal, a pasta .claude, e dentro dela a pasta skills.
No WindowsO mesmo caminho é C:\Users\[você]\.claude\skills, trocando [você] pelo seu nome de usuário.
2. Pasta oculta
Pasta que começa com ponto, como .claude, fica escondida por padrão. Você precisa mandar o sistema mostrar.
No Mac, no Finder, aperte Cmd+Shift+. (ponto). No Windows, no Explorador de Arquivos, vá em Exibir e marque Itens ocultos.
3. Sem terminal
Com a pasta .claude visível, abra a pasta skills. Cada skill é uma pasta com o nome dela.
Para desligar, arraste a pasta da skill para outro lugar (por exemplo, uma pasta skills-desligadas na Área de Trabalho). Para ligar de novo, arraste de volta.
Pronto quandoA pasta da skill saiu de .claude/skills e, numa sessão nova, o /skill-doctor não mostra mais essa skill.
06 · Os comandos do painel
Os que começam com / você digita dentro da sessão. Os que começam com claude você digita no terminal.
Na sessão · quanto já gastei do plano
/usage
Na sessão · o que ocupa o contexto
/context
Na sessão · montar a status line
/statusline mostre a pasta, o modelo e o uso do contexto e do limite de 5 horas em %
Na sessão · quais skills pesam e onde desligar
/skill-doctor
No terminal (Mac/Linux) · desligar uma skill pessoal movendo a pasta
No terminal · git clone baixa uma cópia do repositório; depois confira um mod antes de instalar
git clone https://github.com/inematds/inema-mods
claude plugin validate ./inema-mods/mods/<pasta-do-mod>
No terminal · abrir sem nenhuma customização
claude --safe-mode
Simulação: exemplo ilustrativo
Skills que você instalou
posts-instagram usada contexto: baixo
conversor-pdf não usada contexto: médio desligar: ~/.claude/skills/conversor-pdf/
apresentacao-slides não usada contexto: alto desligar: /plugin (plugin slides)
O formato real pode mudar com a versão. O que importa: a coluna de uso, o peso no contexto e onde desligar. Relatório vazio = você não tem skill instalada.
5h = uso da janela de 5 horas do limite de sessão; 7d = uso da semana. O que aparece depende do que você pediu no /statusline.
Diagnóstico da instalação
versão ............ ok
configuração ...... ok
skills ............ 1 aviso: skill com arquivo ausente
Nada foi alterado. Para corrigir, rode /doctor dentro da sessão.
hooks:
PreToolUse (antes de usar uma ferramenta)
calls:
ler o comando que vai rodar
Leia os eventos (hooks:) e o que o mod pede (calls:) antes de instalar. Anote em uma frase o que ele faz. Para instalar, siga o README do mod.
Manter: posts-instagram (uso toda semana nos posts da clínica).
Desligar: conversor-pdf (movi a pasta) e apresentacao-slides (desativei no /plugin).
Doctor: claude doctor sem erro depois da correção.
Advisor: opus só na sessão da planilha de preços da loja.
Retomada: /recap em cada sessão às 18h.
Painel: status line com pasta, modelo, contexto e uso de 5h e 7d.
07 · Confira a sua lista de controle
Cole a sua lista (ou carregue o .txt). A página confere os seis campos e pede no Advisor o modelo escolhido (fable, opus, sonnet) ou off. Se você não tem skill instalada, escreva isso no Desligar. O OK confere a forma; quem decide se a escolha é boa é você.
painel-controle.txt
08 · Prática: medir, enxugar e deixar à vista
Use uma sessão sua de verdade, de preferência a que você mais usa.
E1 · Medir e enxugar
10 min
No Claude Code, rode /usage e anote quanto do plano já usou. Rode /context e veja o que ocupa mais. Depois rode /skill-doctor e escolha uma skill para desligar pelo caminho indicado (pasta: mova com o gerenciador de arquivos). Relatório vazio = nenhuma skill instalada: anote isso no Desligar. Sem terminal: no app Desktop, olhe o anel de uso ao lado do seletor de modelo.
Pronto quando: você anotou o uso do plano e tem uma linha Manter e uma linha Desligar (com a skill escolhida ou "nenhuma skill instalada").
E2 · A status line
5 min
Na sessão, digite: /statusline mostre a pasta, o modelo e o uso do contexto e do limite de 5 horas em %. Confirme o que o Claude propuser.
Pronto quando: o rodapé do Claude Code mostra a pasta, o modelo e as duas porcentagens.
E3 · Diagnóstico
5 min
No terminal, rode claude doctor. Se aparecer aviso, rode /doctor dentro da sessão e só confirme a correção que você entendeu.
Pronto quando: o claude doctor termina sem erro, ou você anotou o erro e o que o /doctor propôs.
E4 · A lista no conferidor
10 min
Escreva o painel-controle.txt com os seis campos (Manter, Desligar, Doctor, Advisor, Retomada, Painel) e cole no conferidor acima.
Pronto quando: o conferidor responde "OK: lista de controle com os 6 campos preenchidos".
E5 · Conferir um mod antes de instalar (opcional)
10 min
Baixe os mods do inematds/inema-mods. Com git clone (o comando que baixa uma cópia do repositório para o seu computador, no bloco acima) ou, no GitHub, pelo botão Code → Download ZIP (descompacte). Escolha um mod da pasta mods e rode claude plugin validate apontando para a pasta dele. Leia as linhas hooks: e calls:. Não precisa instalar; se quiser, siga o README do mod.
Pronto quando: você anotou o nome do mod, os eventos de hooks:, o que ele pede em calls: e, em uma frase, o que ele faz.
09 · A aula 7 em vídeo
O mecanismo da aula explicado em cerca de dois minutos e meio.
Por que três sessões abertas ao mesmo tempo gastam mais do que uma?
Correto
Cada sessão carrega o seu histórico, arquivos e skills, e isso vira tokens a cada mensagem. O gasto soma. Não há taxa fixa por sessão.
Não é essa
Cada sessão carrega o seu histórico, arquivos e skills, e isso vira tokens a cada mensagem. O gasto soma. Não há taxa fixa por sessão.Rever: O que é custo aqui
Pergunta 2 de 5
Qual comando mostra quanto do limite do plano você já usou?
Correto
O /usage (ou /cost, /stats) mostra custo, uso do plano e estatísticas. O /context mostra o que ocupa o contexto.
Não é essa
O /usage (ou /cost, /stats) mostra custo, uso do plano e estatísticas. O /context mostra o que ocupa o contexto.Rever: Os comandos do painel
Pergunta 3 de 5
Ana tem uma sessão que só gera legendas de foto. O que fazer com o /advisor nela?
Correto
O advisor é mais um modelo, mais forte, sendo consultado: consome mais. Tarefa repetitiva não tem decisão grande. Ligar em tudo é o erro comum.
Não é essa
O advisor é mais um modelo, mais forte, sendo consultado: consome mais. Tarefa repetitiva não tem decisão grande. Ligar em tudo é o erro comum.Rever: Seis pontos do painel de controle
Pergunta 4 de 5
Antes de instalar um mod, o que fazer?
Correto
Mods não têm sandbox. O validate lista os eventos (hooks:) e o que o mod pede (calls:). Se algo der errado, claude --safe-mode abre sem customizações.
Não é essa
Mods não têm sandbox. O validate lista os eventos (hooks:) e o que o mod pede (calls:). Se algo der errado, claude --safe-mode abre sem customizações.Rever: Os comandos do painel
Pergunta 5 de 5
Você rodou /skill-doctor e o relatório veio vazio. O que isso quer dizer?
Correto
O /skill-doctor não lista as skills que já vêm com o Claude Code. Relatório vazio = nada instalado por você. Anote isso e siga.
Não é essa
O /skill-doctor não lista as skills que já vêm com o Claude Code. Relatório vazio = nada instalado por você. Anote isso e siga.Rever: Os comandos do painel
Teste concluído
Você acertou {a} de {n}. Acertando todas, a aula é marcada como concluída.
Escolha uma alternativa. A explicação aparece depois da sua tentativa.
11 · A aula em três frases
Custo é contextoTokens medem o uso; histórico, arquivos, skills, sessões paralelas e advisor somam. Meça com /usage e /context.
Enxugar com OK/skill-doctor diz o que pesa e onde desligar; claude doctor lê, /doctor propõe e espera você.
Olho fixo/statusline com o que você quer ver, /recap para retomar e mods só depois do plugin validate.
