Настройки

Откройте настройки пунктом Настройки в меню аккаунта (щёлкните по адресу электронной почты внизу боковой панели) или пунктом главного меню Файл → Настройки… (в macOS — Астра ИИ [Код] → Настройки…). Сочетание клавиш — Ctrl+Shift+P в Windows и Linux, Cmd+, в macOS. Кнопка К работе внизу списка разделов закрывает настройки.

Внешний вид

В блоке Тема выберите Системная, Светлая или Темная, в блоке Акцент — цвет акцента. Строку окна с меню приложение рисует в цветах выбранной темы, кнопки окна ОС лежат поверх неё.

В блоке Фон окна выберите фон:

• Нет — фон окна по выбранной теме, без изображения;
• один из шести готовых фонов — пять цветных градиентов и снимок «Ледниковый»; название фона показывает подсказка при наведении указателя;
• Свой… — своё изображение: PNG или JPEG размером до 20 МиБ.

Когда выбран любой фон, кроме Нет, появляются дополнительные настройки:

• Яркие обои — фон без приглушения; панели при этом становятся плотнее, чтобы текст читался;
• Приглушение фона — от 60% до 100%; доступно, когда Яркие обои выключены;
• Размытие фона — от 0 до 40 пикс.

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

В блоке Плотность выберите Обычная или Компактная: в компактном виде на экране помещается больше строк.

Блок Боковая панель задаёт её поведение — одинаковое в режимах Код и Чат:

• Автоматически — панель сворачивается после отправки запроса; выбор проекта или сессии её не сворачивает. Кнопка ◧ (Развернуть панель) в левом верхнем углу окна раскрывает панель до следующего запроса.
• Всегда свернута — панель всегда свёрнута; кнопка ◧ (Развернуть панель) открывает её поверх рабочей области.

Ниже настраиваются:

• Карточки сессий — переключатели Показывать модель (модель и время последней активности), Показывать ветку (Git-ветка сессии) и Показывать статус текстом (состояние сессии словами: Работает, Ждет ответа или Готово);
• Стиль общения для новых сессий — Стандартный, Дружелюбный или Деловой; тот же выбор предлагает мастер первого запуска, а стиль текущей сессии меняет команда /personality;
• Прокрутка — Чувствительность от 5% до 300%.

В блоке Интерфейс:

• Уменьшить движение — отключает анимацию появления, переходов и смены текста;
• Сворачивать длинный код — длинные изменения в файлах показываются свёрнутыми, их можно развернуть;
• Уведомления системы — уведомления ОС, когда окно приложения неактивно. При включении раскрываются переключатели Ход завершен и Нужно подтверждение. Уведомления также должны быть разрешены в настройках ОС;
• Предупреждать перед улучшением запроса — запрос подтверждения перед тем, как кнопка Улучшить запрос перепишет текст в поле ввода.

Модели и провайдеры

Выберите Модель по умолчанию для новых сессий. В списке — модели, которые АСТРА ИИ [ХАБ] разрешает вашей учётной записи для работы агента в сессиях. Модель текущей сессии меняется у поля ввода; выбор модели и ограничения описаны в разделе «Модели, контекст и память».

Если список пуст, проверьте вход в разделе Настройки → Аккаунт и обратитесь к администратору АСТРА ИИ [ХАБ] в вашей организации.

Приватность

Раздел содержит настройки памяти агента: Использовать память, Создавать память и Очистить память (кнопка Очистить…). Как работает память и чем она отличается от контекста, описано в разделе «Модели, контекст и память».

Аккаунт

Блок Аккаунт АСТРА ИИ [ХАБ] показывает адрес электронной почты, состояние подключения и кнопку Выйти. Строка Сервер показывает адрес сервера АСТРА ИИ [ХАБ] с пометкой «стандартный» или «задан в настройках системы»; кнопка Настройки подключения открывает форму Подключение к АСТРА ИИ [ХАБ], для этого приложение выходит из аккаунта. Если адрес задан в настройках системы (переменными окружения), кнопка недоступна. Вход, выход и смена сервера описаны в разделе «Вход и аккаунт АСТРА ИИ [ХАБ]».

