Workbranch › Guias

Como criar comandos de barra personalizados no Claude Code

Se você digita o mesmo prompt longo no Claude Code toda semana, como um checklist de revisão ou os passos de um release, pode transformá-lo em um comando de barra seu. Este guia mostra os comandos embutidos que vale conhecer, como escrever um comando personalizado e como compartilhá-lo em um projeto.

Atualizado em 30 de outubro de 2026

Os caminhos e campos abaixo foram conferidos na documentação do Claude Code da Anthropic em outubro de 2026.

Comandos embutidos que vale conhecer

Digite / em uma sessão para ver todos os comandos disponíveis para você, ou / mais algumas letras para filtrar. Um comando só vale no comecinho de uma mensagem; o que você digitar depois dele vira argumento. Alguns comandos dependem da sua plataforma e do seu plano.

A lista completa está na página Commands da Anthropic.

Crie seu próprio comando

Comandos personalizados e skills agora funcionam do mesmo jeito: .claude/commands/review.md e .claude/skills/review/SKILL.md criam, os dois, o comando /review. A pasta de skill é o formato recomendado porque pode guardar arquivos extras.

1. No seu projeto, crie a pasta .claude/skills/review/. O nome da pasta vira o nome do comando, a menos que você defina outro com um campo name:.
2. Dentro dela, crie o SKILL.md.
3. Comece o arquivo com o frontmatter. A linha --- precisa ser a primeiríssima linha:
   • description: o que o comando faz e quando usá-lo. Coloque o uso principal primeiro.
   • argument-hint: opcional, uma dica mostrada no preenchimento automático, como [file].
4. Feche o frontmatter com outro --- e escreva o prompt abaixo dele, do mesmo jeito que você o digitaria para o Claude: o que conferir, em que ordem e como relatar.
5. Digite /review em uma sessão. As edições no arquivo são reconhecidas na hora; se você criou uma pasta .claude/skills/ nova de nível superior no meio da sessão, rode /reload-skills.

Passe argumentos

• $ARGUMENTS é substituído por tudo o que for digitado depois do comando.
• $0, $1, $2 (contando a partir do 0) recebem palavras isoladas, então /migrate SearchBar JavaScript TypeScript preenche três marcadores. Coloque entre aspas os valores com espaços.
• Se o arquivo não tiver nenhum marcador, o Claude Code acrescenta os argumentos no final como ARGUMENTS: ….
• Para escrever um cifrão literal antes de um dígito, use escape, como em \$1.00.

Opções úteis do frontmatter

• disable-model-invocation: true: só você pode iniciar o comando com a barra. Use para qualquer coisa com efeitos colaterais, como um deploy.
• user-invocable: false: esconde o comando do menu /, para que só o Claude o carregue como conhecimento de fundo.
• allowed-tools: ferramentas que o Claude pode usar sem perguntar durante o turno em que você roda o comando, por exemplo Bash(npm run build *). Isso concede acesso; não restringe outras ferramentas.

Os nomes dos campos precisam ser exatos; campos desconhecidos são ignorados sem aviso.

Compartilhe comandos em um projeto

Subpastas em .claude/commands/ acrescentam um namespace: .claude/commands/frontend/component.md vira /frontend:component. Sessões na nuvem e no Cowork não leem ~/.claude/skills/, então faça commit do comando no repositório ou ative a skill na sua conta do claude.ai se precisar dele lá. Para skills nos apps do Claude, veja como usar as Claude Skills.

Se não funcionar

• O comando não aparece no menu /. Confira se o nome da pasta ou do arquivo não tem <, >, espaços duplos ou caracteres invisíveis; um nome assim é recusado. Inicie claude --debug e procure [names] no log de depuração para ver quais nomes foram recusados. Rode /reload-skills depois de adicionar uma pasta de skills nova.
• As configurações do frontmatter são ignoradas. O YAML precisa ser válido e começar na linha um; um erro de leitura carrega o comando sem nenhum campo definido.
• O Claude nunca usa o comando sozinho. Faça a descrição dizer quando usá-lo e confira se disable-model-invocation não está definido.
• O comando do projeto roda a sua versão pessoal. Quando o mesmo nome existe em ~/.claude/ e no projeto, o pessoal vence; renomeie um deles.

Um comando pronto para salvar sessões

O plugin do Workbranch para o Claude Code adiciona o /workbranch:save, que organiza por tema as tarefas, decisões, dúvidas em aberto e ideias da sessão em um projeto do Workbranch, para você não precisar escrever esse comando. O Workbranch tem um teste grátis de 3 dias em app.workbranch.ai.

Fontes

• Extend Claude with skills (Claude Code Docs, conferido em 2026-10-30)
• Commands (Claude Code Docs, conferido em 2026-10-30)
• Use Claude Code with your Pro or Max plan (Central de Ajuda do Claude, conferido em 2026-10-30)

Perguntas frequentes