Comandos slash

​

Comandos slash integrados

​

Comandos slash personalizados

Comandos slash personalizados permitem que você defina prompts usados frequentemente como arquivos Markdown que o Claude Code pode executar. Os comandos são organizados por escopo (específicos do projeto ou pessoais) e suportam namespacing através de estruturas de diretório.

​

Sintaxe

/<nome-do-comando> [argumentos]

​

Parâmetros

​

Tipos de comando

​

Comandos de projeto

Comandos armazenados no seu repositório e compartilhados com sua equipe. Quando listados em /help, esses comandos mostram “(project)” após sua descrição.

Localização: .claude/commands/

No exemplo a seguir, criamos o comando /optimize:

# Criar um comando de projeto
mkdir -p .claude/commands
echo "Analise este código para problemas de performance e sugira otimizações:" > .claude/commands/optimize.md

​

Comandos pessoais

Comandos disponíveis em todos os seus projetos. Quando listados em /help, esses comandos mostram “(user)” após sua descrição.

Localização: ~/.claude/commands/

No exemplo a seguir, criamos o comando /security-review:

# Criar um comando pessoal
mkdir -p ~/.claude/commands
echo "Revise este código para vulnerabilidades de segurança:" > ~/.claude/commands/security-review.md

​

Recursos

​

Namespacing

Organize comandos em subdiretórios. Os subdiretórios determinam o nome completo do comando. A descrição mostrará se o comando vem do diretório do projeto (.claude/commands) ou do diretório de nível de usuário (~/.claude/commands).

Conflitos entre comandos de nível de usuário e projeto não são suportados. Caso contrário, múltiplos comandos com o mesmo nome base de arquivo podem coexistir.

Por exemplo, um arquivo em .claude/commands/frontend/component.md cria o comando /frontend:component com descrição mostrando “(project)”. Enquanto isso, um arquivo em ~/.claude/commands/component.md cria o comando /component com descrição mostrando “(user)”.

​

Argumentos

Passe valores dinâmicos para comandos usando o placeholder $ARGUMENTS.

Por exemplo:

# Definição do comando
echo 'Corrigir issue #$ARGUMENTS seguindo nossos padrões de codificação' > .claude/commands/fix-issue.md

# Uso
> /fix-issue 123

​

Execução de comando bash

Execute comandos bash antes do comando slash ser executado usando o prefixo !. A saída é incluída no contexto do comando. Você deve incluir allowed-tools com a ferramenta Bash, mas pode escolher os comandos bash específicos a permitir.

Por exemplo:

---
allowed-tools: Bash(git add:*), Bash(git status:*), Bash(git commit:*)
description: Criar um commit git
---

## Contexto

- Status git atual: !`git status`
- Diff git atual (mudanças staged e unstaged): !`git diff HEAD`
- Branch atual: !`git branch --show-current`
- Commits recentes: !`git log --oneline -10`

## Sua tarefa

Com base nas mudanças acima, crie um único commit git.

​

Referências de arquivo

Inclua conteúdo de arquivos em comandos usando o prefixo @ para referenciar arquivos.

Por exemplo:

# Referenciar um arquivo específico

Revise a implementação em @src/utils/helpers.js

# Referenciar múltiplos arquivos

Compare @src/old-version.js com @src/new-version.js

​

Modo de pensamento

Comandos slash podem acionar pensamento estendido incluindo palavras-chave de pensamento estendido.

​

Frontmatter

Arquivos de comando suportam frontmatter, útil para especificar metadados sobre o comando:

| Frontmatter | Propósito | Padrão | | :--- | :--- | :--- | --- | ---- | | allowed-tools | Lista de ferramentas que o comando pode usar | Herda da conversa | | argument-hint | Os argumentos esperados para o comando slash. Exemplo: argument-hint: add [tagId] | remove [tagId] | list. Esta dica é mostrada ao usuário ao auto-completar o comando slash. | Nenhum | | description | Breve descrição do comando | Usa a primeira linha do prompt | | model | opus, sonnet, haiku, ou uma string de modelo específica | Herda da conversa |

Por exemplo:

---
allowed-tools: Bash(git add:*), Bash(git status:*), Bash(git commit:*)
argument-hint: [message]
description: Criar um commit git
model: haiku
---

Um comando de exemplo

​

Comandos slash MCP

Servidores MCP podem expor prompts como comandos slash que ficam disponíveis no Claude Code. Esses comandos são descobertos dinamicamente de servidores MCP conectados.

​

Formato do comando

Comandos MCP seguem o padrão:

/mcp__<nome-do-servidor>__<nome-do-prompt> [argumentos]

​

Recursos

​

Descoberta dinâmica

Comandos MCP ficam automaticamente disponíveis quando:

• Um servidor MCP está conectado e ativo
• O servidor expõe prompts através do protocolo MCP
• Os prompts são recuperados com sucesso durante a conexão

​

Argumentos

Prompts MCP podem aceitar argumentos definidos pelo servidor:

# Sem argumentos
> /mcp__github__list_prs

# Com argumentos
> /mcp__github__pr_review 456
> /mcp__jira__create_issue "Título do bug" high

​

Convenções de nomenclatura

• Nomes de servidor e prompt são normalizados
• Espaços e caracteres especiais se tornam underscores
• Nomes são convertidos para minúsculas para consistência

​

Gerenciando conexões MCP

Use o comando /mcp para:

• Visualizar todos os servidores MCP configurados
• Verificar status de conexão
• Autenticar com servidores habilitados para OAuth
• Limpar tokens de autenticação
• Visualizar ferramentas e prompts disponíveis de cada servidor

​

Veja também

• Modo interativo - Atalhos, modos de entrada e recursos interativos
• Referência CLI - Flags e opções de linha de comando
• Configurações - Opções de configuração
• Gerenciamento de memória - Gerenciando a memória do Claude entre sessões