Кнопка Пройти заново в строке Пройти настройку заново снова открывает мастер первого запуска (см. раздел «Первоначальная настройка»). Аккаунт, проекты и история сохраняются.

Ядро и диагностика

Блоки Права для новых сессий (Чтение, Правки или Полный доступ) и Подтверждения для новых сессий (С подтверждением или Без подтверждений) задают права, с которыми начинаются новые сессии в проекте и в чате. Права текущей сессии меняются в меню режима у поля ввода или командой /permissions; см. раздел «Права и подтверждения».

Ниже показаны:

• в группе Ядро поле Путь к ядру — путь к файлу ядра или папке с ним, с кнопками Сохранить и Сбросить. Пустое поле (подсказка «Не указан: встроенное ядро») означает встроенное ядро. Меняйте путь только по сообщению приложения или инструкции поддержки;
• строка Сервер — состояние ядра и путь к его файлу, с кнопками Запустить и Остановить; при ошибке ниже показана строка Ошибка запуска;
• строка .astracode — путь к файлу настроек ядра config.toml;
• строка Текущий провайдер — поставщик моделей, с которым работает ядро.

Блок Конфигурация раскрывает итоговые настройки ядра только для просмотра, блок Диагностика — сведения о песочнице, подключении к модели и последние строки вывода ядра; в Windows блок предупреждает, что ядро не изолирует команды агента. В блоке Для поддержки — те же кнопки отчёта, что в разделе О программе, и переключатель Подробный журнал: он добавляет в журнал внутренние события агентов, включайте его по просьбе поддержки. Как сообщить об ошибке, описано в разделе «Диагностика и поддержка».

Субагенты

Роль задаёт назначение, инструкции и модель субагента. Роли хранятся в настройках ядра и доступны также в консольной версии ядра. Сохранение роли субагента не запускает; пример поручения описан в разделе «Цели и субагенты».

Чтобы создать роль:

1. Нажмите Создать роль.
2. Введите Имя роли: латинские буквы, цифры, дефис и подчёркивание; первый символ — буква или цифра. Имя роли служит именем её файла. Имена default, explorer и worker заняты: встроенные роли — explorer и coder (в файлах настроек — worker).
3. Заполните Назначение — эту строку видит модель, когда выбирает, кому поручить работу, — и Инструкции.
4. При необходимости заполните Прозвища — через запятую имена, которые ядро даёт запущенным субагентам этой роли. Допустимы латинские буквы, цифры, пробел, дефис и подчёркивание: роль с другими символами ядро не загрузит, поэтому форма её не сохранит.
5. Выберите Модель: пустое значение — Модель сессии. Доступны только модели вашей учётной записи АСТРА ИИ [ХАБ].
6. Нажмите Сохранить.

В списке ролей:

• Системные роли — встроенные coder и explorer; кнопка Изменить назначает им модель, если её не задал проект.
• Пользовательские роли — ваши роли с кнопками Изменить и Удалить…. Роль, файл которой ядро не принимает, показана с меткой только вручную и причиной; такую роль можно удалить или исправить в её файле.
• Роли проекта — из папки <проект>/.astracode/agents. Они редактируются в файлах проекта и перекрывают одноимённые пользовательские роли; у перекрытой роли стоит метка перекрыта проектом.

Кнопка Сбросить модели… внизу блока снимает модели у всех пользовательских ролей и общую модель: роли снова работают на модели сессии. Сами роли не меняются. В основной редакции модели встроенных ролей назначает АСТРА ИИ [ХАБ], и сброс их не трогает (вопрос — «Снять модель у пользовательских ролей?»); в локальной редакции сброс снимает модель у всех ролей, включая встроенные (вопрос — «Снять модель у всех ролей?»). Кнопка Обновить перечитывает роли и их модели.

Общая модель — одна модель для всех пользовательских ролей. Её задают вне приложения: в консольной версии ядра или в файле .astracode/config.toml проекта. Если общая модель задана, модели отдельных ролей не действуют, и в разделе показано предупреждение Всем пользовательским ролям назначена одна модель. Кнопка Снять… в предупреждении снимает общую модель, заданную вами; общая модель проекта (метка задана проектом) меняется только в файле проекта.

