MODULO 1.2

⌨️ Comandos Essenciais do Terminal

Domine os comandos internos do Claude Code que todo usuario precisa conhecer: /help, /clear, /compact, /cost e /status. Aprenda quando e como usar cada um para manter suas sessoes organizadas e eficientes.

6
Topicos
20
Minutos
Basico
Nivel
Teoria + Pratica
Tipo
1

πŸ“– /help - Seu guia de referencia rapida

O comando /help e o ponto de partida para qualquer duvida sobre o que o Claude Code pode fazer. Em vez de sair da sessao para buscar documentacao, voce acessa tudo diretamente no terminal, sem perder o contexto da conversa atual.

🎯 Conceito Principal

O /help exibe uma lista completa de todos os slash commands disponiveis, flags de configuracao e atalhos de teclado. E a sua documentacao inline - sempre atualizada com a versao que voce esta rodando.

  • β€’ Lista de comandos: Mostra todos os slash commands nativos (/help, /clear, /compact, /cost, /status, /commit, /review, /pr, /init, /doctor) com uma breve descricao de cada um
  • β€’ Atalhos de teclado: Exibe os keybindings essenciais como Escape para cancelar uma operacao, Ctrl+C para sair, e Tab para autocompletar caminhos de arquivo
  • β€’ Informacoes de sessao: Indica o modelo atual em uso, o plano da conta e configuracoes ativas de permissao
  • β€’ Versao sempre atualizada: Como o /help le da propria instalacao, ele reflete exatamente o que sua versao suporta - sem risco de documentacao desatualizada

πŸ’» Exemplo no Terminal

> /help
# Saida tipica:
Available slash commands:
/help - Show this help message
/clear - Clear conversation history
/compact - Compact conversation to save context
/cost - Show token usage and costs
/status - Show session status
/commit - Create a git commit
/review - Review code changes
/pr - Create a pull request
/init - Initialize CLAUDE.md
/doctor - Check for issues

πŸ’‘ Dica Pratica

Crie o habito de rodar /help sempre que atualizar o Claude Code. Novas versoes frequentemente adicionam comandos e funcionalidades que nao existiam antes. E a forma mais rapida de descobrir o que ha de novo.

Alem disso, o /help nao consome tokens significativos - e uma operacao local que nao envia nada para o modelo. Pode usar sem medo de impactar seu custo.

2

🧹 /clear - Limpando contexto estrategicamente

O comando /clear limpa todo o historico da conversa atual, resetando o contexto do Claude Code. Parece simples, mas saber quando e por que usar faz uma diferenca enorme na qualidade das respostas e no custo da sessao.

🎯 Conceito Principal

Cada mensagem que voce troca com o Claude Code fica armazenada no contexto da sessao. Quanto mais longo o contexto, mais tokens sao consumidos por mensagem e maior a chance do modelo "se perder" em informacoes antigas. O /clear zera esse contador.

  • β€’ Reset completo: Remove todas as mensagens anteriores da memoria ativa. O Claude nao lembra mais do que foi discutido antes do /clear
  • β€’ Contexto poluido: Se voce explorou 5 arquivos diferentes, pediu refatoracoes, voltou atras e mudou de ideia, o contexto esta poluido. Um /clear permite recomecar com foco
  • β€’ Economia de tokens: Contexto longo = mais tokens por request. Limpar regularmente quando muda de tarefa reduz custo significativamente
  • β€’ Nao afeta arquivos: O /clear so limpa a conversa. Todos os arquivos editados, commits feitos e mudancas no projeto permanecem intactos

βœ“ Quando USAR /clear

  • βœ“ Ao mudar completamente de tarefa (ex: de frontend para backend)
  • βœ“ Quando o Claude comeca a dar respostas confusas ou repetitivas
  • βœ“ Apos completar uma tarefa e antes de iniciar outra na mesma sessao

βœ— Quando NAO usar /clear

  • βœ— No meio de uma tarefa complexa que depende do contexto anterior
  • βœ— Quando voce quer que o Claude lembre de decisoes ja tomadas
  • βœ— Se o problema e excesso de contexto, prefira /compact em vez de /clear

