Claude Code CLI: Programação com IA · Capítulo 7 de 23 · 12 min
Comandos, modelos e custo sob controle
Conheça os comandos internos do Claude Code: /help, /clear, /compact, /model e /cost.
Este capítulo faz parte do curso gratuito Claude Code CLI: Programação com IA. Para marcar como concluído e salvar o progresso, abra este capítulo na página do curso.
Conceito
Dentro de uma sessão do Claude Code, além de digitar instruções em linguagem natural, você pode usar comandos especiais que começam com barra (/). Eles controlam o comportamento da ferramenta -- do histórico ao modelo ao custo.
Comando: /help
bash
# Mostra todos os comandos disponíveis e uma breve descrição:
/help
# Use quando não lembrar de um comando ou quiser
# descobrir funcionalidades novas.Comando: /clear
bash
# Limpa todo o histórico da conversa atual:
/clear
# Use quando quiser começar uma conversa do zero,
# sem que o Claude lembre do que foi discutido antes.
# Útil quando você troca de assunto completamente.Comando: /compact
bash
# Compacta o contexto da conversa:
/compact
# Em sessões longas, o Claude acumula muito contexto (memória).
# Isso pode deixar as respostas mais lentas e consumir mais tokens.
# O /compact resume a conversa, mantendo as informações importantes
# mas liberando espaço.
# Dica: use a cada 30-40 mensagens ou quando sentir que as
# respostas estão mais lentas.Comando: /model
bash
# Mostra ou troca o modelo de IA sendo usado:
/model
# Para trocar de modelo (os aliases apontam para a geração atual):
/model fable # Claude Fable 5 -- o mais avançado (créditos de uso nos planos pagos)
/model opus # Claude Opus 5 -- raciocínio profundo
/model sonnet # Claude Sonnet 5 -- equilibrado, para o dia a dia
/model haiku # Claude Haiku 4.5 -- o mais rápido e barato
# Dica prática:
# - Use haiku para tarefas simples (listar arquivos, perguntas rápidas)
# - Use sonnet para o dia a dia (programação, análise)
# - Use opus ou fable para o que exige mais raciocínio (arquitetura, debugging difícil)Comando: /cost
bash
# Mostra o consumo de tokens da sessão atual:
/cost
# Exibe informações como:
# - Tokens de entrada (o que você enviou)
# - Tokens de saída (o que o Claude respondeu)
# - Custo estimado da sessão
# Útil para controlar gastos, especialmente se estiver
# usando a API por consumo.Comando: /usage
bash
# Mostra os limites do seu plano e quanto você já consumiu:
/usage
# Enquanto o /cost olha para a sessão atual, o /usage olha para a
# sua assinatura: quanto da cota já foi usado e quanto falta até
# renovar. Serve para não ser pego de surpresa por um limite no
# meio de uma tarefa.Comando: /rewind
bash
# Abre os pontos de restauração da sessão (ou pressione Esc duas vezes):
/rewind
# O /rewind volta o código, a conversa ou ambos a um estado anterior
# da sessão, sem depender do Git. É a rede de segurança para quando
# uma mudança não sai como esperado e você quer voltar rápido.Comando: /doctor (novo em julho de 2026)
bash
# Faz um checkup completo da instalação e do ambiente:
/doctor
# O alias é /checkup. Ele diagnostica problemas de configuração
# (PATH, versão, permissões, conectores) e, em muitos casos, já
# corrige sozinho. É o primeiro comando a rodar quando algo parece
# quebrado, antes de reinstalar no escuro.Na prática
Na Brasil GEO, usamos /model haiku para tarefas de exploração simples (buscar arquivo, verificar dados) e reservamos o Opus para o que exige raciocínio complexo (arquitetura de código, debugging avançado). Isso otimiza custos sem perder qualidade.
Outros comandos úteis
bash
# Cancelar a operação atual:
Ctrl+C
# Sair do Claude Code:
/exit # ou Ctrl+D
# Executar comando único (sem entrar na sessão):
claude -p "sua pergunta aqui"
# Continuar a última conversa:
claude -c # ou claude --continue
# Retomar uma conversa anterior pelo seletor:
claude --resumeComandos slash essenciais e quando cada um entra em jogo
| Comando | Para que serve | Quando usar |
|---|---|---|
| /help | Lista todos os comandos disponíveis | Primeira vez ou ao esquecer um comando |
| /clear | Limpa o histórico da conversa | Início de tarefa nova, contexto poluído |
| /compact | Comprime conversas longas preservando o essencial | Sessões de horas, antes de bater no limite de contexto |
| /model | Troca o modelo (Fable 5, Opus 5, Sonnet 5, Haiku 4.5) | Tarefa pesada → Opus ou Fable; rápida → Haiku |
| /usage | Mostra limites do plano e consumo acumulado | Ver quanto resta antes de bater no limite da assinatura |
| /cost | Mostra o custo em tokens da sessão | Auditoria FinOps, controle de gastos por API |
| /rewind | Volta código e/ou conversa a um ponto de restauração | Desfazer uma mudança sem mexer no Git |
| /doctor | Diagnostica e corrige a instalação (alias /checkup) | Algo parou de funcionar, antes de reinstalar |
| /permissions | Ajusta o que o Claude pode fazer (arquivos, shell, MCP) | Afrouxar ou endurecer o que é autorizado |
| /mcp | Gerencia conexões com ferramentas externas (MCP) | Conectar bancos, APIs e serviços ao Claude Code |
| /agents | Lista e gerencia sub-agentes | Projetos com agentes especializados |
| /memory | Abre e edita a memória do projeto | Salvar contexto que importa em conversas futuras |
Fechar o dia com um resumo do que andou evita a sensação de não ter feito nada. Dentro da pasta em que você trabalhou, peça ao Claude Code um relatório do que mudou hoje e do que fica para amanhã.
Checkpoint
Dentro do Claude Code, execute /help para ver a lista completa de comandos. Depois teste /model para ver qual modelo está ativo e /cost para ver o consumo da sessão.
Perguntas frequentes deste capítulo
Quando uso /clear e quando uso /compact?
Use /clear ao começar um assunto novo que nada tem a ver com o anterior, porque ele zera o histórico e impede que contexto velho contamine a nova tarefa. Use /compact quando a conversa ficou longa mas você ainda precisa do que foi combinado: ele resume e preserva o essencial, liberando espaço sem perder o fio. Regra prática: assunto novo pede /clear; a mesma tarefa que só ficou comprida pede /compact.
O /rewind substitui o Git?
Não. O /rewind restaura o código e/ou a conversa a um ponto anterior da própria sessão sem depender do Git, e você também chega nele apertando Esc duas vezes; a função dele é desfazer rápido algo que o Claude acabou de fazer. O Git continua sendo seu histórico durável, versionado e compartilhável entre máquinas e pessoas. Pense no /rewind como um 'desfazer' imediato e no Git como o registro oficial do projeto.
Como escolho o modelo certo e evito estourar o limite do meu plano no meio de uma tarefa?
Troque de modelo com /model conforme o peso da tarefa: Haiku para coisas simples, Sonnet para o dia a dia (é o padrão) e Opus ou Fable quando precisar de raciocínio pesado. Para não ter surpresa, use /cost para ver o custo da sessão atual e /usage para checar os limites do plano e o consumo acumulado. Se perceber que está perto do teto durante algo longo, desça para um modelo mais barato e rode /compact para aliviar a conversa.
O Claude começou a se comportar de forma estranha; o que faço antes de reinstalar?
Rode /doctor (o alias é /checkup), um checkup completo da instalação que diagnostica problemas e, em muitos casos, já corrige sozinho. É o primeiro passo quando algo parece quebrado, porque poupa você de reinstalar no escuro. Se ele apontar algo que não resolve automaticamente, ao menos você recebe a causa concreta para agir com segurança.