--- title: "Настройки" id: "346" type: "page" slug: "settings" published_at: "2026-05-19T11:30:45+00:00" modified_at: "2026-07-06T11:59:32+00:00" url: "https://pastukhov.com/agent/docs/settings" markdown_url: "https://pastukhov.com/agent/docs/settings.md" excerpt: "Настройте Pastukhov Agent через диалог настроек. Откройте его, выбрав «Настройки» в главном меню. Настройки организованы…" --- # Настройки [https://pastukhov.com/agent/docs/settings.md](https://pastukhov.com/agent/docs/settings.md) Настройте Pastukhov Agent через диалог настроек. Откройте его, выбрав «Настройки» в главном меню. Настройки организованы в секции-аккордеоны, изменения сохраняются автоматически. ![Диалог настроек Pastukhov Agent с секциями-аккордеонами: Оформление, Чат, Звук, Распознавание речи, Теги, Хуки и Буфер обмена](https://pastukhov.com/wp-content/uploads/2026/06/settings-dialog.png) ## Оформление Секция «Оформление» позволяет управлять визуальной темой Pastukhov Agent. Переключайтесь между светлой и тёмной темой по предпочтению или условиям работы. Также можно переключать тему напрямую из заголовка с помощью кнопки переключения темы. ![Секция Оформление в диалоге настроек Pastukhov Agent](https://pastukhov.com/wp-content/uploads/2026/06/settings-appearance.png) В этой секции также есть переключатель «Показать информацию о лицензии» для отображения или скрытия строки лицензии внизу панели статуса. Ползунок **Размер шрифта чата** позволяет выбрать размер текста в чате в диапазоне от 8 до 24px (по умолчанию 14px). Под ползунком отображается живой предпросмотр текста с выбранным размером. Изменение применяется мгновенно без перезагрузки страницы и сохраняется на сервере. В компактном режиме используется на шаг меньше для экономии места. Размер шрифта влияет на все элементы чата — сообщения AI, текст рассуждений, очередь сообщений и поле ввода. ## Чат Секция «Чат» содержит переключатели и опции, управляющие отображением чат-разговоров: ![Секция Чат в диалоге настроек Pastukhov Agent](https://pastukhov.com/wp-content/uploads/2026/06/settings-chat.png) - **Двойной Enter для отправки** — При включении двойное нажатие Enter отправляет сообщение вместо одиночного. Это позволяет составлять многострочные сообщения без удержания Shift. - **Компактный режим** — Уменьшает расстояние между сообщениями для более плотной раскладки, полезно для длинных разговоров. - **Показать список задач** — Отображает список задач AI (созданный через TodoWrite) в разговоре. - **Показать источник сообщения** — Показывает кнопку «Просмотр сырого JSON» в заголовках сообщений. Нажатие отображает фактический JSON сообщения, полезно для отладки. - **Показать токены сообщения** — Отображает количество токенов и цены рядом с сообщениями, показывая потребление и стоимость каждого. - **Показать контекст сообщения** — Показывает индикатор использования контекста на отдельных сообщениях. Нажатие раскрывает график использования контекста (скрыт в компактном режиме). - **Показать контекст чата** — Показывает индикатор использования контекста вверху панели ввода. Нажатие раскрывает график использования контекста. - **Показать системные сообщения** — Отображает системные сообщения (обновления статуса, уведомления об использовании инструментов) в разговоре. В основном полезно для отладки — добавляет много шума. В секции также есть выпадающий список **Подсветка кода** с десятками тем подсветки синтаксиса (например, GitHub, GitHub Dark, Nord, Monokai, Night Owl, Tokyo Night) для отображаемых блоков кода в сообщениях. ## Звук Секция «Звук» обеспечивает детальный контроль над звуковыми уведомлениями в Pastukhov Agent. Вверху два переключателя: ![Секция Звук в диалоге настроек Pastukhov Agent](https://pastukhov.com/wp-content/uploads/2026/06/settings-sound.png) - **Звук вкл/выкл** — Главный переключатель для включения или отключения всех звуков. - **Конфетти вкл** — При включении анимация конфетти воспроизводится при определённых событиях (например, git-коммиты). Ниже переключателей каждый тип звука имеет свой ползунок громкости и кнопку тестирования: - **Общая громкость** — Общий ползунок громкости, влияющий на все звуки. - **Сообщение** — Воспроизводится при поступлении нового ответа AI в разговор. - **Уведомление** — Воспроизводится когда AI завершает обработку и ожидает ввода пользователя (AskUserQuestion). - **Завершение** — Воспроизводится когда AI завершает обработку обычного ответа и когда фоновые скрипты завершают выполнение. - **Ошибка** — Воспроизводится при получении события ошибки сервера. - **Коммит** — Воспроизводится при создании git-коммита. Запускает анимацию конфетти если включён переключатель конфетти. - **Развёртывание** — Воспроизводится при запуске или перезапуске развёртывания. Каждый звук имеет свой ползунок громкости, поэтому можно настроить какие события слышны и на каком уровне. Любой встроенный звук можно заменить, поместив MP3-файл с тем же именем в папку `.pastukhov/sounds/` вашего проекта (например, `message.mp3`, `complete.mp3`, `error.mp3`, `notification.mp3`, `commit.mp3`, `deploy.mp3`). Пользовательские звуки имеют приоритет над встроенными. ## Распознавание речи Pastukhov Agent включает возможности распознавания речи на основе модели Whisper от OpenAI. Модель работает полностью на стороне сервера и автоматически загружается при первом включении этой опции — не требуется сторонний API или дополнительные расходы. Единственный компромисс — небольшая задержка при первой загрузке модели. Перед использованием голосового ввода необходимо настроить параметры распознавания речи. ![Секция Распознавание речи в диалоге настроек Pastukhov Agent](https://pastukhov.com/wp-content/uploads/2026/06/settings-speech-recognition.png) - **Включить распознавание речи** — Главный переключатель. При включении кнопка микрофона появляется в области ввода сообщений. - **Модель Whisper** — Выбор модели Whisper для транскрипции. Доступно шесть моделей: Tiny (39M), Base (74M), Small (244M, по умолчанию), Medium (769M), Large (1.5GB) и Turbo (809M). Большие модели точнее, но медленнее и требуют больше памяти. - **Язык** — Выбор основного языка из списка 31 поддерживаемого языка. Улучшает точность при выключенном автоопределении. - **Автоопределение языка** — При включении язык определяется автоматически вместо фиксированного выбора. После настройки нажмите кнопку микрофона в области ввода для диктовки сообщений. Аудио обрабатывается полностью на сервере — данные не отправляются на внешние сервисы. **Примечание:** При первом использовании распознавания речи может потребоваться предоставить Pastukhov Agent доступ к микрофону. ## Теги Теги используются для маркировки и категоризации карточек на [канбан-доске](/agent/docs/kanban-board) . Каждый тег имеет имя, цвет фона и цвет текста, что позволяет легко визуально различать типы карточек. ![Секция Теги в диалоге настроек Pastukhov Agent](https://pastukhov.com/wp-content/uploads/2026/06/settings-tags.png) - **Добавить тег** — Нажмите «Добавить тег» для создания нового тега. Задайте имя, выберите цвета фона и текста. - **Редактировать теги** — Измените цвет фона или текста любого существующего тега с помощью встроенных цветовых палитр. - **Удалить тег** — Удалите отдельные теги, которые больше не нужны. - **Сброс** — Восстановить исходные теги по умолчанию (bug, done, tweak, feature, idea, sent). Удаляет все пользовательские теги. Теги хранятся на сервере и синхронизируются между всеми клиентами. Изменения применяются мгновенно через SignalR. ## Хуки Секция «Хуки» управляет ограничениями инструментов и поведенческими правилами, применяемыми во время разговоров с AI. Хуки определяются в `hooks.yaml` и делятся на две категории: **PreToolUse** (правила, оцениваемые перед использованием инструмента) и **UserPromptSubmit** (правила, оцениваемые при отправке промпта пользователем). ![Секция Хуки в диалоге настроек Pastukhov Agent](https://pastukhov.com/wp-content/uploads/2026/06/settings-hooks.png) Здесь предоставляются высокоуровневые элементы управления: - **Включить хуки** — Главный переключатель для активации или деактивации всех правил хуков. При отключении все инструменты разрешены без ограничений. Полезно для отладки, но следует включить в продакшене для безопасности. - **Принудительные ответы ассистента на английском** — При включении Claude Code принудительно отвечает на английском через скрытые промпты. Если модель не следует правилу, она перезапускается с напоминанием. - **Суффикс пользовательского промпта** — Текстовая строка, автоматически добавляемая ко всем вашим сообщениям. Используется для принудительного определённого поведения модели (например, принуждение к английскому работает таким образом). Для детальной настройки хуков (определение правил запрета/выполнения, матчеров и специфичных ограничений инструментов) используйте диалог хуков, доступный из интерфейса чата. Подробнее см. в документации [Хуки](/agent/docs/hooks) . ## Telegram Секция «Telegram» управляет интеграцией с ботом Telegram, позволяя взаимодействовать с Pastukhov Agent через Telegram-чат. Подробная документация доступна на странице [Telegram Bot](/agent/docs/telegram) . - **Включить бота Telegram** — Главный переключатель для активации или деактивации интеграции с ботом. При включении отображаются остальные настройки. - **Показывать вызовы инструментов** — При включении отправляет сообщения о прогрессе вызовов инструментов (Bash, Read, Write и т.д.) в Telegram-чат с индикаторами ⏳/✅/❌. - **Показывать рассуждения** — При включении отправляет сообщения с рассуждениями модели (thinking) в Telegram-чат курсивом. - **Токен бота** — Токен вашего Telegram-бота, полученный у `@BotFather`. Поддерживается подстановка переменных окружения через префикс `$` (например, `$TELEGRAM_BOT_TOKEN`). - **Веб-URL** — Базовый URL для генерации кликабельных ссылок на чаты в Telegram (например, `https://code.example.com`). - **Разрешённые ID пользователей** — Список Telegram user ID через запятую. Пустое поле блокирует доступ для всех. Неавторизованные пользователи получают сообщение с инструкцией для администратора. Под переключателями отображается индикатор состояния подключения: зелёная точка — подключён с именем бота, красная — отключён или ошибка. Настройки бота также можно задать вручную через файл `.pastukhov/telegram.yml`. ## Прокси Встроенный прокси-сервер перехватывает трафик между Claude Code CLI и AI-провайдерами для логгирования, конвертации протоколов и подсчёта токенов. Прокси настраивается через переменные окружения в конфигурации [окружений](/agent/docs/environments) . Подробнее см. [Прокси-сервер](/agent/docs/proxy) . - **AGENT_PROXY_TYPE** — тип прокси: `anthropic` (проброс), `openai` (конвертация в OpenAI-формат), `deepseek` (полная трансформация), `anthropicdeepseek` (через OpenRouter), `direct` (без прокси) - **ANTHROPIC_BASE_URL** — базовый URL upstream API-провайдера - **HTTP_PROXY / HTTPS_PROXY** — исходящий HTTP-прокси для запросов к upstream При значении `direct` прокси полностью отключается. Для всех остальных типов Claude Code CLI автоматически перенаправляется через прокси. Все типы токенов (prompt, completion, cache_read, cache_write) учитываются при расчёте стоимости. Логи хранятся в отдельной SQLite-базе с 30-дневным автоудалением. ## Буфер обмена Секция «Буфер обмена» управляет обработкой изображений и файлов из буфера обмена при вставке в поле ввода чата: ![Секция Буфер обмена в диалоге настроек Pastukhov Agent](https://pastukhov.com/wp-content/uploads/2026/06/settings-clipboard.png) - **Вставка изображений** — Переключатель, разрешающий или запрещающий вставку изображений из буфера обмена. - **Путь для изображений** — Относительный путь для сохранения вставленных изображений в проекте (по умолчанию: `assets/images`). - **Вставка файлов** — Переключатель, разрешающий или запрещающий вставку файлов из буфера обмена. - **Путь для файлов** — Относительный путь для сохранения вставленных файлов в проекте (по умолчанию: `assets/files`). - **Ограничение размера файла (МБ)** — Максимальный размер файла для операций вставки из буфера (по умолчанию: 100 МБ). **← Назад:** [Git](/agent/docs/git) **Далее:** [MCP-серверы](/agent/docs/mcp-servers) →