πŸ’‘ Dica Pratica

Pense no /clear como fechar e abrir uma nova aba no navegador. Voce nao perde o trabalho feito, mas comeca a navegacao do zero. Use-o como separador entre tarefas distintas.

Uma regra pratica: se voce precisa explicar ao Claude "esquece o que eu disse antes", e hora de dar um /clear. E mais eficiente do que tentar corrigir o contexto com palavras.

3

πŸ“¦ /compact - Compactando conversas longas

O /compact e o meio-termo inteligente entre continuar com contexto poluido e perder tudo com /clear. Ele resume a conversa, mantendo os pontos essenciais e descartando o ruido, permitindo que voce continue a tarefa com menos tokens.

🎯 Conceito Principal

Quando voce roda /compact, o Claude Code pega toda a conversa atual e gera um resumo condensado que substitui o historico completo. O resultado e uma sessao mais leve, mais barata e muitas vezes mais focada do que a original.

  • β€’ Como funciona: O Claude le toda a conversa, identifica as decisoes-chave, o estado atual do trabalho e os proximos passos, e gera um resumo estruturado que se torna o novo contexto
  • β€’ Preservacao inteligente: Arquivos editados, decisoes de design, bugs encontrados e resolucoes ficam preservados no resumo. Detalhes como tentativas falhas e exploracoes laterais sao descartados
  • β€’ Reducao dramatica: Uma conversa de 50k tokens pode ser compactada para 5-8k tokens, reduzindo em ate 85% o custo das proximas mensagens
  • β€’ Compact com instrucao: Voce pode passar uma instrucao adicional como /compact foque nas decisoes de arquitetura para guiar o que deve ser priorizado no resumo

πŸ’» Exemplo no Terminal

# Compact simples - resume tudo automaticamente
> /compact
# Compact direcionado - foca no que importa
> /compact mantenha o foco nas mudancas no schema do banco de dados
# Resultado tipico:
Conversation compacted. Context reduced from 47,231 to 6,892 tokens.

πŸ’‘ Dica Pratica

Use /compact sempre que sentir que a conversa esta ficando longa mas voce ainda precisa do contexto. A regra de ouro: se voce ja trocou mais de 15-20 mensagens na mesma tarefa, e hora de compactar.

O Claude Code tambem faz auto-compact quando o contexto se aproxima do limite da janela. Mas nao espere isso acontecer - compactar proativamente da resultados melhores porque voce controla o que e preservado.

4

πŸ’° /cost - Monitorando gastos de tokens

O comando /cost mostra exatamente quanto voce gastou na sessao atual em termos de tokens consumidos e custo estimado. E essencial para manter o controle dos seus gastos e otimizar o uso do Claude Code no dia a dia.

🎯 Conceito Principal

O /cost exibe um relatorio detalhado de consumo: tokens de entrada, tokens de saida, tokens de cache e o custo total estimado em dolares. Esses dados permitem que voce entenda quais acoes sao caras e quais sao baratas.

  • β€’ Tokens de entrada: Tudo que o Claude recebe - seu prompt, o contexto da conversa, conteudo de arquivos lidos. Quanto maior o contexto, mais tokens de entrada por mensagem
  • β€’ Tokens de saida: Tudo que o Claude gera - respostas, codigo, explicacoes. Respostas longas custam mais, mas geralmente sao necessarias
  • β€’ Cache hits: Tokens que foram reutilizados do cache, custando significativamente menos (ate 90% mais barato). O cache e automatico e otimizado pelo Claude Code
  • β€’ Custo acumulado: O total da sessao em USD. No plano Pro, esse custo e absorvido pela assinatura ate o limite mensal. Em API direta, e cobrado sob demanda

πŸ’» Exemplo no Terminal

> /cost
# Saida tipica apos ~10 minutos de uso:
Session Cost Summary:
Input tokens: 34,521 ($0.1036)
Output tokens: 8,743 ($0.0437)
Cache read: 21,200 ($0.0064)
Cache write: 13,321 ($0.0400)
Total: $0.1937

