Cookies

Com a sua autorização, usamos cookies do Google Analytics para medir as visitas e melhorar o site. Os cookies necessários ficam sempre ativos. Pode mudar a escolha ou retirar o consentimento quando quiser, no rodapé, em Definições de cookies. Política de Cookies

Saltar para o conteúdo
PTEN
Começar

Comandos slash

InicianteGrátis25 minatualizado 2026-10-21

Barra de vidro inclinada, como uma barra de comando, sobre uma base de metal com pequenas teclas de vidro.

Visão geral

Os comandos slash são atalhos que controlam o comportamento do Claude durante uma sessão interativa. Existem vários tipos:

  • Comandos incorporados: fornecidos pelo Claude Code (/help, /clear, /model)
  • Skills: comandos definidos pelo utilizador, criados como ficheiros SKILL.md (/optimize, /pr)
  • Comandos de plugins: comandos de plugins instalados (/frontend-design:frontend-design)
  • Prompts MCP: comandos de servidores MCP (/mcp__github__list_prs)
Nota: Os comandos slash personalizados foram integrados nas skills. Os ficheiros em .claude/commands/ continuam a funcionar, mas as skills (.claude/skills/) são agora a abordagem recomendada. Ambos criam atalhos /command-name. Consulte o Guia de Skills para a referência completa.

Referência de comandos incorporados

Os comandos incorporados são atalhos para ações comuns. Estão disponíveis 60+ comandos incorporados e 10 skills incluídas. Escreva / no Claude Code para ver a lista completa, ou escreva / seguido de quaisquer letras para filtrar.

