Temas

O Qwen Code oferece suporte a uma variedade de temas para personalizar seu esquema de cores e aparência. Você pode alterar o tema de acordo com suas preferências usando o comando /theme ou a configuração "ui.theme".

Temas Disponíveis

O Qwen Code vem com uma seleção de temas predefinidos, que você pode listar usando o comando /theme na CLI:

Temas Escuros:
- ANSI
- Atom One
- Ayu
- Default
- Dracula
- GitHub
- Qwen Dark
- Shades Of Purple
Temas Claros:
- ANSI Light
- Ayu Light
- Default Light
- GitHub Light
- Google Code
- Qwen Light
- Xcode

Alterando Temas

Digite /theme no Qwen Code.
Uma caixa de diálogo ou prompt de seleção aparece, listando os temas disponíveis.
Usando as teclas de seta, selecione um tema. Algumas interfaces podem oferecer uma prévia ao vivo ou destaque conforme você seleciona.
Confirme sua seleção para aplicar o tema.

Nota: Se um tema estiver definido no seu arquivo settings.json (seja por nome ou por caminho de arquivo), você deve remover a configuração "ui.theme" do arquivo antes de poder alterar o tema usando o comando /theme.

Persistência do Tema

Os temas selecionados são salvos na configuração do Qwen Code para que sua preferência seja lembrada entre sessões.

Detecção Automática de Tema

Quando o tema está definido como "auto" (ou não definido), o Qwen Code detecta automaticamente se o seu terminal usa um fundo escuro ou claro e seleciona o tema Qwen correspondente (Qwen Dark ou Qwen Light).

Como ativar

Defina o tema como "auto" em settings.json:


{
  "ui": {
    "theme": "auto"
  }
}

Ou selecione Auto no diálogo /theme. Este é o comportamento padrão quando nenhum tema é explicitamente configurado.

Métodos de detecção

O Qwen Code usa vários métodos de detecção em uma cadeia de fallback. Na inicialização (caminho assíncrono), a ordem é:

Prioridade	Método	Plataforma	Como funciona
1	`COLORFGBG`	Todas	Lê a variável de ambiente `COLORFGBG` (definida por terminais como iTerm2, rxvt, Konsole)
2	OSC 11	Todas (TTY)	Envia uma consulta `ESC]11;?` ao terminal e interpreta a cor de fundo a partir da resposta (~200ms)
3	Aparência do sistema macOS	Apenas macOS	Executa `defaults read -g AppleInterfaceStyle` para verificar se o Modo Escuro do macOS está ativo
4	Padrão	Todas	Falha para o tema escuro se nenhum método for bem-sucedido

O primeiro método que retorna um resultado vence. O valor detectado é armazenado em cache para a sessão para que as resoluções de tema subsequentes (por exemplo, reselecionar Auto no diálogo /theme) permaneçam consistentes.

Quando usar Auto

A maioria dos usuários — Auto funciona bem se o fundo do seu terminal corresponder à aparência do sistema operacional ou se o seu terminal definir COLORFGBG / suportar OSC 11.
Usuários de tmux / screen — OSC 11 pode não atravessar multiplexadores. A detecção recai para COLORFGBG ou aparência do sistema macOS. Se nenhum estiver disponível, o tema escuro padrão é usado. Defina um tema específico se a detecção automática der o resultado errado.
Sessões SSH — a detecção depende do ambiente remoto. Se COLORFGBG não for encaminhado e o terminal remoto não responder ao OSC 11, o tema escuro padrão é usado.

Temas de Cores Personalizados

O Qwen Code permite que você crie seus próprios temas de cores personalizados, especificando-os no arquivo settings.json. Isso oferece controle total sobre a paleta de cores usada na CLI.

Como Definir um Tema Personalizado

Adicione um bloco customThemes ao seu arquivo settings.json de usuário, projeto ou sistema. Cada tema personalizado é definido como um objeto com um nome único e um conjunto de chaves de cor. Por exemplo:


{
  "ui": {
    "customThemes": {
      "MyCustomTheme": {
        "name": "MyCustomTheme",
        "type": "custom",
        "Background": "#181818",
        ...
      }
    }
  }
}

Chaves de cor:

Background
Foreground
LightBlue
AccentBlue
AccentPurple
AccentCyan
AccentGreen
AccentYellow
AccentRed
Comment
Gray
DiffAdded (opcional, para linhas adicionadas em diffs)
DiffRemoved (opcional, para linhas removidas em diffs)
DiffModified (opcional, para linhas modificadas em diffs)

Propriedades Obrigatórias:

name (deve corresponder à chave no objeto customThemes e ser uma string)
type (deve ser a string "custom")
Background
Foreground
LightBlue
AccentBlue
AccentPurple
AccentCyan
AccentGreen
AccentYellow
AccentRed
Comment
Gray

Você pode usar códigos hexadecimais (ex.: #FF0000) ou nomes de cores CSS padrão (ex.: coral, teal, blue) para qualquer valor de cor. Consulte nomes de cores CSS para uma lista completa de nomes suportados.

Você pode definir vários temas personalizados adicionando mais entradas ao objeto customThemes.

Carregando Temas de um Arquivo

Além de definir temas personalizados em settings.json, você também pode carregar um tema diretamente de um arquivo JSON especificando o caminho do arquivo no seu settings.json. Isso é útil para compartilhar temas ou mantê-los separados da sua configuração principal.

Para carregar um tema de um arquivo, defina a propriedade ui.theme no seu settings.json para o caminho do seu arquivo de tema:


{
  "ui": {
    "theme": "/caminho/para/seu/tema.json"
  }
}

O arquivo de tema deve ser um arquivo JSON válido que siga a mesma estrutura de um tema personalizado definido em settings.json.

Exemplo my-theme.json:


{
  "name": "My File Theme",
  "type": "custom",
  "Background": "#282A36",
  "Foreground": "#F8F8F2",
  "LightBlue": "#82AAFF",
  "AccentBlue": "#61AFEF",
  "AccentPurple": "#BD93F9",
  "AccentCyan": "#8BE9FD",
  "AccentGreen": "#50FA7B",
  "AccentYellow": "#F1FA8C",
  "AccentRed": "#FF5555",
  "Comment": "#6272A4",
  "Gray": "#ABB2BF",
  "DiffAdded": "#A6E3A1",
  "DiffRemoved": "#F38BA8",
  "DiffModified": "#89B4FA",
  "GradientColors": ["#4796E4", "#847ACE", "#C3677F"]
}

Nota de Segurança: Para sua segurança, o Qwen Code só carregará arquivos de tema que estejam localizados dentro do seu diretório home. Se você tentar carregar um tema de fora do seu diretório home, um aviso será exibido e o tema não será carregado. Isso é para evitar o carregamento de arquivos de tema potencialmente maliciosos de fontes não confiáveis.

Exemplo de Tema Personalizado

Usando seu Tema Personalizado

Selecione seu tema personalizado usando o comando /theme no Qwen Code. Seu tema personalizado aparecerá no diálogo de seleção de tema.
Ou defina-o como padrão adicionando "theme": "MyCustomTheme" ao objeto ui no seu settings.json.
Temas personalizados podem ser definidos nos níveis de usuário, projeto ou sistema, e seguem a mesma precedência de configuração que outras configurações.

Prévia dos Temas

Tema Escuro	Prévia	Tema Claro	Prévia
ANSI		ANSI Light
Atom OneDark		Ayu Light
Ayu		Default Light
Default		GitHub Light
Dracula		Google Code
GitHub		Xcode