πŸ“Š Custos de Referencia (2026)

  • Sessao curta (5 min): ~$0.05 a $0.15 dependendo dos arquivos lidos
  • Sessao media (30 min): ~$0.50 a $2.00 com multiplas edicoes e leituras
  • Sessao longa (1h+): ~$2.00 a $8.00, especialmente com modelos Opus
  • Plano Pro mensal: Cobre a grande maioria dos usos individuais sem cobranca extra

πŸ’‘ Dica Pratica

Rode /cost antes e depois de operacoes grandes para entender o impacto. Ler um arquivo grande de 2000 linhas pode custar mais do que 10 mensagens de texto simples. Saber isso muda como voce estrutura seus pedidos.

Se o custo esta subindo rapido, combine com /compact para reduzir o contexto, ou use /clear se estiver mudando de tarefa. O maior vilao de custo e contexto acumulado desnecessario.

5

πŸ“Š /status - Estado atual da sessao

O comando /status e o seu painel de controle dentro do Claude Code. Ele mostra tudo sobre a sessao atual: modelo em uso, ferramentas disponiveis, MCPs conectados, permissoes configuradas e estado geral do ambiente.

🎯 Conceito Principal

O /status revela o estado completo da sua sessao. E especialmente util para diagnosticar problemas, verificar se MCPs estao conectados corretamente e confirmar qual modelo esta sendo usado antes de uma tarefa critica.

  • β€’ Modelo ativo: Mostra qual modelo esta em uso (Opus, Sonnet, Haiku). Importante porque cada modelo tem capacidades e custos diferentes
  • β€’ MCPs conectados: Lista todos os servidores MCP ativos, suas ferramentas disponiveis e status de conexao. Se um MCP esta com problema, aparece aqui
  • β€’ Permissoes: Mostra quais ferramentas estao permitidas, bloqueadas ou requerem aprovacao. Reflete as configuracoes do --allowedTools e do settings.json
  • β€’ Diretorio de trabalho: Confirma em qual pasta o Claude Code esta operando. Util quando voce nao lembra se fez cd para o diretorio correto

πŸ’» Exemplo no Terminal

> /status
# Saida tipica:
Session Status:
Model: claude-opus-4-6
Working directory: /home/user/projects/meu-app
Account: Pro Plan
MCP Servers: 3 connected
- filesystem (4 tools)
- github (12 tools)
- postgres (6 tools)
Tools: 28 available, 2 blocked

πŸ’‘ Dica Pratica

Rode /status sempre que algo nao funcionar como esperado. Se o Claude nao consegue acessar o banco de dados, o /status vai mostrar se o MCP do Postgres esta conectado. Se as respostas estao ruins, pode ser que voce esteja rodando Haiku em vez de Opus.

Combine com /doctor (que voce vai aprender no modulo 1.3) para ter um diagnostico completo quando algo nao funciona.

6

πŸ”— Combinando comandos na pratica

Cada comando que vimos ate aqui e poderoso isoladamente, mas o verdadeiro ganho vem quando voce os combina em workflows fluidos. Nesta secao, vamos montar sequencias praticas que profissionais usam no dia a dia para manter sessoes organizadas, baratas e produtivas.

🎯 Conceito Principal

Os comandos de sessao formam um ciclo de gerenciamento: voce monitora com /status e /cost, otimiza com /compact, reseta com /clear e consulta com /help. Dominar esse ciclo e o que separa usuarios casuais de power users.

  • β€’ Workflow de tarefa longa: Comece a tarefa β†’ a cada 15-20 mensagens, rode /cost para checar β†’ se caro, rode /compact β†’ continue β†’ ao terminar, /clear antes da proxima tarefa
  • β€’ Workflow de debug: Rode /status para verificar ambiente β†’ identifique o bug β†’ /cost para ver impacto β†’ resolva β†’ /compact se quiser continuar, /clear se terminou
  • β€’ Workflow de exploracao: /help para ver comandos disponiveis β†’ explore o projeto β†’ /cost para monitorar β†’ /clear quando satisfeito e pronto para codar