Nota: Desde a v2.1.236, premir Enter num comando slash mal escrito (ou num comando que não está disponível na sessão atual) reporta um erro em vez de executar silenciosamente a correspondência difusa mais próxima. Os prefixos não ambíguos e os aliases definidos continuam a ser executados como antes.
ComandoFinalidade
/add-dir <path>Adiciona o diretório de trabalho
/advisor [model|off]Configura o advisor. Abre como um diálogo interativo; na aplicação de ambiente de trabalho, no Remote Control e em sessões headless (-p / Agent SDK), assume em vez disso uma forma de texto: /advisor simples, /advisor <model> ou /advisor off (v2.1.260+)
/agentsJá não é um comando funcional: o assistente interativo foi removido na v2.1.198 e, desde a v2.1.281, /agents já não aparece no menu / nem no /help (escrevê-lo apenas explica para onde foi o assistente). Peça ao Claude para criar ou gerir subagentes, ou edite diretamente os ficheiros em .claude/agents/
/branch [name]Muda para uma cópia da conversa neste ponto, mantendo a original (regresse a ela com /resume)
/fork [prompt]Copia a conversa atual para uma nova sessão em segundo plano e continua a trabalhar aqui; a partir desse momento, as duas são independentes e a cópia passa a ter a sua própria linha em claude agents (v2.1.212+). Exceto quando a cópia edita no local, o Claude Code instrui-a a criar um worktree próprio antes de fazer alterações ao código (a instrução de isolamento requer a v2.1.221+)
/subtask <task>Cria um subagente bifurcado que herda a conversa completa e trabalha na tarefa enquanto você continua; o resultado regressa a esta conversa quando ele termina (v2.1.212+)
/btw <question>Faz uma pergunta lateral efémera enquanto o Claude trabalha na tarefa principal; não polui o contexto da conversa principal
/cd <path>Move a sessão para um novo diretório de trabalho sem invalidar a cache de prompts (adicionado na v2.1.169)
/chromeConfigura a integração com o navegador Chrome
/clearLimpa a conversa (aliases: /reset, /new)
/color [color|default]Define a cor da barra de prompt. /color simples (sem argumentos) escolhe uma cor de sessão aleatória (v2.1.128+); indique um nome de cor ou um valor hexadecimal para a definir explicitamente.
/compact [instructions]Compacta a conversa com instruções de foco opcionais. Um compact falhado é agora apresentado como um erro na interface em vez de não fazer nada em silêncio (v2.1.216)
/configAbre as Definições (alias: /settings)
/contextVisualiza a utilização do contexto como uma grelha colorida. Mostra um aviso explícito quando a utilização excede o limite da janela de contexto (v2.1.216)
/copy [N]Copia a resposta do assistente para a área de transferência; w escreve para um ficheiro
/costAlias de atalho de escrita para /usage: abre o separador de custos (v2.1.118+)
/desktopContinua na aplicação Desktop (alias: /app)
/diffVisualizador de diff interativo para alterações não confirmadas. Na renderização em ecrã inteiro, abre em vez disso um painel de diff ao lado da conversa, que permanece aberto enquanto você continua a trabalhar: lista os ficheiros alterados com o número de linhas adicionadas/removidas e é atualizado sempre que o Claude edita um ficheiro ou executa um comando shell; execute /diff novamente ou clique em ✕ para o fechar (v2.1.260+). O renderizador clássico abre o visualizador no lugar do prompt
/doctorDiagnostica a saúde da instalação (pode ser aberto enquanto o Claude está a responder); mostra ícones de estado; prima f para corrigir problemas automaticamente (melhorado na v2.1.116; disposição renovada para uma árvore plana com ícones mais claros na v2.1.178); /doctor prompt-audit (também /checkup prompt-audit) audita os ficheiros CLAUDE.md, as skills, os agentes e os comandos à procura de padrões de prompting escritos para modelos mais antigos (v2.1.283)
/effort [low|medium|high|xhigh|max|auto|ultracode [on|off]]Define o nível de esforço através de um cursor interativo controlado pelas teclas de seta. Níveis: low → medium → high → xhigh (novo na v2.1.111) → max. A predefinição é medium no Opus 5.5 (o modelo predefinido desde a v2.1.280) e no Sonnet 5.5, high no Opus 5, Sonnet 5 e Opus 4.8, e xhigh no Opus 4.7; xhigh requer Opus 5.5, Sonnet 5.5, Opus 5, Sonnet 5, Opus 4.8 ou Opus 4.7; max funciona no Opus 5.5, Sonnet 5.5, Opus 5, Sonnet 5, Opus 4.8/4.7/4.6 e Sonnet 4.6. Um nível guardado antes de /effort passar a ser por modelo não se aplica a modelos lançados recentemente, como o Opus 5.5 (v2.1.280). O cursor também tem um interruptor Ultracode (Tab, ou /effort ultracode [on|off]) - não é um nível de esforço de modelo: faz com que o Claude orquestre fluxos de trabalho dinâmicos ao nível de esforço a que a sessão está a correr. Desde a v2.1.284, já não força xhigh e mantém-se ativo quando muda o nível; /effort ultracode dura durante a sessão, e a definição ultracode torna-o persistente
/exitSai do REPL (alias: /quit)
/export [filename]Exporta a conversa atual para um ficheiro ou para a área de transferência
/usage-creditsConfigura utilização extra para limites de taxa (renomeado de /extra-usage na v2.1.144; /extra-usage ainda funciona como alias)
/fast [on|off]Ativa/desativa o modo rápido. Aplica-se ao Opus 5.5 (a predefinição do modo rápido desde a v2.1.280), ao Opus 5 e ao Opus 4.8
/feedbackSubmete feedback (alias: /bug). Desde a v2.1.141, pode anexar sessões recentes (últimas 24h ou 7d) para que os relatórios que abrangem mais do que uma sessão incluam contexto. A partir da v2.1.178, /bug requer uma descrição antes de poder ser submetido.
/focusAtiva/desativa a vista de foco (adicionado na v2.1.110; substitui Ctrl+O para alternar o foco)
/goal <statement>Regista uma condição de conclusão ao nível da sessão; o Claude continua a trabalhar até que o objetivo seja cumprido. /goal clear remove-o. O objetivo ativo aparece na linha de estado, com um painel de sobreposição em tempo real que mostra o tempo decorrido, a contagem de turnos e a utilização de tokens (adicionado na v2.1.139).
/helpMostra a ajuda
/hooksMostra as configurações de hooks
/ideGere as integrações de IDE
/initInicializa o CLAUDE.md. Defina CLAUDE_CODE_NEW_INIT=1 para o fluxo interativo
/insightsGera um relatório de análise da sessão
/install-github-appConfigura a aplicação GitHub Actions
/install-slack-appInstala a aplicação Slack
/keybindingsAbre a configuração de keybindings
/fewer-permission-promptsAnalisa chamadas recentes de ferramentas Bash/MCP e adiciona uma lista de permissões priorizada ao .claude/settings.json para reduzir os pedidos de permissão (adicionado na v2.1.111)
/loginMuda de conta Anthropic
/logoutTermina a sessão na sua conta Anthropic
/mcpGere servidores MCP e OAuth
/memoryEdita o CLAUDE.md, ativa/desativa a memória automática
/mobileCódigo QR para a aplicação móvel (aliases: /ios, /android)
/model [model]Seleciona o modelo com as setas esquerda/direita para o esforço. Desde a v2.1.153, a escolha é guardada como predefinição para as novas sessões (correspondendo ao IDE); prima s após selecionar para a aplicar apenas à sessão atual. (O atalho de teclado modelPicker:setAsDefault foi renomeado para modelPicker:thisSessionOnly; a antiga ação d passou a ser s.) A partir da v2.1.219, o seletor mostrava a linha do Opus unificada como "Opus (1M context)"; a v2.1.283 remove esse rótulo das linhas Opus e Default, nas quais o Opus já tem uma janela de 1M (a janela mantém-se inalterada).
/output-style [name]Listar e alternar estilos de saída (readicionado na v2.1.269 após ter sido removido na v2.1.91). Sem argumento, lista os estilos e marca o atual. Funciona em sessões headless e de Remote Control; a seleção é guardada em .claude/settings.local.json
/passesPartilhar uma semana gratuita de Claude Code
/permissionsVer/atualizar permissões (alias: /allowed-tools)
/plan [description]Entrar no modo de planeamento
/pluginGerir plugins
/proactiveAlias de /loop (adicionado na v2.1.105)
/powerupDescobrir funcionalidades através de lições interativas com demonstrações animadas
/privacy-settingsDefinições de privacidade (apenas Pro/Max)
/release-notesVer o registo de alterações
/recapMostrar a recapitulação / o resumo da sessão ao regressar a uma sessão (adicionado na v2.1.108)
/reload-pluginsRecarregar os plugins ativos. Desde a v2.1.221, a maioria das instalações ativa imediatamente, pelo que só é necessário quando o resumo da instalação indica Run /reload-plugins to activate. Disponível em sessões headless a partir da v2.1.260, pelo que também aparece nas listas de comandos do Claude Code Desktop e do SDK
/reload-skillsReanalisar os diretórios de skills sem reiniciar a sessão (adicionado na v2.1.152)
/remote-controlControlo remoto a partir de claude.ai (alias: /rc)
/remote-envConfigurar o ambiente remoto predefinido
/rename [name]Renomear a sessão
/resume [session]Retomar a conversa (alias: /continue)
/review [low|medium|high|xhigh|max|ultra] [--fix] [--comment] [pr#|branch|path]Alias de /code-review (v2.1.223): analisa o diff atual, ou um número de PR, um branch ou um caminho que indicar, por exemplo /review 1234. Aceita os mesmos níveis de esforço e as mesmas flags. Sem nível indicado, reutiliza o último nível entre low e max que escreveu
/rewindRetroceder a conversa e/ou o código (alias: /checkpoint)
/sandboxAtivar/desativar o modo sandbox
/schedule [description]Criar/gerir tarefas agendadas na Cloud
/scroll-speed <+N|-N>Ajustar a velocidade de deslocamento da roda do rato no painel de pré-visualização em direto da TUI, com uma pré-visualização em direto. A definição é guardada por máquina em ~/.claude/preferences.json (adicionado na v2.1.139).
/security-reviewAnalisar o branch à procura de vulnerabilidades de segurança
/skill-doctorMostrar que skills carregadas ficam sem uso e quanto custa cada uma em contexto, para poder decidir quais desativar. O relatório abre no separador Stats do gestor /plugin; no modo não interativo -p, é impresso como texto. Através do Remote Control, responde Skill usage reports are not available on this connection.; execute-o no terminal da máquina que aloja a sessão (requer v2.1.252+)
/skillsListar as skills disponíveis
/statsAlias de atalho de escrita para /usage: abre o separador de estatísticas (utilização diária, sessões, sequências) (v2.1.118+)
/stickersEncomendar autocolantes de Claude Code
/statusMostrar a versão, o modelo, a conta e uma linha Session kind com o valor background job · attached, background job · unattended ou interactive (linha adicionada na v2.1.221). Pode ser aberto enquanto o Claude está a responder
/statuslineConfigurar a linha de estado
/tasksListar/gerir tarefas em segundo plano
/team-onboardingGerar um guia de integração para membros da equipa a partir da configuração do Claude Code do projeto (novo na v2.1.101)
/teleportRetomar uma sessão de Claude Code na web neste terminal; abre um seletor das suas sessões web (alias: /tp). Requer uma subscrição do claude.ai
/terminal-setupConfigurar os atalhos de teclado do terminal
/themeAbra o seletor de temas / faça a gestão de temas personalizados (v2.1.118). Defina temas personalizados via JSON em ~/.claude/themes/<name>.json
/tuiAtive/desative o modo TUI (interface de utilizador em texto) em ecrã inteiro com renderização sem cintilação (adicionado na v2.1.110)
/ultrareviewRevisão de código multiagente abrangente baseada na nuvem (adicionado na v2.1.111). A invocação preferida é agora /code-review ultra; /ultrareview mantém-se como alias. Inclui 3 execuções gratuitas nos planos Pro e Max, depois requer créditos de utilização
/upgradeAbra a página de upgrade para um nível de plano superior
/usagePainel de utilização canónico (v2.1.118) - combina os limites de utilização do plano, os limites de taxa, o custo e as estatísticas diárias de sessão. /cost e /stats são aliases de atalho de escrita que abrem separadores específicos
/voiceAtive/desative o ditado de voz push-to-talk
/workflowsVeja as execuções em curso e concluídas de fluxos de trabalho dinâmicos (adicionado na v2.1.154). Consulte Fluxos de Trabalho Dinâmicos
Porque é que o /cd é importante: mudar de diretório fazia perder o aquecimento da cache (tornando a próxima interação mais lenta e dispendiosa); o /cd preserva a cache de prompts durante a mudança.

Skills incluídas

Estas skills vêm incluídas no Claude Code e são invocadas como comandos slash:

SkillFinalidade
/batch <instruction>Orquestrar alterações paralelas em grande escala utilizando worktrees
/claude-apiCarregar a referência da Claude API para a linguagem do projeto
/datavizOrientação de design de gráficos e dashboards com um validador de paleta de cores executável (v2.1.198)
/debug [description]Ativar o registo de depuração
/design [description]Criar uma design canvas, um design visual multi-artboard (mockups de UI, fluxos de ecrã, landing pages, cartazes) publicado como artefacto e refinado visualmente em vez de em código. Use-a em vez de escrever HTML à mão quando o que quer iterar é o layout. Pré-visualização de investigação; requer a v2.1.233+ e um plano Pro, Max, Team ou Enterprise
/loop [interval] <prompt>Executar o prompt repetidamente num intervalo
/code-review [low|medium|high|xhigh|max|ultra] [--fix] [--comment] [pr#|branch|path]Rever o diff atual (ou um número de PR, branch ou caminho que indicar) à procura de bugs de correção. Passe --fix para aplicar as conclusões, --comment para publicá-las como comentários inline no PR do GitHub, ou ultra para executar uma revisão profunda na cloud; com ultra num alvo de PR github.com, --post pré-seleciona a publicação das conclusões no PR. Sem nível de esforço indicado, a revisão reutiliza o último nível que escreveu (v2.1.223). Originalmente absorveu o /simplify na v2.1.146, mas o /simplify regressou como comando distinto na v2.1.154
/simplifyExecutar uma revisão apenas de limpeza (reutilização / simplificação / eficiência / altitude) e aplicar as correções; não procura bugs, use /code-review para isso. Foi brevemente um alias de /code-review --fix (v2.1.152) e passou a ser apenas de limpeza na v2.1.154

Comandos obsoletos

ComandoEstado
/pr-commentsRemovido na v2.1.91 - peça diretamente ao Claude para ver os comentários do PR
/vimRemovido na v2.1.92 - use /config → Modo de editor
/undoJá não consta na referência oficial de comandos a partir da v2.1.245 (foi adicionado como alias de /rewind na v2.1.108) - use /rewind ou prima Esc duas vezes

Alterações recentes

  • /fork e /subtask invertiram os papéis na v2.1.212. /fork copia agora a conversa para uma nova sessão em segundo plano independente; o comportamento de subagente bifurcado que tinha passou para o novo comando /subtask. Histórico: /fork era um alias de /branch da v2.1.77 à v2.1.161; da v2.1.161 à v2.1.211 iniciava um subagente bifurcado (o que /subtask faz agora). Quando a vista de agente está desativada, /subtask não está disponível e /fork mantém o comportamento de subagente bifurcado
  • /resume (sem argumentos) abre um seletor de sessões anteriores (incluindo as que foram removidas da lista visível) e retoma a escolhida como sessão em segundo plano (v2.1.212)
  • /resume e claude --resume numa sessão que está a correr em segundo plano abrem essa sessão em vez de recusar, e claude --resume <id> "prompt" envia o prompt como o turno seguinte dessa sessão (v2.1.285)
  • /output-style foi descontinuado (v2.1.73) e removido (v2.1.91), para depois ser readicionado na v2.1.269 - voltou a ser um comando ativo na v2.1.278 e funciona em sessões headless e Remote Control. Os estilos de saída também continuam disponíveis via /config → Output style ou na definição outputStyle; os incorporados são Default, Proactive, Explanatory, Learning e Concise (adicionado na v2.1.237)
  • /review passou a ser um alias completo de /code-review - os mesmos alvos, níveis de esforço e flags (v2.1.223). Histórico: foi primeiro movido para o motor /code-review medium na v2.1.186, mantendo-se limitado a PRs
  • Comando /effort adicionado; nível max disponível no Opus 4.6+ (originalmente exclusivo do Opus 4.6)
  • Comando /voice adicionado para ditado de voz push-to-talk
  • Comando /schedule adicionado para criar/gerir tarefas agendadas
  • Comando /color adicionado para personalização da barra de prompt
  • /pr-comments removido na v2.1.91 - peça diretamente ao Claude para ver os comentários do PR
  • /vim removido na v2.1.92 - use /config → Editor mode em vez disso
  • /ultraplan foi removido na v2.1.222 - use o modo de planeamento em vez disso
  • /powerup adicionado para lições interativas sobre funcionalidades
  • /sandbox adicionado para alternar o modo sandbox
  • O seletor de /model mostra agora etiquetas legíveis por humanos (por exemplo, "Sonnet 4.6") em vez dos IDs de modelo em bruto
  • /resume suporta o alias /continue
  • Os prompts de MCP estão disponíveis como comandos /mcp__<server>__<prompt> (ver Prompts de MCP como Comandos)
  • /team-onboarding adicionado para gerar automaticamente guias de integração para membros da equipa (v2.1.101)
  • Comando /tui adicionado para renderização de TUI em ecrã inteiro sem cintilação (v2.1.110)
  • Comando /focus adicionado para alternar a vista de foco; Ctrl+O agora só alterna a transcrição verbosa (v2.1.110)
  • Comando /recap adicionado para acionar manualmente o resumo do contexto da sessão (v2.1.108)
  • /undo adicionado como alias de /rewind (v2.1.108); já não aparece na referência oficial de comandos a partir da v2.1.245 - use /rewind ou Esc Esc
  • /proactive adicionado como alias de /loop (v2.1.105)
  • /effort ganhou um deslizador interativo controlado pelas teclas de seta e um novo nível xhigh entre high e max; o esforço predefinido passou para xhigh nos planos do Opus 4.7 (v2.1.111). No Opus 4.8 a predefinição é high (v2.1.154); o Opus 5 também usa high como predefinição (v2.1.219)
  • /ultrareview adicionado para revisão de código multiagente abrangente baseada na nuvem (v2.1.111)
  • /fewer-permission-prompts adicionado para analisar chamadas de ferramentas Bash/MCP e reduzir os pedidos de permissão através de uma lista de permissões em .claude/settings.json (v2.1.111)
  • O modo Auto já não requer a flag --enable-auto-mode para subscritores Max no Opus 4.7 (v2.1.112)
  • /goal adicionado - condição de conclusão ao nível da sessão que o Claude procura cumprir ao longo de vários turnos; a sobreposição em direto mostra o tempo decorrido, o número de turnos e a utilização de tokens (v2.1.139)
  • /scroll-speed adicionado - ajusta a velocidade de deslocamento da roda do rato no painel de pré-visualização em direto da TUI; a definição persiste por máquina (v2.1.139)
  • /reload-skills adicionado - reanalisa os diretórios de skills sem reiniciar a sessão (v2.1.152)
  • /model agora guarda o modelo selecionado como predefinido para novas sessões; prima s para o manter apenas na sessão atual (atalho de teclado modelPicker:setAsDefault → modelPicker:thisSessionOnly) (v2.1.153)
  • /workflows adicionado - ver as execuções em curso e concluídas de fluxos de trabalho dinâmicos (v2.1.154)
  • /simplify regressou como um comando de revisão distinto, dedicado apenas à limpeza (reutilização / simplificação / eficiência / altitude), separado da caça a bugs do /code-review (v2.1.154)
  • /status ganhou uma linha Session kind que distingue as tarefas em segundo plano anexadas e não supervisionadas das sessões interativas (v2.1.221)
  • As instalações de plugins são agora ativadas imediatamente quando é seguro fazê-lo; /reload-plugins só é necessário quando o resumo da instalação o pedir (v2.1.221)
  • /ultraplan removido - use o modo de planeamento (v2.1.222)
  • /code-review e /review memorizam o último nível de esforço que introduziu quando omite um (v2.1.223)
  • /code-review ultra tornou-se o ponto de entrada preferido para a revisão multiagente na nuvem; /ultrareview mantém-se como alias (v2.1.223)
  • /code-review ao nível de esforço high, xhigh e max agora é executado num agente em segundo plano, como os restantes níveis (v2.1.232)
  • A dica de arranque que sugeria criar subagentes personalizados e o lembrete correspondente no tour do /powerup foram removidos (v2.1.232)
  • /permissions pode agora ser aberto enquanto o Claude está a trabalhar - as alterações às regras aplicam-se ao resto do turno atual (v2.1.234)
  • /add-dir <path> pode agora ser usado enquanto o Claude está a trabalhar; os diálogos /add-dir, /autocompact, /theme, /help, /config e /advisor abrem a meio do turno na TUI de ecrã inteiro, em vez de ficarem em fila até o Claude terminar de responder (/bug já abria imediatamente, desde a v2.1.232) (v2.1.234)

/goal - Condição de conclusão ao nível da sessão

Novidade na v2.1.139

Use /goal para registar uma condição de conclusão para a sessão atual. O Claude trabalha para a cumprir ao longo de vários turnos, e um painel de sobreposição mostra o tempo decorrido, o número de turnos e os tokens utilizados. Elimine-a com /goal clear. Funciona no modo interativo, em claude -p e no Remote Control.

Terminal
User: /goal Migrate the payments service from REST to gRPC and get the integration tests passing.
Claude: Goal registered. I'll work toward this until you clear it.
[Goal panel: ⏱ 0s · turns 0 · tokens 0]

User: start by listing the REST endpoints
Claude: [does the work, panel updates]

Check-in de tarefas em segundo plano paradas (v2.1.234): enquanto um objetivo está ativo, se uma tarefa em segundo plano não fizer progressos durante 30 ou mais minutos, o Claude faz um check-in com uma atualização de estado em vez de continuar em silêncio. Ajuste o limiar (em minutos) com a variável de ambiente CLAUDE_CODE_GOAL_CHECKIN_MINUTES, ou defina-a como 0 para desativar completamente os check-ins.

/team-onboarding - Guia de integração para novos membros da equipa

Novidade na v2.1.101

Use /team-onboarding para gerar um guia de integração para novos membros da equipa a partir da utilização local do Claude Code no seu projeto. O comando analisa o seu CLAUDE.md, as skills instaladas, os subagentes, os hooks e os fluxos de trabalho recentes e, em seguida, produz um documento de integração que ajuda os novos programadores a tornarem-se produtivos rapidamente.

É um comando incorporado - nada a instalar.

Utilização:

Terminal
claude /team-onboarding

O guia gerado resume:

  • O objetivo do projeto e as principais convenções de CLAUDE.md
  • As skills disponíveis e quando são invocadas automaticamente
  • Os subagentes configurados e as respetivas responsabilidades
  • Os hooks que são executados em eventos comuns
  • Os fluxos de trabalho comuns que os recém-chegados devem conhecer

Disponibilidade: Lançado no Claude Code v2.1.101 (11 de abril de 2026).

Comandos Personalizados (Agora Skills)

Os comandos slash personalizados foram integrados nas skills. Ambas as abordagens criam comandos que pode invocar com /command-name:

AbordagemLocalizaçãoEstado
Skills (Recomendadas).claude/skills/<name>/SKILL.mdPadrão atual
Comandos Legados.claude/commands/<name>.mdAinda funciona

Se uma skill e um comando partilharem o mesmo nome, a skill tem precedência. Por exemplo, quando existem tanto .claude/commands/review.md como .claude/skills/review/SKILL.md, é utilizada a versão da skill.

Caminho de Migração

Os seus ficheiros .claude/commands/ existentes continuam a funcionar sem alterações. Para migrar para skills:

Antes (Comando):

Terminal
.claude/commands/optimize.md

Depois (Skill):

Terminal
.claude/skills/optimize/SKILL.md

Porquê Skills?

As skills oferecem funcionalidades adicionais relativamente aos comandos legados:

  • Estrutura de diretórios: Agrupe scripts, modelos e ficheiros de referência
  • Invocação automática: O Claude pode acionar skills automaticamente quando for relevante
  • Controlo de invocação: Escolha se os utilizadores, o Claude ou ambos podem invocar
  • Execução em subagentes: Execute skills em contextos isolados com context: fork
  • Divulgação progressiva: Carregue ficheiros adicionais apenas quando necessário

Criar um comando personalizado como skill

Crie um diretório com um ficheiro SKILL.md:

Terminal
mkdir -p .claude/skills/my-command

Ficheiro: .claude/skills/my-command/SKILL.md

Terminal
---
name: my-command
description: What this command does and when to use it
---

# My Command

Instructions for Claude to follow when this command is invoked.

1. First step
2. Second step
3. Third step

Referência de frontmatter

CampoFinalidadePredefinição
nameNome do comando (torna-se /name)Nome do diretório
descriptionBreve descrição (ajuda o Claude a saber quando o usar)Primeiro parágrafo
argument-hintArgumentos esperados para o preenchimento automáticoNenhum
allowed-toolsFerramentas que o comando pode utilizar sem permissãoHerda
modelModelo específico a utilizarHerda
disable-model-invocationSe true, apenas o utilizador pode invocar (não o Claude)false
user-invocableSe false, oculta do menu /true
contextDefinir como fork para executar num subagente isoladoNenhum
agentTipo de agente ao usar context: forkgeneral-purpose
hooksHooks no âmbito da skill (PreToolUse, PostToolUse, Stop)Nenhum

Argumentos

Os comandos podem receber argumentos:

Todos os argumentos com $ARGUMENTS:

Terminal
---
name: fix-issue
description: Fix a GitHub issue by number
---

Fix issue #$ARGUMENTS following our coding standards

Utilização: /fix-issue 123 → $ARGUMENTS passa a ser "123"

Argumentos individuais com $0, $1, etc.:

Terminal
---
name: review-pr
description: Review a PR with priority
---

Review PR #$0 with priority $1

Utilização: /review-pr 456 high → $0="456", $1="high"

${CLAUDE_PROJECT_DIR} resolve para o caminho absoluto da raiz do projeto (v2.1.196).

Contexto dinâmico com comandos shell

Execute comandos bash antes do prompt utilizando ` !command `:

Terminal
---
name: commit
description: Create a git commit with context
allowed-tools: Bash(git *)
---

## Context

- Current git status: !`git status`
- Current git diff: !`git diff HEAD`
- Current branch: !`git branch --show-current`
- Recent commits: !`git log --oneline -5`

## Your task

Based on the above changes, create a single git commit.

Referências a ficheiros

Inclua o conteúdo de ficheiros utilizando @:

Terminal
Review the implementation in @src/utils/helpers.js
Compare @src/old-version.js with @src/new-version.js

Comandos de plugins

Os plugins podem fornecer comandos personalizados:

Terminal
/plugin-name:command-name

Ou simplesmente /command-name quando não houver conflitos de nomes.

Exemplos:

Terminal
/frontend-design:frontend-design
/commit-commands:commit

Prompts do MCP como comandos

Os servidores MCP podem expor prompts como comandos slash:

Terminal
/mcp__<server-name>__<prompt-name> [arguments]

Exemplos:

Terminal
/mcp__github__list_prs
/mcp__github__pr_review 456
/mcp__jira__create_issue "Bug title" high

Sintaxe de permissões MCP

Controle o acesso ao servidor MCP nas permissões:

  • mcp__github - Acesso a todo o servidor MCP do GitHub
  • mcp__github__* - Acesso com wildcard a todas as ferramentas
  • mcp__github__get_issue - Acesso a uma ferramenta específica

Arquitetura de comandos

Terminal
graph TD
    A["User Input: /command-name"] --> B{"Command Type?"}
    B -->|Built-in| C["Execute Built-in"]
    B -->|Skill| D["Load SKILL.md"]
    B -->|Plugin| E["Load Plugin Command"]
    B -->|MCP| F["Execute MCP Prompt"]

    D --> G["Parse Frontmatter"]
    G --> H["Substitute Variables"]
    H --> I["Execute Shell Commands"]
    I --> J["Send to Claude"]
    J --> K["Return Results"]

Ciclo de vida do comando

Terminal
sequenceDiagram
    participant User
    participant Claude as Claude Code
    participant FS as File System
    participant CLI as Shell/Bash

    User->>Claude: Types /optimize
    Claude->>FS: Searches .claude/skills/ and .claude/commands/
    FS-->>Claude: Returns optimize/SKILL.md
    Claude->>Claude: Parses frontmatter
    Claude->>CLI: Executes !`command` substitutions
    CLI-->>Claude: Command outputs
    Claude->>Claude: Substitutes $ARGUMENTS
    Claude->>User: Processes prompt
    Claude->>User: Returns results

Comandos disponíveis nesta pasta

Estes comandos de exemplo podem ser instalados como skills ou comandos legados.

1. /optimize - Otimização de código

Analisa o código à procura de problemas de desempenho, fugas de memória e oportunidades de otimização.

Utilização:

Terminal
/optimize
[Paste your code]

2. /pr - Preparação do Pull Request

Orienta-o ao longo da lista de verificação de preparação do PR, incluindo linting, testes e formatação de commits.

Utilização:

Terminal
/pr

Captura de ecrã:

/pr

3. /generate-api-docs - Gerador de Documentação de API

Gera documentação de API abrangente a partir do código-fonte.

Utilização:

Terminal
/generate-api-docs

4. /commit - Commit no Git com Contexto

Cria um commit no git com contexto dinâmico a partir do seu repositório.

Utilização:

Terminal
/commit [optional message]

5. /push-all - Stage, Commit e Push

Prepara todas as alterações, cria um commit e faz push para o remoto com verificações de segurança.

Utilização:

Terminal
/push-all

Verificações de Segurança:

  • Segredos: .env, .key, *.pem, credentials.json
  • Chaves de API: Deteta chaves reais vs. marcadores de posição
  • Ficheiros grandes: >10MB sem Git LFS
  • Artefactos de compilação: node_modules/, dist/, __pycache__/

6. /doc-refactor - Reestruturação da Documentação

Reestrutura a documentação do projeto para maior clareza e acessibilidade.

Utilização:

Terminal
/doc-refactor

7. /setup-ci-cd - Configuração do pipeline de CI/CD

Implementa hooks de pre-commit e GitHub Actions para garantia de qualidade.

Utilização:

Terminal
/setup-ci-cd

8. /unit-test-expand - Expansão da Cobertura de Testes

Aumenta a cobertura de testes ao visar ramos não testados e casos limite.

Utilização:

Terminal
/unit-test-expand

Instalação

Como Skills (Recomendado)

Copie para o seu diretório de skills:

Terminal
# Create skills directory
mkdir -p .claude/skills

# For each command file, create a skill directory
for cmd in optimize pr commit; do
  mkdir -p .claude/skills/$cmd
  cp 01-slash-commands/$cmd.md .claude/skills/$cmd/SKILL.md
done

Os comandos legados

Copie para o seu diretório de comandos:

Terminal
# Project-wide (team)
mkdir -p .claude/commands
cp 01-slash-commands/*.md .claude/commands/

# Personal use
mkdir -p ~/.claude/commands
cp 01-slash-commands/*.md ~/.claude/commands/

Criar os seus próprios comandos

Modelo de skill (recomendado)

Crie .claude/skills/my-command/SKILL.md:

Terminal
---
name: my-command
description: What this command does. Use when [trigger conditions].
argument-hint: [optional-args]
allowed-tools: Bash(npm *), Read, Grep
---

# Command Title

## Context

- Current branch: !`git branch --show-current`
- Related files: @package.json

## Instructions

1. First step
2. Second step with argument: $ARGUMENTS
3. Third step

## Output Format

- How to format the response
- What to include

Comando Exclusivo do Utilizador (Sem Invocação Automática)

Para comandos com efeitos secundários que o Claude não deve acionar automaticamente:

Terminal
---
name: deploy
description: Deploy to production
disable-model-invocation: true
allowed-tools: Bash(npm *), Bash(git *)
---

Deploy the application to production:

1. Run tests
2. Build application
3. Push to deployment target
4. Verify deployment

Boas Práticas

FazerNão fazer
Use nomes claros e orientados para a açãoCrie comandos para tarefas pontuais
Inclua description com condições de acionamentoConstrua lógica complexa nos comandos
Mantenha os comandos focados numa única tarefaCodifique informações sensíveis diretamente no código
Use disable-model-invocation para efeitos secundáriosOmita o campo description
Use o prefixo ! para contexto dinâmicoPresuma que o Claude conhece o estado atual
Organize ficheiros relacionados em diretórios de skillsColoque tudo num único ficheiro

Resolução de Problemas

Comando Não Encontrado

Soluções:

  • Verifique se o ficheiro está em .claude/skills/<name>/SKILL.md ou .claude/commands/<name>.md
  • Verifique se o campo name no frontmatter corresponde ao nome de comando esperado
  • Reinicie a sessão do Claude Code
  • Execute /help para ver os comandos disponíveis

Comando Não É Executado Como Esperado

Soluções:

  • Adicione instruções mais específicas
  • Inclua exemplos no ficheiro de skill
  • Verifique allowed-tools se estiver a usar comandos bash
  • Teste primeiro com entradas simples

Conflito Entre Skill e Comando

Se ambos existirem com o mesmo nome, a skill tem precedência. Remova um deles ou mude-lhe o nome.

Guias Relacionados

  • Skills - Referência completa de skills (capacidades invocadas automaticamente)
  • Memória - Contexto persistente com CLAUDE.md
  • Subagentes - Agentes de IA delegados
  • Plugins - Coleções de comandos agrupados
  • Hooks - Automação orientada por eventos

Recursos Adicionais

Última Atualização: 30 de setembro de 2026

Versão do Claude Code: 2.1.285

Fontes:

  • https://code.claude.com/docs/en/output-styles
  • https://code.claude.com/docs/en/skills
  • https://code.claude.com/docs/en/slash-commands
  • https://code.claude.com/docs/en/interactive-mode
  • https://code.claude.com/docs/en/interactive-mode#review-changes-with-diff
  • https://code.claude.com/docs/en/changelog
  • https://code.claude.com/docs/en/commands
  • https://code.claude.com/docs/en/whats-new/2026-w34
  • https://code.claude.com/docs/en/model-config
  • https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md
  • https://github.com/anthropics/claude-code/releases/tag/v2.1.139
  • https://github.com/anthropics/claude-code/releases/tag/v2.1.144
  • https://github.com/anthropics/claude-code/releases/tag/v2.1.152
  • https://github.com/anthropics/claude-code/releases/tag/v2.1.153
  • https://github.com/anthropics/claude-code/releases/tag/v2.1.154
  • https://github.com/anthropics/claude-code/releases/tag/v2.1.281
  • https://code.claude.com/docs/en/fast-mode
  • https://github.com/anthropics/claude-code/releases/tag/v2.1.283
  • https://code.claude.com/docs/en/workflows#let-claude-decide-with-ultracode
  • https://github.com/anthropics/claude-code/releases/tag/v2.1.285

Modelos Compatíveis: Claude Fable 5, Claude Opus 5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5

Parte da série de guias Claude How To

Exemplos e recursos deste módulo

Guia da comunidade open-source (MIT) · tradução e manutenção Doutor AI.

Precisa de uma solução à medida?

Não sabe por onde começar a usar IA no seu negócio? Receba uma avaliação gratuita e um plano à medida - sem compromisso.

Poupe horas todas as semanas com IA, sem complicações

O Doutor AI dá-lhe 1859 prompts de IA prontos a copiar, por indústria e em português simples - mais uma biblioteca técnica completa para quem quer ir mais longe.

Ver planos