Если форма показывает ошибку имени или прозвища, исправьте поле. Если модель роли недоступна, выберите другую или Модель сессии. Если роли не загрузились, нажмите Обновить; если ошибка повторяется, проверьте состояние ядра в разделе Настройки → Ядро и диагностика.

MCP и навыки

Серверы MCP

Строка сервера показывает итог запуска: запускаю…, число инструментов, нужен вход или причину ошибки, например не запустился: программа не найдена; подробности — второй строкой. Кнопка Обновить перечитывает настройки серверов. При метке нужен вход нажмите Войти и завершите вход в браузере — список обновится сам. Кнопка Изменить открывает форму сервера, кнопка Удалить… после подтверждения убирает сервер из настроек ядра.

Поля формы, которую открывает кнопка + Добавить сервер:

• Имя сервера — от 1 до 40 символов: латинские буквы, цифры, _ и -;
• способ подключения: Команда — запуск программы на компьютере, Адрес — подключение к серверу по сети;
• Команда запуска — программа и аргументы так же, как в терминале, с кавычками и ~ вместо домашней папки; под полем видно, что станет программой, а что — аргументами;
• Адрес сервера — адрес, начинающийся с http:// или https://.

Переменные окружения форма не принимает: они задаются в файле config.toml ядра. Порядок подключения и пример описаны в разделе «MCP и навыки».

Лаборатория

Блок Лаборатория — экспериментальные функции ядра с описанием, ключом конфигурации и переключателем; этот же блок открывает команда /experimental. Блок показывает только функции, которые действуют в вашей ОС. Если в config.toml включена функция другой ОС, при запуске ядра она выключается, а блок сообщает об этом, например: «Функция «…» выключена и скрыта: на Windows она не действует.»

Установка навыка

Навык — папка с файлом SKILL.md. Выберите источник:

• Из папки — путь в поле Папка навыка или кнопка Выбрать…;
• Из репозитория — адрес Git-репозитория в поле Репозиторий, при необходимости Ветка или тег и Подпапка навыка.

В поле Куда установить выберите Только в текущий проект или Только для текущего пользователя; без открытого проекта доступен только второй вариант. Нажмите Установить. Установка копирует папку целиком; последующие изменения источника на копию не влияют.

Навыки

Список разделён на группы Навыки проекта, Пользовательские, Встроенные и От администратора. Флажок Включен включает и выключает навык, кнопка Удалить удаляет папку навыка с диска (путь показан в окне подтверждения), кнопка Обновить перечитывает список. После включения или выключения начните новую сессию. В поле ввода навык вызывается по имени: $имя_навыка.

Блок Не удалось прочитать перечисляет папки, которые похожи на навыки, но не приняты ядром: проверьте в них файл SKILL.md. Как установить навык и что делать, если он недоступен, описано в разделе «MCP и навыки».

Обучение

Раздел Обучение также открывается из главного меню: Справка → Обучение. В нём собраны карточки с короткими примерами и блок Действия обучения:

• Тур по режиму «Код» и Тур по режиму «Чат» — кнопка Пройти тур показывает главное в режиме; шаги, которые вы уже видели, тур пропускает;
• Тур по настройкам — показывает, где менять оформление, ленту, стиль общения и уведомления;
• Подсказки по ходу работы — включает редкие подсказки о функциях приложения;
• Сбросить обучение — кнопка Сбросить снова включает подсказки и все туры, как при первом запуске. Проекты, история сессий и остальные настройки не меняются.

О программе

В блоке Версии и среда показаны версии приложения и ядра (строка Ядро), канал и дата сборки, файл ядра, среда выполнения и ОС. В строке Отчет для поддержки три кнопки: Сохранить отчет для поддержки… сохраняет ZIP-архив со сводкой, журналами приложения и ядра за 7 дней и настройками без секретов, Скопировать сводку копирует сводку для сообщения в чат, Открыть папку журналов открывает папку журналов приложения. Отчёт остаётся на компьютере. Те же кнопки есть в окне Справка → О программе АСТРА ИИ [КОД]. Подробнее — в разделе «Диагностика и поддержка».

В блоке Обновления строка Состояние показывает статус проверки и доступное действие: Проверить, Скачать или Установить. Порядок установки описан в разделе «Обновление приложения», различия номеров версий — в разделе «Версии приложения и ядра».