Comandos de barra do Claude Code: o guia rápido e como criar os seus

Como os comandos de barra funcionam

Digite / no Claude Code para ver todos os comandos disponíveis para você, e continue digitando para filtrar a lista. Um comando só vale no começo de uma mensagem; o que vem depois do nome dele vira os argumentos.

• Os comandos nativos são programados na CLI, como /clear, /model e /compact.
• As skills incluídas vêm com o Claude Code e funcionam como prompts entregues ao Claude, como /simplify, /loop e /batch.
• Os comandos próprios são os que você escreve: skills em .claude/skills/ ou arquivos antigos em .claude/commands/. Plugins e servidores MCP podem adicionar outros.
• Se você enviar um comando enquanto o Claude ainda está respondendo, ele roda depois do turno atual; alguns, como /status e /usage, rodam na hora.
• Nem todo comando aparece para todo mundo: alguns dependem da sua plataforma, do seu plano ou da política da sua organização.

Guia rápido de comandos de barra do Claude Code

Os comandos mais usados, na ordem em que uma sessão costuma precisar deles.

Como criar um comando de barra próprio

Os comandos próprios foram unificados com as skills. Um arquivo em .claude/commands/fix-issue.md e uma skill em .claude/skills/fix-issue/SKILL.md criam o mesmo /fix-issue e funcionam do mesmo jeito; o formato de skill é o preferido para comandos novos porque pode guardar arquivos de apoio.

1. Crie a pasta e o SKILL.md

   Para um comando que o time inteiro recebe, crie .claude/skills/<name>/SKILL.md no repositório e faça commit. Para um que só você usa em todos os projetos, coloque em ~/.claude/skills/<name>/SKILL.md. O nome da pasta vira o comando: fix-issue gera /fix-issue.

2. Escreva o frontmatter

   Entre linhas ---, adicione uma description (o Claude a usa para decidir quando a skill se aplica), argument-hint para mostrar no menu os argumentos esperados, disable-model-invocation: true se só você deve acioná-la (para qualquer coisa com efeitos colaterais, como deploys) e allowed-tools para pré-aprovar ferramentas naquele turno.

3. Escreva o prompt, com argumentos

   Abaixo do frontmatter, escreva as instruções em Markdown. $ARGUMENTS é substituído por tudo o que foi digitado depois do comando; $0, $1 e assim por diante (ou $ARGUMENTS[0]) pegam argumentos individuais. Uma linha com ` !command ` roda antes esse comando de shell e cola a saída dele no prompt.

   ---
   description: Corrige uma issue do GitHub pelo número, com um teste
   argument-hint: [issue-number]
   disable-model-invocation: true
   allowed-tools: Bash(gh issue view *)
   ---
   
   Issue: !`gh issue view $ARGUMENTS`
   
   Corrija esta issue seguindo as nossas convenções do CLAUDE.md.
   1. Escreva um teste que falhe e a reproduza.
   2. Faça a menor mudança que faça o teste passar.
   3. Rode a suíte de testes e resuma o que mudou.

4. Rode o comando

   Digite /fix-issue 123. As skills que você adiciona ou altera durante uma sessão carregam sozinhas; se alguma não aparecer, rode /reload-skills. Sem disable-model-invocation, o Claude também pode rodar a skill por conta própria quando o seu pedido combina com a descrição dela.

5. Use argumentos posicionais em comandos com várias partes

   Rodar /migrate-component SearchBar React Vue preenche $0, $1 e $2 em ordem.

   ---
   description: Migra um componente de um framework para outro
   argument-hint: [component] [from] [to]
   ---
   
   Migre o componente $0 de $1 para $2.
   Mantenha todo o comportamento atual e todos os testes passando.

Fonte: documentação do Claude Code, Commands e Skills

Onde ficam os comandos de barra próprios

Comandos de barra vs. skills

Depois da unificação, a pergunta é menos "qual dos dois" e mais "qual formato de arquivo". Se uma skill e um arquivo de comando têm o mesmo nome, a skill vence.

Dicas e pegadinhas

• No prompt do terminal você pode empilhar skills: /write-tests /fix-issue 123 carrega as duas e passa 123 para cada uma, até seis. No claude -p e no Agent SDK só a primeira carrega.
• Comandos nativos de que você se lembra podem ter sumido: /pr-comments, /vim e /ultraplan foram removidos. Confira o /help ou a documentação.
• allowed-tools dá permissão só no turno que invoca a skill, e skills de um repositório podem conceder ferramentas a si mesmas, então leia-as antes de rodar o Claude Code em um repositório desconhecido.
• A descrição de cada skill fica no contexto; /skill-doctor mostra quanto cada uma custa e com que frequência é usada. Procedimentos longos pertencem a skills, não ao CLAUDE.md.
• /loop repete um prompt só enquanto a sua sessão está aberta. Para o trabalho começar sozinho, veja como tornar o Claude Code proativo.

Os comandos de barra deixam você mais rápido. O Crewmark faz o Claude Code começar sem você.

Todo comando de barra ainda precisa de você no teclado para digitá-lo. O Crewmark transforma uma sessão do Claude Code, Codex, DeepSeek Harness ou OpenCode em um funcionário de IA com um papel, uma meta e um horário de trabalho, e a acorda com um heartbeat para pegar a próxima issue de um quadro, usando as mesmas skills e comandos que você já configurou.

1. Mantenha as suas skills no repositório

   O seu .claude/skills/ e o seu CLAUDE.md carregam na sessão do funcionário como na sua, então o /fix-issue e as suas convenções vão junto.

2. Deixe o heartbeat iniciar o trabalho

   Durante o horário de trabalho, o funcionário acorda a cada 15, 30 ou 60 minutos na mesma conversa e pega a próxima issue. Vários podem compartilhar um repositório, cada um na própria worktree.

3. Atribua issues e responda às mensagens dele

   Coloque o trabalho no quadro; o funcionário comenta conforme avança e avisa você quando precisa de uma decisão. Leia o que é um funcionário de IA.

Perguntas frequentes sobre comandos de barra do Claude Code