Temas

Selecione um tema integrado ou defina o seu próprio.

Com o OpenCode você pode selecionar entre vários temas integrados, usar um tema que se adapta ao tema do seu terminal, ou definir seu próprio tema personalizado.

Por padrão, o OpenCode usa nosso próprio tema opencode.

Requisitos do terminal

Para que os temas sejam exibidos corretamente com sua paleta de cores completa, seu terminal deve suportar truecolor (cor de 24 bits). A maioria dos terminais modernos suporta isso por padrão, mas você pode precisar habilitá-lo:

Verificar suporte: Execute echo $COLORTERM - deve retornar truecolor ou 24bit
Habilitar truecolor: Defina a variável de ambiente COLORTERM=truecolor no seu perfil de shell
Compatibilidade do terminal: Certifique-se de que seu emulador de terminal suporta cor de 24 bits (a maioria dos terminais modernos como iTerm2, Alacritty, Kitty, Windows Terminal e versões recentes do GNOME Terminal suportam)

Sem suporte a truecolor, os temas podem aparecer com precisão de cor reduzida ou recorrer à aproximação de 256 cores mais próxima.

Temas integrados

O OpenCode vem com vários temas integrados.

Nome	Descrição
`system`	Adapta-se à cor de fundo do seu terminal
`tokyonight`	Baseado no tema Tokyonight (opens in a new tab)
`everforest`	Baseado no tema Everforest (opens in a new tab)
`ayu`	Baseado no tema escuro Ayu (opens in a new tab)
`catppuccin`	Baseado no tema Catppuccin (opens in a new tab)
`catppuccin-macchiato`	Baseado no tema Catppuccin (opens in a new tab)
`gruvbox`	Baseado no tema Gruvbox (opens in a new tab)
`kanagawa`	Baseado no tema Kanagawa (opens in a new tab)
`nord`	Baseado no tema Nord (opens in a new tab)
`matrix`	Tema estilo hacker verde sobre preto
`one-dark`	Baseado no tema escuro Atom One (opens in a new tab)

E mais, estamos constantemente adicionando novos temas.

Tema do sistema

O tema system é projetado para se adaptar automaticamente ao esquema de cores do seu terminal. Diferente dos temas tradicionais que usam cores fixas, o tema system:

Gera escala de cinza: Cria uma escala de cinza personalizada baseada na cor de fundo do seu terminal, garantindo contraste ideal.
Usa cores ANSI: Aproveita as cores ANSI padrão (0-15) para destaque de sintaxe e elementos de UI, que respeitam a paleta de cores do seu terminal.
Preserva padrões do terminal: Usa none para cores de texto e fundo para manter a aparência nativa do seu terminal.

O tema do sistema é para usuários que:

Querem que o OpenCode combine com a aparência do seu terminal
Usam esquemas de cores personalizados do terminal
Preferem uma aparência consistente em todas as aplicações do terminal

Usar um tema

Você pode selecionar um tema abrindo o seletor de temas com o comando /theme. Ou você pode especificá-lo na sua configuração.

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "theme": "tokyonight"
}

Temas personalizados

O OpenCode suporta um sistema de temas flexível baseado em JSON que permite aos usuários criar e personalizar temas facilmente.

Hierarquia

Os temas são carregados de múltiplos diretórios na seguinte ordem, onde diretórios posteriores sobrescrevem os anteriores:

Temas integrados - Estes estão embutidos no binário
Diretório de configuração do usuário - Definido em ~/.config/opencode/themes/*.json ou $XDG_CONFIG_HOME/opencode/themes/*.json
Diretório raiz do projeto - Definido em <project-root>/.opencode/themes/*.json
Diretório de trabalho atual - Definido em ./.opencode/themes/*.json

Se múltiplos diretórios contêm um tema com o mesmo nome, o tema do diretório com maior prioridade será usado.

Criar um tema

Para criar um tema personalizado, crie um arquivo JSON em um dos diretórios de temas.

Para temas a nível de usuário:

mkdir -p ~/.config/opencode/themes
vim ~/.config/opencode/themes/my-theme.json

E para temas específicos do projeto.

mkdir -p .opencode/themes
vim .opencode/themes/my-theme.json

Formato JSON

Os temas usam um formato JSON flexível com suporte para:

Cores hex: "#ffffff"
Cores ANSI: 3 (0-255)
Referências de cor: "primary" ou definições personalizadas
Variantes escuro/claro: {"dark": "#000", "light": "#fff"}
Sem cor: "none" - Usa a cor padrão do terminal ou transparente

Definições de cor

A seção defs é opcional e permite definir cores reutilizáveis que podem ser referenciadas no tema.

Padrões do terminal

O valor especial "none" pode ser usado para qualquer cor para herdar a cor padrão do terminal. Isso é particularmente útil para criar temas que se misturam perfeitamente com o esquema de cores do seu terminal:

"text": "none" - Usa a cor de primeiro plano padrão do terminal
"background": "none" - Usa a cor de fundo padrão do terminal

Exemplo

Aqui está um exemplo de um tema personalizado:

my-theme.json

{
  "$schema": "https://opencode.ai/theme.json",
  "defs": {
    "nord0": "#2E3440",
    "nord1": "#3B4252",
    "nord2": "#434C5E",
    "nord3": "#4C566A",
    "nord4": "#D8DEE9",
    "nord5": "#E5E9F0",
    "nord6": "#ECEFF4",
    "nord7": "#8FBCBB",
    "nord8": "#88C0D0",
    "nord9": "#81A1C1",
    "nord10": "#5E81AC",
    "nord11": "#BF616A",
    "nord12": "#D08770",
    "nord13": "#EBCB8B",
    "nord14": "#A3BE8C",
    "nord15": "#B48EAD"
  },
  "theme": {
    "primary": {
      "dark": "nord8",
      "light": "nord10"
    },
    "secondary": {
      "dark": "nord9",
      "light": "nord9"
    },
    "accent": {
      "dark": "nord7",
      "light": "nord7"
    },
    "error": {
      "dark": "nord11",
      "light": "nord11"
    },
    "warning": {
      "dark": "nord12",
      "light": "nord12"
    },
    "success": {
      "dark": "nord14",
      "light": "nord14"
    },
    "info": {
      "dark": "nord8",
      "light": "nord10"
    },
    "text": {
      "dark": "nord4",
      "light": "nord0"
    },
    "textMuted": {
      "dark": "nord3",
      "light": "nord1"
    },
    "background": {
      "dark": "nord0",
      "light": "nord6"
    },
    "backgroundPanel": {
      "dark": "nord1",
      "light": "nord5"
    },
    "backgroundElement": {
      "dark": "nord1",
      "light": "nord4"
    },
    "border": {
      "dark": "nord2",
      "light": "nord3"
    },
    "borderActive": {
      "dark": "nord3",
      "light": "nord2"
    },
    "borderSubtle": {
      "dark": "nord2",
      "light": "nord3"
    },
    "diffAdded": {
      "dark": "nord14",
      "light": "nord14"
    },
    "diffRemoved": {
      "dark": "nord11",
      "light": "nord11"
    },
    "diffContext": {
      "dark": "nord3",
      "light": "nord3"
    },
    "diffHunkHeader": {
      "dark": "nord3",
      "light": "nord3"
    },
    "diffHighlightAdded": {
      "dark": "nord14",
      "light": "nord14"
    },
    "diffHighlightRemoved": {
      "dark": "nord11",
      "light": "nord11"
    },
    "diffAddedBg": {
      "dark": "#3B4252",
      "light": "#E5E9F0"
    },
    "diffRemovedBg": {
      "dark": "#3B4252",
      "light": "#E5E9F0"
    },
    "diffContextBg": {
      "dark": "nord1",
      "light": "nord5"
    },
    "diffLineNumber": {
      "dark": "nord2",
      "light": "nord4"
    },
    "diffAddedLineNumberBg": {
      "dark": "#3B4252",
      "light": "#E5E9F0"
    },
    "diffRemovedLineNumberBg": {
      "dark": "#3B4252",
      "light": "#E5E9F0"
    },
    "markdownText": {
      "dark": "nord4",
      "light": "nord0"
    },
    "markdownHeading": {
      "dark": "nord8",
      "light": "nord10"
    },
    "markdownLink": {
      "dark": "nord9",
      "light": "nord9"
    },
    "markdownLinkText": {
      "dark": "nord7",
      "light": "nord7"
    },
    "markdownCode": {
      "dark": "nord14",
      "light": "nord14"
    },
    "markdownBlockQuote": {
      "dark": "nord3",
      "light": "nord3"
    },
    "markdownEmph": {
      "dark": "nord12",
      "light": "nord12"
    },
    "markdownStrong": {
      "dark": "nord13",
      "light": "nord13"
    },
    "markdownHorizontalRule": {
      "dark": "nord3",
      "light": "nord3"
    },
    "markdownListItem": {
      "dark": "nord8",
      "light": "nord10"
    },
    "markdownListEnumeration": {
      "dark": "nord7",
      "light": "nord7"
    },
    "markdownImage": {
      "dark": "nord9",
      "light": "nord9"
    },
    "markdownImageText": {
      "dark": "nord7",
      "light": "nord7"
    },
    "markdownCodeBlock": {
      "dark": "nord4",
      "light": "nord0"
    },
    "syntaxComment": {
      "dark": "nord3",
      "light": "nord3"
    },
    "syntaxKeyword": {
      "dark": "nord9",
      "light": "nord9"
    },
    "syntaxFunction": {
      "dark": "nord8",
      "light": "nord8"
    },
    "syntaxVariable": {
      "dark": "nord7",
      "light": "nord7"
    },
    "syntaxString": {
      "dark": "nord14",
      "light": "nord14"
    },
    "syntaxNumber": {
      "dark": "nord15",
      "light": "nord15"
    },
    "syntaxType": {
      "dark": "nord7",
      "light": "nord7"
    },
    "syntaxOperator": {
      "dark": "nord9",
      "light": "nord9"
    },
    "syntaxPunctuation": {
      "dark": "nord4",
      "light": "nord0"
    }
  }
}

Modelos Atalhos de Teclado