Comandos slash
Controle o comportamento do Claude durante uma sessão interativa com comandos slash.
Comandos slash integrados
Comando | Propósito |
---|---|
/add-dir | Adicionar diretórios de trabalho adicionais |
/agents | Gerenciar subagentes de IA personalizados para tarefas especializadas |
/bug | Relatar bugs (envia conversa para a Anthropic) |
/clear | Limpar histórico de conversa |
/compact [instructions] | Compactar conversa com instruções de foco opcionais |
/config | Visualizar/modificar configuração |
/cost | Mostrar estatísticas de uso de tokens (veja guia de rastreamento de custos para detalhes específicos da assinatura) |
/doctor | Verifica a saúde da sua instalação do Claude Code |
/help | Obter ajuda de uso |
/init | Inicializar projeto com guia CLAUDE.md |
/login | Alternar contas da Anthropic |
/logout | Sair da sua conta da Anthropic |
/mcp | Gerenciar conexões de servidor MCP e autenticação OAuth |
/memory | Editar arquivos de memória CLAUDE.md |
/model | Selecionar ou alterar o modelo de IA |
/permissions | Visualizar ou atualizar permissões |
/pr_comments | Visualizar comentários de pull request |
/review | Solicitar revisão de código |
/status | Visualizar status da conta e do sistema |
/terminal-setup | Instalar vinculação de tecla Shift+Enter para novas linhas (apenas iTerm2 e VSCode) |
/vim | Entrar no modo vim para alternar entre modos de inserção e comando |
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
Parâmetros
Parâmetro | Descrição |
---|---|
<command-name> | Nome derivado do nome do arquivo Markdown (sem extensão .md ) |
[arguments] | Argumentos opcionais passados para o comando |
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
:
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
:
Recursos
Namespacing
Organize comandos em subdiretórios. Os subdiretórios são usados para organização e aparecem na descrição do comando, mas não afetam o nome do comando em si. A descrição mostrará se o comando vem do diretório do projeto (.claude/commands
) ou do diretório de nível do usuário (~/.claude/commands
), junto com o nome do subdiretório.
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 de arquivo base podem coexistir.
Por exemplo, um arquivo em .claude/commands/frontend/component.md
cria o comando /component
com descrição mostrando “(project:frontend)”.
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 placeholders de argumento:
Todos os argumentos com $ARGUMENTS
O placeholder $ARGUMENTS
captura todos os argumentos passados para o comando:
Argumentos individuais com $1
, $2
, etc.
Acesse argumentos específicos individualmente usando parâmetros posicionais (similar a scripts shell):
Use argumentos posicionais quando você precisar:
- Acessar argumentos individualmente em diferentes partes do seu comando
- Fornecer padrões para argumentos ausentes
- Construir comandos mais estruturados com funções específicas de parâmetros
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 para permitir.
Por exemplo:
Referências de arquivo
Inclua conteúdos de arquivo em comandos usando o prefixo @
para referenciar arquivos.
Por exemplo:
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 autocompletar o comando slash. | Nenhum |
description | Breve descrição do comando | Usa a primeira linha do prompt |
model | String de modelo específica (veja Visão geral dos modelos) | Herda da conversa |
Por exemplo:
Exemplo usando argumentos posicionais:
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:
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:
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
Permissões MCP e wildcards
Ao configurar permissões para ferramentas MCP, note que wildcards não são suportados:
- ✅ Correto:
mcp__github
(aprova TODAS as ferramentas do servidor github) - ✅ Correto:
mcp__github__get_issue
(aprova ferramenta específica) - ❌ Incorreto:
mcp__github__*
(wildcards não suportados)
Para aprovar todas as ferramentas de um servidor MCP, use apenas o nome do servidor: mcp__servername
. Para aprovar apenas ferramentas específicas, liste cada ferramenta individualmente.
Veja também
- Gerenciamento de Identidade e Acesso - Guia completo para permissões, incluindo permissões de ferramentas MCP
- 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