← voltar Janela de terminal com um prompt de barra e uma lista suspensa de comandos ao lado de um pequeno cartão de lista de verificação.

Comandos Slash do Claude Code: Um Guia Prático

IA e Claude Code

Digite / no Claude Code e um menu aparece; digite algumas letras e ele filtra. Esse menu é a referência real, porque reflete sua versão instalada, seus plugins e seus servidores conectados. A referência oficial de comandos é o documento em que confiar para saber o que cada comando faz. Este artigo ordena os comandos que as pessoas usam pela tarefa, mostra como inspecionar e retomar uma sessão, explica por que uma entrada pode estar faltando na sua máquina e marca onde as skills customizadas deixam de ser um problema de busca e se tornam um de autoria.

Referência rápida: escolha um comando pela tarefa

Comece pelo que você quer que aconteça, não pelo nome do comando. A tabela abaixo é compilada a partir dos documentos oficiais mais os guias de referência rápida de terceiros listados no final desta seção. Trate como ponto de partida e confirme cada linha contra /help na sua instalação, porque não a executei em nenhum build de CLI particular e as fontes não concordam em todos os detalhes.

TarefaComandoNotas
Listar o que está disponível/helpMostra comandos, incluindo os customizados e os de servidores conectados
Começar do zero/clearO Claude Help Center lista /reset e /new como aliases
Liberar contexto/compactAceita instruções de foco opcionais
Ver para onde o contexto está indo/contextDivisão visual do uso da janela
Continuar trabalho anterior/resumeSeletor, ou passar um nome
Desfazer código e/ou conversa/rewindEsc Esc abre o mesmo tipo de menu
Fazer uma pergunta lateral/btwFica fora da conversa principal
Revise o que mudou/diffVisualizador de diff interativo por cola de consulta
Trocar modelo/modelNível de esforço tem seu próprio /effort
Verificar saúde da instalação/doctorDiagnostica problemas do Claude Code
Entrar em modo de plano/planTambém acessível via Shift+Tab
Gerar um arquivo de memória inicial/initEscreve um primeiro CLAUDE.md
Gerenciar integrações/mcp , /hooks , /agents , /ideUm cada para servidores, hooks, subagentes, editores

O cheatsheet da Central de Ajuda do Claude e o devhints são as duas listas compactas que eu deixaria abertas ao lado da referência oficial. Um autor, no CC for Everyone, defende que você nunca deve decorar nada disso, e que os dez que valem ser sabidos de cabeça são aqueles que você usa no meio do raciocínio. Justo. Eu acrescentaria que a tabela serve para os outros 90%, os comandos que você usa duas vezes por mês.

Inspecione sua sessão e diagnostique um problema

Quando algo parece errado, não adivinhe. Trabalhe através de uma sequência curta, verificação mais barata primeiro.

  1. Execute /help e confirme que o comando que você espera realmente aparece.
  2. Execute /doctor para verificar a instalação.
  3. Execute /context para ver se a janela está repleta de algo que você esqueceu.
  4. Execute /usage para ver limites do plano e status do limite de taxa (e /cost se sua versão ainda tiver, mais sobre isso abaixo).
  5. Se uma ferramenta ou servidor for o suspeito, abra /mcp ou /hooks e veja o que está configurado.

Pronto. Cinco passos, e a maioria das sessões "Claude está sendo estranho" se resolvem antes do passo cinco.

Como fica o resultado

Estou descrevendo formas aqui, não colando resultados capturados, já que prefiro não passar números que parecem medidos quando não estão. /help oferece uma lista rolável de nomes de comandos com descrições de uma linha, e suas entradas personalizadas ficam na mesma lista. /context exibe uma grade ou barra mostrando quanto da janela é utilizado e por qual categoria. /doctor imprime um relatório tipo aprovado ou reprovado sobre sua configuração. Se a sua se parece diferente, sua versão é diferente. Isso é normal.

Lendo o diagnóstico

