Русский
Документация
Темы

Темы

Выберите встроенную тему или определите свою собственную.

С OpenCode вы можете выбрать одну из нескольких встроенных тем, использовать тему, которая адаптируется к теме вашего терминала, или определить свою собственную пользовательскую тему.

По умолчанию OpenCode использует нашу собственную тему opencode.


Требования к терминалу

Чтобы темы отображались корректно со всей цветовой палитрой, ваш терминал должен поддерживать truecolor (24-битный цвет). Большинство современных терминалов поддерживают это по умолчанию, но вам может потребоваться включить его:

  • Проверка поддержки: выполните echo $COLORTERM — он должен вывести truecolor или 24bit
  • Включение truecolor: установите переменную окружения COLORTERM=truecolor в профиле вашей оболочки
  • Совместимость терминала: убедитесь, что эмулятор вашего терминала поддерживает 24-битный цвет (большинство современных терминалов, таких как iTerm2, Alacritty, Kitty, Windows Terminal и недавние версии GNOME Terminal, поддерживают)

Без поддержки truecolor темы могут отображаться с пониженной точностью цвета или откатываться к ближайшему приближению из 256 цветов.


Встроенные темы

OpenCode поставляется с несколькими встроенными темами.

НазваниеОписание
systemАдаптируется к цвету фона вашего терминала
tokyonightНа основе темы Tokyonight (opens in a new tab)
everforestНа основе темы Everforest (opens in a new tab)
ayuНа основе тёмной темы Ayu (opens in a new tab)
catppuccinНа основе темы Catppuccin (opens in a new tab)
catppuccin-macchiatoНа основе темы Catppuccin (opens in a new tab)
gruvboxНа основе темы Gruvbox (opens in a new tab)
kanagawaНа основе темы Kanagawa (opens in a new tab)
nordНа основе темы Nord (opens in a new tab)
matrixХакерская тема: зелёное на чёрном
one-darkНа основе тёмной темы Atom One (opens in a new tab)

И другие — мы постоянно добавляем новые темы.


Системная тема

Тема system спроектирована так, чтобы автоматически адаптироваться к цветовой схеме вашего терминала. В отличие от традиционных тем, использующих фиксированные цвета, тема system:

  • Генерирует шкалу серого: создаёт пользовательскую шкалу серого на основе цвета фона вашего терминала, обеспечивая оптимальный контраст.
  • Использует ANSI-цвета: задействует стандартные ANSI-цвета (0-15) для подсветки синтаксиса и элементов интерфейса, которые учитывают цветовую палитру вашего терминала.
  • Сохраняет значения по умолчанию терминала: использует none для цветов текста и фона, чтобы сохранить нативный внешний вид вашего терминала.

Системная тема предназначена для пользователей, которые:

  • Хотят, чтобы OpenCode соответствовал внешнему виду их терминала
  • Используют пользовательские цветовые схемы терминала
  • Предпочитают единообразный вид во всех терминальных приложениях

Использование темы

Вы можете выбрать тему, вызвав селектор тем командой /theme. Или вы можете указать её в tui.json.

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

Пользовательские темы

OpenCode поддерживает гибкую систему тем на основе JSON, которая позволяет пользователям легко создавать и настраивать темы.


Иерархия

Темы загружаются из нескольких каталогов в следующем порядке, где более поздние каталоги переопределяют более ранние:

  1. Встроенные темы — они встроены в бинарный файл
  2. Каталог пользовательской конфигурации — определены в ~/.config/opencode/themes/*.json или $XDG_CONFIG_HOME/opencode/themes/*.json
  3. Корневой каталог проекта — определены в <project-root>/.opencode/themes/*.json
  4. Текущий рабочий каталог — определены в ./.opencode/themes/*.json

Если несколько каталогов содержат тему с одинаковым именем, будет использоваться тема из каталога с более высоким приоритетом.


Создание темы

Чтобы создать пользовательскую тему, создайте JSON-файл в одном из каталогов тем.

Для тем уровня пользователя:

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

И для тем уровня проекта.

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

Формат JSON

Темы используют гибкий формат JSON с поддержкой:

  • Hex-цветов: "#ffffff"
  • ANSI-цветов: 3 (0-255)
  • Ссылок на цвета: "primary" или пользовательские определения
  • Тёмных/светлых вариантов: {"dark": "#000", "light": "#fff"}
  • Без цвета: "none" — использует цвет по умолчанию терминала или прозрачность

Определения цветов

Раздел defs необязателен и позволяет определять переиспользуемые цвета, на которые можно ссылаться в теме.


Значения по умолчанию терминала

Специальное значение "none" можно использовать для любого цвета, чтобы унаследовать цвет по умолчанию терминала. Это особенно полезно для создания тем, которые бесшовно сочетаются с цветовой схемой вашего терминала:

  • "text": "none" — использует цвет переднего плана по умолчанию терминала
  • "background": "none" — использует цвет фона по умолчанию терминала

Пример

Вот пример пользовательской темы:

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"
    }
  }
}