Comandos

Este documento detalha todos os comandos suportados pelo Qwen Code, ajudando você a gerenciar sessões, personalizar a interface e controlar seu comportamento de forma eficiente.

Os comandos do Qwen Code são acionados por meio de prefixos específicos e se dividem em três categorias:

1. Comandos de Barra (/)

Os comandos de barra são usados para gerenciar sessões, a interface e o comportamento básico do Qwen Code.

1.1 Gerenciamento de Sessão e Projeto

Esses comandos ajudam você a salvar, restaurar e resumir o progresso do trabalho.

1.2 Controle de Interface e Área de Trabalho

Comandos para ajustar a aparência da interface e o ambiente de trabalho.

1.3 Configurações de Idioma

Comandos específicos para controlar o idioma da interface e da saída.

• Idiomas de UI integrados disponíveis: zh-CN (Chinês Simplificado), en-US (Inglês), ru-RU (Russo), de-DE (Alemão)
• Exemplos de idioma de saída: Chinese, English, Japanese, etc.

1.4 Gerenciamento de Ferramentas e Modelos

Comandos para gerenciar ferramentas e modelos de IA.

1.5 Skills Integrados

Esses comandos invocam skills empacotados que fornecem fluxos de trabalho especializados.

Consulte Code Review para a documentação completa do /review.

1.6 Pergunta Lateral (/btw)

O comando /btw permite fazer perguntas laterais rápidas sem interromper ou afetar o fluxo principal da conversa.

Como funciona:

• A pergunta lateral é enviada como uma chamada de API separada com o contexto recente da conversa (até as últimas 20 mensagens)
• A resposta é exibida acima do Composer — você pode continuar digitando enquanto aguarda
• A conversa principal não é bloqueada — ela continua de forma independente
• A resposta da pergunta lateral não se torna parte do histórico da conversa principal
• As respostas são renderizadas com suporte completo a Markdown (blocos de código, listas, tabelas, etc.)

Atalhos de Teclado (Modo Interativo):

Exemplo:

(While the main conversation is about refactoring code)

> /btw What's the difference between let and var in JavaScript?

  ╭──────────────────────────────────────────╮
  │ /btw What's the difference between let   │
  │     and var in JavaScript?               │
  │                                          │
  │ + Answering...                           │
  │ Press Escape, Ctrl+C, or Ctrl+D to cancel│
  ╰──────────────────────────────────────────╯
  > (Composer remains active — keep typing)

(After the answer arrives)

  ╭──────────────────────────────────────────╮
  │ /btw What's the difference between let   │
  │     and var in JavaScript?               │
  │                                          │
  │ `let` is block-scoped, while `var` is    │
  │ function-scoped. `let` was introduced    │
  │ in ES6 and doesn't hoist the same way.   │
  │                                          │
  │ Press Space, Enter, or Escape to dismiss │
  ╰──────────────────────────────────────────╯
  > (Composer still active)

Modos de Execução Suportados:

1.7 Resumo da Sessão (/recap)

O comando /recap gera um breve resumo de “onde você parou” da sessão atual, permitindo que você retome uma conversa antiga sem precisar rolar páginas de histórico.

Como funciona:

• Usa o modelo rápido configurado (configuração fastModel) quando disponível, com fallback para o modelo principal da sessão. Um modelo pequeno e barato é suficiente para um resumo.
• A conversa recente (até 30 mensagens, apenas texto — chamadas e respostas de ferramentas são filtradas) é enviada ao modelo com um prompt de sistema restrito.
• O resumo é renderizado em cor mais clara com o prefixo ❯ para se destacar das respostas reais do assistente.
• Recusa com um erro inline se uma resposta do modelo estiver em andamento ou outro comando estiver sendo processado. Se não houver conversa utilizável ou se a geração subjacente falhar, o /recap mostra uma mensagem informativa curta em vez de um resumo — o comando manual sempre responde com algo.

Acionamento automático ao retornar de uma ausência:

Se o terminal ficar desfocado por 5+ minutos e for focado novamente, um resumo é gerado e exibido automaticamente (apenas quando nenhuma resposta do modelo está em andamento; caso contrário, ele aguarda a conclusão da vez atual e então é acionado). Diferente do comando manual, o acionamento automático é totalmente silencioso em caso de falha: se houver erros de geração ou nada para resumir, nenhuma mensagem é adicionada ao histórico. Controlado pela configuração general.showSessionRecap (padrão: true); o comando manual /recap sempre funciona independentemente dessa configuração.

Exemplo:

> /recap

❯ Refactoring loopDetectionService.ts to address long-session OOM caused by
  unbounded streamContentHistory and contentStats. The next step is to
  implement option B (LRU sliding window with FNV-1a) pending confirmation.

1.8 Informações, Configurações e Ajuda

Comandos para obter informações e realizar configurações do sistema.

1.9 Atalhos Comuns

1.10 Subcomandos de Autenticação via CLI

Além do comando de barra /auth dentro da sessão, o Qwen Code fornece subcomandos CLI independentes para gerenciar a autenticação diretamente pelo terminal:

2. Comandos @ (Introduzindo Arquivos)

Os comandos @ são usados para adicionar rapidamente o conteúdo de arquivos ou diretórios locais à conversa.

Nota: Espaços em caminhos precisam ser escapados com barra invertida (ex.: @My\ Documents/file.txt)

3. Comandos de Exclamação (!) - Execução de Comandos Shell

Os comandos de exclamação permitem executar comandos do sistema diretamente dentro do Qwen Code.

Variáveis de Ambiente: Comandos executados via ! definirão a variável de ambiente QWEN_CODE=1.

4. Comandos Personalizados

Salve prompts usados frequentemente como comandos de atalho para melhorar a eficiência do trabalho e garantir consistência.

Visão Rápida

Regras de Prioridade: Comandos do projeto > Comandos do usuário (o comando do projeto é usado quando os nomes são iguais)

Regras de Nomeação de Comandos

Tabela de Mapeamento de Caminho de Arquivo para Nome do Comando

Regras de Nomeação: Separador de caminho (/ ou \) convertido para dois-pontos (:)

Especificação do Formato de Arquivo Markdown (Recomendado)

Comandos personalizados usam arquivos Markdown com frontmatter YAML opcional:

---
description: Optional description (displayed in /help)
---
 
Your prompt content here.
Use {{args}} for parameter injection.

Formato de Arquivo TOML (Obsoleto)

Mecanismo de Processamento de Parâmetros

1. Injeção Sensível ao Contexto ({{args}})

2. Processamento Padrão de Parâmetros

🚀 Injeção de Conteúdo Dinâmico

3. Execução de Comando Shell (!{...})

Exemplo: Geração de Mensagem de Commit Git

---
description: Generate Commit message based on staged changes
---
 
Please generate a Commit message based on the following diff:
 
```diff
!{git diff --staged}
```

4. Injeção de Conteúdo de Arquivo (@{...})

Exemplo: Comando de Revisão de Código

---
description: Code review based on best practices
---
 
Review {{args}}, reference standards:
 
@{docs/code-standards.md}

Exemplo Prático de Criação

Tabela de Etapas de Criação do Comando “Refatoração para Função Pura”

---
description: Refactor code to pure function
---
 
Please analyze code in current context, refactor to pure function.
Requirements:
 
1. Provide refactored code
2. Explain key changes and pure function characteristic implementation
3. Maintain function unchanged

Resumo das Melhores Práticas para Comandos Personalizados

Tabela de Recomendações de Design de Comandos

Tabela de Lembrete de Recursos de Segurança