Uma grade de contexto que está principalmente cheia com resultado de ferramenta aponta para um problema de compactação ou limpeza, não um problema de modelo. Um comando faltando aponta para versão, plugin ou escopo. Um hook disparando incorretamente aponta para configuração, e o guia de hooks cobre bem esse aspecto. Separe esses três no começo. Misturá-los é como as pessoas perdem uma tarde.

Gerencie contexto e retome o trabalho

Contexto é o que você vai gerenciar mais. Três comandos fazem o trabalho pesado, e diferem em quanto descartam.

  • /compact resume a conversa até aqui. Você pode passar instruções de foco, por exemplo dizendo qual parte preservar.
  • /clear apaga a conversa e começa de novo. De acordo com o Help Center, a memória do projeto permanece.
  • /rewind volta a conversa, seu código, ou ambos para um checkpoint anterior.

Um tutorial no AI For Developers sugere conferir o /context quando você termina um bloco lógico de trabalho, rodar o /compact antes da fase seguinte e usar o /clear só quando for passar para algo sem relação. É uma rotina razoável. Mas é uma heurística, não uma regra da documentação. Não vi nenhuma evidência de um percentual de preenchimento universal a partir do qual você precise compactar, então escolha o seu próprio gatilho e observe se a qualidade das respostas muda para você.

Perguntas laterais e rewinders

/btw é subutilizado. De acordo com o Help Center, faz uma pergunta rápida lateral sem adicioná-la à conversa principal ou consumir contexto. Útil quando você quer checar um nome de flag e não quer que poluir a thread.

Rewind é melhor que argumentar. Se Claude foi pelo caminho errado, volte ao checkpoint e re-prompt com o que você sabe agora. Apertar Esc Esc abre um menu de rewind onde você escolhe apenas código, apenas conversa, ou ambos, conforme descrito em AI For Developers.

Retomando

/resume abre um seletor de sessões passadas, ou recebe um nome para pular direto para uma. Do terminal, as fontes descrevem claude --continue para a sessão mais recente e claude --resume com um ID de sessão para uma específica. O cheatsheet do Shipyard lista ambas as flags. Algumas listas de terceiros também mostram formas curtas (-c, -r), então verifique claude --help antes de contar com elas.

Como isso se encaixa em um dia completo de trabalho é uma pergunta diferente, e cobri isso no post daily founder workflow.

Comandos embutidos, habilidades agrupadas e comandos instalados

Aqui está o erro que vejo em cheat sheets: cada /algo é chamado de comando embutido. Não é. O menu com barra é uma lista mesclada de vários lugares.

Variedade de arte linear onde três tubos se unem em uma saída com um medidor
  • Comandos fixos que são parte do próprio CLI, como /clear ou /help.
  • Habilidades baseadas em prompt que vêm com Claude Code.
  • Habilidades ou comandos que você escreveu, em pastas de projeto ou usuário.
  • Entradas contribuídas por plugins e servidores MCP conectados. Shipyard observa que /help inclui comandos de servidores MCP conectados bem como suas pastas personalizadas.

A documentação oficial de skills diz que comandos personalizados foram incorporados a skills. Então um arquivo em .claude/commands/ e uma skill com SKILL.md podem aparecer como uma entrada de barra. Guias mais antigos ainda descrevem .claude/commands/ como um mecanismo separado, e é por isso que a terminologia é uma bagunça.

Como classificar uma entrada

Você tem dois testes práticos. Primeiro, leia a descrição no menu; entradas personalizadas geralmente trazem seu próprio texto. Segundo, procure pelo arquivo. Se um arquivo correspondente existir nas pastas do seu projeto ou configuração de usuário, é seu. Se não, consulte a referência de comandos, que é o lugar para confirmar como a Anthropic classifica cada entrada documentada. Não vou classificar cada comando em um compartimento aqui, porque estaria adivinhando alguns deles.

Por que se importar? Porque o comportamento difere. Um comando fixo age sobre o aplicativo. Uma skill entrega um prompt ao Claude e deixa que ele trabalhe, então o resultado pode variar entre execuções.

Por que um comando está faltando ou se comporta diferentemente

Nenhum comando na lista? Percorra essas causas em ordem.

Diferença de versão