Referencia Rapida dos Comandos

Comando Funcao Quando usar Custo
/help Lista comandos e atalhos Quando esqueceu um comando Zero
/clear Reseta todo o contexto Mudou de tarefa Zero
/compact Resume a conversa Contexto ficou grande Baixo
/cost Mostra gastos da sessao Monitorar consumo Zero
/status Informacoes da sessao Diagnosticar problemas Zero

πŸ’‘ Dica Pratica

Memorize esta sequencia para sessoes longas: /cost β†’ avalie β†’ /compact β†’ continue β†’ /cost β†’ compare. Essa rotina de "checkpoint" mantΓ©m seus gastos sob controle e a qualidade das respostas alta.

Desenvolvedores experientes rodam /cost a cada 10 minutos como habito. E como olhar o velocimetro enquanto dirige - nao muda a direcao, mas evita surpresas.

πŸ‹οΈ

πŸ‹οΈ Exercicio Pratico

Hora de praticar todos os comandos aprendidos neste modulo. Voce vai usar /help, /clear, /compact, /cost e /status numa sessao real do Claude Code, observando o impacto de cada um no fluxo de trabalho.

πŸ‹οΈ

Exercicio: Dominando os Comandos de Sessao

Tempo estimado: 10-15 minutos

1

Abrir uma sessao e consultar ajuda

Navegue ate um projeto e abra o Claude Code. Depois, rode /help:

$ cd ~/projects/qualquer-projeto && claude
> /help

Observe a lista de comandos disponiveis. Conte quantos voce ja conhece.

2

Verificar o estado da sessao

Rode /status para ver o ambiente completo:

> /status

Anote qual modelo esta ativo e quantos MCPs estao conectados.

3

Gerar contexto e medir custo

Faca 3-4 perguntas sobre o projeto e depois cheque o custo:

> Quais sao os principais arquivos deste projeto?
> Explique a arquitetura geral
> Liste as dependencias principais
> /cost

Anote o custo total ate aqui.

4

Compactar a conversa

Use /compact para resumir e depois cheque o custo novamente:

> /compact
> /cost

Compare o custo por mensagem antes e depois do compact.

5

Limpar e recomecar

Limpe o contexto e confirme que o Claude nao lembra da conversa anterior:

> /clear
> O que estΓ‘vamos fazendo antes?

O Claude nao deve saber responder - confirmando que o /clear funcionou.

6

Checar custo final

Verifique o custo total do exercicio inteiro:

> /cost

O exercicio completo deve ter custado menos de $0.30. Se custou mais, reveja onde o contexto cresceu demais.

βœ… Criterios de Sucesso

☐ Rodou /help e identificou comandos
☐ Verificou modelo ativo com /status
☐ Monitorou custo com /cost
☐ Compactou com /compact e viu reducao
☐ Limpou contexto com /clear
☐ Confirmou que /clear apagou o historico

πŸ“‹ Resumo do Modulo

βœ“
/help e sua referencia inline - Lista todos os comandos, atalhos e informacoes da versao sem custo de tokens.
βœ“
/clear reseta o contexto completamente - Use ao mudar de tarefa. Nao afeta arquivos, so a memoria da conversa.
βœ“
/compact resume sem perder o essencial - Reduz contexto em ate 85%, mantendo decisoes-chave e estado atual.
βœ“
/cost monitora gastos em tempo real - Tokens de entrada, saida, cache e custo total. Essencial para controle financeiro.
βœ“
/status mostra o painel completo da sessao - Modelo, MCPs, permissoes e diretorio. Primeiro comando a rodar quando algo nao funciona.
βœ“
Combine comandos em workflows - /cost β†’ /compact β†’ /cost e o ciclo de otimizacao. /clear para separar tarefas.

Proximo Modulo:

1.3 - Slash Commands Nativos (/commit, /review, /pr, /init, /doctor)