# Настройки и первый запуск

> Знакомство при первом запуске Buff Code, язык и тема, размер шрифта, вкладки, горячие клавиши, прокси и сертификат организации, уведомления.

Настройки открываются **Ctrl+,** (на macOS — ⌘,) или из колонки слева. Повторное Ctrl+, или Esc
закрывает их; при следующем открытии вы попадёте на ту же вкладку.

## Первый запуск

При первом запуске окно проводит знакомство из трёх шагов. Любой шаг можно пропустить, но
каждый выбор что-то меняет:

1. **Чем вы занимаетесь** — с какого [режима](/docs/buff-code/work/session#режимы-разрешений)
   начинать новые сессии: «Разработка» → «Править сам»; «Вопросы и разбор кода» → «Спрашивать»
   и [«План»](/docs/buff-code/work/plan-goal#план); «Документы и знания» → «Спрашивать».
2. **Тема и размер текста** — как в системе, светлая или тёмная, и размер текста; меняется сразу.
3. **Что включить** — память проекта (`AGENTS.md`) и проверку хуков и команд проекта (см.
   [доверие](/docs/buff-code/work/extensions#доверие-к-хукам-и-командам-проекта)).

В конце — «Войти в Buff», если входа ещё нет; «Позже» оставляет окно без модели, и над полем ввода
будет напоминание «Нет модели — войдите в Buff». Пройти знакомство заново — «Настройки →
Основные → Пройти заново» или Ctrl+Shift+H. Как войти и выбрать проект — [Вход и рабочий
контекст](/docs/buff-code/sign-in).

_Иллюстрация: Первый шаг знакомства: от рода занятий зависит, сколько Buff Code делает сам._

## Основные

- **Язык** — русский или английский. Окно меняет язык сразу; консоль и `buff run` берут тот же
  язык и подхватывают смену на лету. По умолчанию — русский.
- **Где начинать сессии**, **автоматически принимать разрешения**, **продолжение во время хода**
  («направлять» текущий ход или ставить в очередь; Ctrl+Enter переключает) — поведение по умолчанию.
- **Подробность ленты** — компактно (работа сгруппирована, подробности свёрнуты) или расширенно.
- **Знакомство с Buff Code** — «Пройти заново»; сочетание Ctrl+Shift+H.
- **Сеть** (только в окне):
  - **прокси-сервер**, логин и пароль (пароль хранится зашифрованным средствами системы);
  - **без прокси** — адреса и маски через запятую; своя машина всегда напрямую;
  - **сертификат организации** — файл `.pem`, если прокси компании подменяет сертификаты.

  Прокси действует на всё приложение и применяется после перезапуска — после сохранения окно
  предложит «Перезапустить сейчас». Пусто — прокси из системы.

## Внешний вид

- **Цветовая схема** — как в системе, светлая, тёмная.
- **Шрифты** — интерфейса, кода и терминала.
- **Размер шрифта** — интерфейса (12–20) и кода (10–24: файлы, изменения, блоки кода в ответах,
  терминал), с живым образцом; «Размеры по умолчанию» возвращает всё как было.
- **Вкладки** — вертикальные (колонка слева со списком сессий, по умолчанию) или горизонтальные
  сверху.

## Горячие клавиши

Список всех команд окна с их сочетаниями.

- Щёлкните сочетание и нажмите новое. Сочетание без Ctrl, Alt или Shift не принимается — причина
  написана прямо в строке (клавиши F1–F24 можно и без модификатора).
- Если сочетание занято, окно спросит: «Сочетание занято: Ctrl+P уже у … Переназначить?» —
  у другой команды оно снимется только после «да».
- **«Найти по сочетанию»** в шапке: нажмите сочетание — в списке останутся команды с ним.
- **Сброс всех сочетаний** — после подтверждения.

Самые нужные по умолчанию:

| Сочетание | Что делает |
| --- | --- |
| Ctrl+, | открыть или закрыть настройки |
| Ctrl+K | палитра команд |
| Ctrl+P | открыть файл проекта |
| Ctrl+F | поиск сессий |
| Ctrl+Alt+F | поиск по переписке |
| Ctrl+T | новая сессия |
| Ctrl+U | прикрепить картинки и файлы |
| Ctrl+B | перевести выполняемую команду в фон |
| Ctrl+Shift+R | показать или скрыть изменения |

На macOS вместо Ctrl — ⌘ (кроме Ctrl+B). Полный список с поиском — в самом разделе.

_Иллюстрация: Горячие клавиши: команды по группам; у повторов — «ещё у: …»._

## Провайдеры

«Настройки → Провайдеры» — вход в Buff и модели организации: строка **Buff · Вход через
коннектор · ваш логин · организация** и «Отключить». Если организаций у вас ещё нет, окно так и
скажет и подскажет попросить администратора. Подробно — [Вход и рабочий
контекст](/docs/buff-code/sign-in), [Модели и расход](/docs/buff-code/models).

## Расширения

MCP-серверы, навыки, команды, субагенты, память и хуки — на отдельной странице:
[Расширения](/docs/buff-code/work/extensions).

## В консоли

| Что | Как |
| --- | --- |
| настройки | `/settings` |
| язык | тот же, что в окне; без окна — по умолчанию русский |
| тема | `/themes`; светлая или тёмная — по терминалу или `theme.mode` в `~/.config/buff/cli.json` |
| сочетания клавиш | `/help` — список; свои — `keybinds` в `~/.config/buff/cli.json` |