Comandos são adicionados, renomeados e usados como alias. O exemplo mais claro na pesquisa é relatório de uso. O Help Center lista /cost para gasto da sessão e /usage para limites do plano como comandos separados. Outro guia de referência diz que /usage substitui /cost e /stats, e o DataCamp diz que /cost agora é um alias para /usage. Tudo isso pode ser verdadeiro em versões diferentes. A mesma história com /model: DataCamp observa que a partir da v2.1.153 sua seleção se torna o padrão para novas sessões, com s no seletor para aplicá-lo apenas à sessão atual. Se sua instalação é mais antiga, você veria um comportamento diferente.

Então execute claude --version, anote e compare com a documentação antes de culpar a si mesmo.

Escopo e elegibilidade

Algumas entradas dependem do seu plano, plataforma ou terminal. O guia AI For Developers diz que /cost é para usuários de API e /stats para assinantes Pro e Max. /focus é descrito por um guia de referência como apenas tela cheia. Shift+Enter precisa de /terminal-setup em alguns terminais. A ausência do seu menu pode significar inelegível, não inexistente.

Não documentado

Omiti tudo que não consegui apontar para a referência oficial. Se você vir um comando mencionado em um post de fórum ou numa thread social e não estiver na referência de comandos, não assuma que é falso e não assuma que é seu para confiar tampouco. Procure por uma nota de lançamento ou artigo de suporte, então verifique /help localmente. A ausência da referência é uma razão para verificar, não uma prova de qualquer forma.

Colisões de nomes e erros de digitação

Uma entrada personalizada pode compartilhar um nome com outra coisa, e entradas de plugin podem ser namespaced. Se um comando faz algo inesperado, verifique se você definiu um com o mesmo nome antes de suspeitar de um bug.

Onde as skills personalizadas se encaixam

Este post para na pesquisa. Se você concluiu que quer seu próprio /something, isso é um trabalho de autoria: escrever um SKILL.md, escolher onde ele fica, lidar com argumentos. Isso pertence à documentação de skills, e não vou repetir um tutorial de iniciante aqui.

O que vou dizer é como as três preocupações se separam:

  • Pesquisa de comandos: qual entrada existe e o que ela faz (este post).
  • Autoria: como construir sua própria entrada (a documentação de skills).
  • Escolha de mecanismo: se uma skill, um hook ou um subagent é adequado para um trabalho.

Esse último confunde as pessoas. Um hook é executado em eventos e não espera você digitar nada, que é um animal diferente de uma entrada de barra que você chama sob demanda. O guia de hooks vinculado anteriormente aborda essa comparação.

Se você quer que esses comandos sejam incorporados a uma rotina repetível em vez de pesquisas pontuais, a página de fluxo de trabalho Claude Code é aonde eu o enviaria.

FAQ

Preciso memorizar esses comandos?

Não. O menu / filtra conforme você digita, e /help lista tudo que sua instalação oferece. Alguns poucos valem a pena conhecer por reflexo: /clear, /compact, /resume e /rewind. Tudo mais pode ficar no menu.

Esc sempre interrompe Claude?

Deveria parar a ação atual mantendo o trabalho feito até então. CC for Everyone observa que usuários abriram issues no GitHub onde não interrompeu operações longas, e sugere Ctrl+C como fallback. Trate Esc como a primeira tentativa, não como garantia.

Qual é a diferença entre /clear e /compact?

/clear descarta a conversa e começa de novo, enquanto a memória do projeto fica. /compact mantém um resumo para você continuar usando menos contexto. Use /compact quando a tarefa continua e /clear quando não.

Por que dois cheat sheets discordam sobre /cost e /usage?

Provavelmente foram escritos contra versões diferentes, e os comandos mudaram ao longo do tempo. Verifique claude --version, depois leia a entrada atual na referência oficial em vez de pegar o primeiro blog post que encontrar.

A ressalva mais importante em tudo isso: um slash command é tão documentado quanto a versão que você está rodando, então /help e a referência oficial vencem qualquer cheat sheet, incluindo este. E uma entrada ausente geralmente significa versão, plano ou escopo, não uma instalação quebrada.

← voltar