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, interface e comportamento básico do Qwen Code.

1.1 Gerenciamento de Sessões e Projetos

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

1.2 Controle de Interface e Espaço 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 interface integrados disponíveis: zh-CN (Chinês Simplificado), en-US (Inglês), ru-RU (Russo), de-DE (Alemão), ja-JP (Japonês), pt-BR (Português - Brasil), fr-FR (Francês), ca-ES (Catalã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 Integradas

Estes comandos invocam skills integradas que fornecem fluxos de trabalho especializados.

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

1.6 Pergunta Paralela (/btw)

O comando /btw permite que você faça perguntas paralelas rápidas sem interromper ou afetar o fluxo da conversa principal.

Como Funciona:

• A pergunta paralela é 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 independentemente
• A resposta da pergunta paralela não faz 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:

(Enquanto a conversa principal é sobre refatorar código)

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

  ╭──────────────────────────────────────────╮
  │ /btw What's the difference between let   │
  │     and var in JavaScript?               │
  │                                          │
  │ + Respondendo...                         │
  │ Pressione Escape, Ctrl+C ou Ctrl+D para  │
  │ cancelar                                 │
  ╰──────────────────────────────────────────╯
  > (O Composer permanece ativo — continue digitando)

(Depois que a resposta chegar)

  ╭──────────────────────────────────────────╮
  │ /btw What's the difference between let   │
  │     and var in JavaScript?               │
  │                                          │
  │ `let` tem escopo de bloco, enquanto      │
  │ `var` tem escopo de função. `let` foi    │
  │ introduzido no ES6 e não faz hoist da    │
  │ mesma forma.                             │
  │                                          │
  │ Pressione Space, Enter ou Escape para    │
  │ dispensar                                │
  ╰──────────────────────────────────────────╯
  > (Composer ainda ativo)

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 por páginas de histórico.

Como funciona:

• Usa o modelo rápido configurado (configuração fastModel) quando disponível, voltando para o modelo principal da sessão como fallback. Um modelo pequeno e barato é suficiente para um resumo.
• A conversa recente (até 30 mensagens, apenas texto — chamadas de ferramentas e respostas de ferramentas são filtradas) é enviada ao modelo com um system prompt restrito.
• O resumo é renderizado em cor esmaecida com o prefixo ❯ para se destacar das respostas reais do assistente.
• Recusa com um erro inline se um turno 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 estiver em progresso; caso contrário, ele aguarda o turno atual terminar 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 não houver nada para resumir, nenhuma mensagem é adicionada ao histórico. Controlado pela configuração general.showSessionRecap (padrão: false); o comando manual /recap sempre funciona independentemente desta configuração.

Exemplo:

> /recap

❯ Refatorando loopDetectionService.ts para resolver o OOM de sessão longa causado por
  streamContentHistory e contentStats ilimitados. O próximo passo é
  implementar a opção B (janela deslizante LRU com FNV-1a) pendente de confirmação.

1.8 Visualizador de Diff (/diff)

O comando /diff abre um visualizador de diff interativo mostrando alterações não commitadas e diffs por turno. Use ←/→ para alternar entre o git diff atual e os turnos individuais da conversa, ↑/↓ para navegar pelos arquivos e Enter para visualizar os diffs inline.

Como funciona:

No modo interativo, o /diff abre um diálogo com um seletor de origem na parte superior:

• Current — working tree vs HEAD (git diff HEAD). Mostra todas as alterações não commitadas, incluindo arquivos staged, unstaged e untracked.
• T1, T2, T3, … — diffs por turno, uma aba por turno do modelo que modificou arquivos. Os turnos mais recentes aparecem primeiro. Cada aba mostra uma prévia do prompt original para contexto.

A lista de arquivos exibe estatísticas por arquivo (linhas adicionadas/removidas) com tags para estados especiais (new, deleted, untracked, binary, truncated, oversized). Pressione Enter em um arquivo para ver seu diff inline com hunks destacados por sintaxe.

Diffs por turno requerem que o file checkpointing esteja habilitado (ativado por padrão no modo interativo). Quando o file checkpointing está desativado, apenas a origem “Current” está disponível.

Atalhos de teclado:

Exemplo:

┌ /diff · Turno 3 "refactor the auth middleware" ──── 3 arquivos +45 -12 ┐
│                                                                        │
│ ◀ Current · T3 · T2 · T1 ▶                                             │
│                                                                        │
│ › src/utils/parser.ts                                  +30 -8          │
│   src/utils/parser.test.ts                             +12 -2          │
│   README.md                                            +3 -2           │
│                                                                        │
│ ←/→ origem · ↑/↓ arquivo · Enter ver · Esc fechar                      │
└────────────────────────────────────────────────────────────────────────┘

Modo não interativo:

Em contextos headless (--prompt) ou não interativos, o /diff imprime um resumo em texto simples do working tree vs HEAD. A navegação por turno não está disponível.

3 files changed, +45 / -12
  +30  -8  src/utils/parser.ts
  +12  -2  src/utils/parser.test.ts
   +3  -2  README.md

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

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

1.10 Atalhos Comuns

1.11 Comandos de Autenticação

Use /auth dentro de uma sessão do Qwen Code para configurar a autenticação. Use /doctor para inspecionar o status atual de autenticação e do ambiente.

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 nos 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 que você execute 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 com frequência como comandos de atalho para melhorar a eficiência do trabalho e garantir consistência.

Visão Geral 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 Nomenclatura de Comandos

Tabela de Mapeamento de Caminho de Arquivo para Nome de Comando

Regras de Nomenclatura: O separador de caminho (/ ou \) é convertido em dois pontos (:)

Especificação de 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 (Descontinuado)

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: Gera mensagem de Commit com base nas alterações staged
---
 
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 Code Review

---
description: Code review com base nas melhores práticas
---
 
Revise {{args}}, padrões de referência:
 
@{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: Refatora código para função pura
---
 
Por favor, analise o código no contexto atual e refatore para uma função pura.
Requisitos:
 
1. Fornecer o código refatorado
2. Explicar as principais alterações e a implementação das características de função pura
3. Manter a função inalterada

Resumo das Melhores Práticas para Comandos Personalizados

Tabela de Recomendações de Design de Comandos

Tabela de Resumo dos Recursos de Segurança

5. Subcomandos da CLI

Estes comandos são executados a partir do shell como qwen <subcomando> antes de iniciar uma sessão interativa.

Gerenciamento de Sessões

qwen sessions list

Lista suas sessões recentes do Qwen Code com metadados.

Flags:

Saída legível por humanos (padrão):

Uma tabela com as colunas: SESSION ID, STARTED (timestamp UTC), TITLE, BRANCH, PROMPT.

Saída em JSON (--json):

Gera JSON Lines no stdout. Cada linha é um objeto JSON com os campos:

sessionId, startTime, mtime, prompt, gitBranch, customTitle, titleSource, filePath, cwd

O aviso de “has more sessions” é emitido via stderr para que o pipe para jq permaneça seguro.

Exemplos:

# Mostra as últimas 20 sessões (padrão)
qwen sessions list
 
# Mostra as últimas 50 sessões
qwen sessions list --limit 50
 
# Saída em JSON para scripts
qwen sessions list --json | jq .