---
title: "Начало работы"
id: "341"
type: "page"
slug: "getting-started"
published_at: "2026-05-19T11:30:44+00:00"
modified_at: "2026-10-04T02:07:52+00:00"
url: "https://pastukhov.com/agents/agent/docs/getting-started"
markdown_url: "https://pastukhov.com/agents/agent/docs/getting-started.md"
excerpt: "Pastukhov Agent — это личный ИИ-помощник, который работает над вашим проектом на компьютере или сервере:…"
---

# Начало работы

[https://pastukhov.com/agents/agent/docs/getting-started.md](https://pastukhov.com/agents/agent/docs/getting-started.md)

Pastukhov Agent — это личный ИИ-помощник, который работает над вашим проектом на компьютере или сервере: читает и изменяет файлы, выполняет команды, следит за качеством кода и ведёт с вами обычный чат. Он пригодится и разработчику, и владельцу бизнеса, который хочет самостоятельно вносить изменения в свой проект. Эта страница — с чего начать.

Сначала выберите способ установки — каждый удобен по-своему:

- **Установка через Docker***(рекомендуется)* — Docker — это технология «контейнеров»: приложение запускается в изолированной среде, где уже есть все необходимые инструменты. Работает на Linux, macOS и Windows. Контейнер полностью отделён от остальной системы: агент не сможет случайно повредить ваш компьютер, а «сломанный» контейнер воссоздаётся за секунды. [Инструкция по установке Docker](/agents/agent/docker)
- **Windows Docker Desktop** — тот же Docker, но с графическим приложением Docker Desktop для Windows (на базе WSL 2). Удобно, если вы привыкли управлять программами мышью, а не командами. [Инструкция по установке Windows Docker Desktop](/agents/agent/windows-docker-desktop)
- **Mac Docker Desktop** — то же самое для macOS (Intel и Apple Silicon): графическое управление Docker с полной изоляцией. [Инструкция по установке Mac Docker Desktop](/agents/agent/mac-docker-desktop)
- **Установка WSL** — Docker на Windows через WSL (подсистема Windows для Linux) без отдельной программы Docker Desktop. Даёт ту же изоляцию и нативную производительность Linux на Windows 10 или 11. [Инструкция по установке WSL](/agents/agent/wsl)
- **Установка Windows** — обычное приложение для Windows 10/11: устанавливается как программа, работает в браузере. Настройки задаются [переменными окружения](/agents/agent/docs/models) или параметрами запуска. [Инструкция по установке Windows](/agents/agent/windows)

**Почему рекомендуем Docker даже на Windows:** ИИ-модели лучше всего работают с Linux-инструментами, которые уже включены в контейнер, — на чистой Windows их пришлось бы устанавливать отдельно. Кроме того, контейнер полностью изолирован: модели не могут повредить основную систему, а среду для конкретной задачи легко пересоздать за секунды.

Любой способ установки даёт всё необходимое для работы. После установки нужно настроить модель и указать API-ключ вашего поставщика ИИ — об этом в разделе [Настройка первой модели](#setting-up-your-first-environment)
 ниже.

## Настройка учётных данных

Учётные данные — это ваш логин и пароль для входа в приложение, как в личный кабинет. Они задаются переменными окружения `AGENT_LOGIN` (логин) и `AGENT_PASSWORD` (пароль). Переменные окружения — это технические параметры запуска: вы прописываете их один раз в настройках (например, в файле docker-compose), и программа применяет их автоматически при каждом запуске.

Если переменные не заданы, приложение само сгенерирует временный пароль (логин — `agent`) и выведет его в консоль — окно, где работает программа. Такие учётные данные действуют до перезапуска приложения — удобно, чтобы просто попробовать программу. Полный список переменных — на странице [Модели](/agents/agent/docs/models)
.

### Установщик Windows

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

### Docker

Задайте `AGENT_LOGIN` и `AGENT_PASSWORD` в файле docker-compose или файле `.env`. Пароль хранится в виде SHA256-хэша — это «отпечаток» пароля, по которому нельзя восстановить исходный текст: даже если файл настроек попадёт не в те руки, пароль останется в безопасности. На странице входа есть встроенный генератор такого отпечатка. Если переменные не заданы, приложение выдаст временные учётные данные в лог контейнера — смотрите их командой `docker logs`. Подробнее — в [инструкции по установке Docker](/agents/agent/docker)
.

### Ручная установка

Можно задать переменные окружения перед запуском, а можно просто запустить приложение и воспользоваться временными учётными данными из консоли. При задании пароля через переменную он должен быть SHA256-хэшем — используйте встроенный генератор на странице входа.

Когда вы входите с временными учётными данными, на странице входа появляется предупреждение. Чтобы сделать их постоянными, задайте [переменные окружения](/agents/agent/docs/models)
 и перезапустите приложение.

После входа вы получаете JWT-токен — «цифровой пропуск»: он поддерживает вашу сессию 90 дней, так что повторно входить каждый раз не придётся.

По умолчанию ключ подписи токенов генерируется автоматически и хранится во временной папке системы — для обычной работы этого достаточно. Для постоянного ключа задайте переменную `JWT_SECRET_KEY` (не менее 32 символов): тогда выданные «пропуски» останутся действительными между перезапусками приложения.

Другие способы доступа — единый вход через сервер (SSO), вход по API-ключу и живые подключения — описаны на странице [Вход и авторизация](/agents/agent/docs/login)
.

## Главный интерфейс

После входа вы видите **список чатов** — главный экран, с которого начинается работа:

- **Список чатов** — здесь собраны все ваши разговоры. У каждого чата — заголовок и время последнего обновления. Если чатов ещё нет, вас встретит заметная кнопка **Новый чат**.
- **Новый чат** — каждая беседа независима и не делится контекстом с другими, поэтому можно работать над несколькими задачами одновременно и нигде не запутаться.
- **Обновления в реальном времени** — список чатов обновляется сам, через технологию SignalR: новые чаты и прогресс работы появляются на экране сразу, страницу перезагружать не нужно.

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

Нажмите на любой чат, чтобы открыть его. Внутри — общение с агентом; подробно об интерфейсе чата — в документации [Чат](/agents/agent/docs/chat)
.

## Демо-проект (Windows)

В установщик Windows входит готовый демо-проект: на нём удобно посмотреть, как агент разрабатывает, собирает, проверяет и исправляет код. При первом запуске приложения вы увидите именно его.

Для установки через Docker или вручную укажите путь к вашему проекту переменной окружения `AGENT_PROJECT_PATH`. Pastukhov Agent работает с любой кодовой базой — просто укажите папку проекта и начинайте чат.

Демо-проект включает **демо-навыки** — готовые инструкции для агента, как выполнять типовые задачи. Они полезны сами по себе и служат шаблонами для ваших собственных навыков. Подробнее — в документации [Навыки](/agents/agent/docs/skills)
.

Pastukhov Agent работает **в режиме одного проекта**: один экземпляр — один проект. Экземпляры полностью изолированы, поэтому можно запускать несколько одновременно — на разных портах и для разных проектов.

## Настройка первой модели

Прежде чем начать чат, нужно создать **модель** — набор настроек, который говорит агенту, какую нейросеть использовать и как к ней подключиться. Минимально — указать **API-ключ**: это секретный ключ доступа к нейросети, который выдаёт поставщик ИИ (компания, предоставляющая нейросети, — Anthropic, z.ai, OpenRouter и другие).

**Быстрый способ:** пока моделей нет, в области ввода сообщений появляется ссылка **«создать модель»** — диалог настройки откроется прямо там, где нужно, отдельно переходить на страницу «Модели» не обязательно.

### Как создать первую модель:

- Нажмите **Новая модель** — на странице **Модели** в главном меню или по ссылке **«создать модель»** в области ввода сообщений
- Выберите поставщика ИИ из встроенного списка — Anthropic, z.ai, OpenRouter, xAI Grok, MiniMax, Kimi или «Своё»
- Выберите вариант модели (например, Claude Sonnet 4.6 или Claude Opus 4.7 для Anthropic) — модели отличаются качеством, скоростью и ценой
- Введите ваш **API-ключ** — все остальные параметры (название модели, адрес поставщика, цены) подставятся автоматически

Если вашего поставщика или модели нет в списке, возьмите любой существующий шаблон и поправьте параметры после создания, либо добавьте поставщика в файл `.pastukhov/providers.yml` проекта. Можно также [связаться с нами](/contact)
 — добавим его во встроенный список.

**Какой поставщик выбрать:** для интенсивной разработки (крупные программные продукты) удобнее всего **z.ai** (модели GLM) — там есть планы под активную работу. Для всего остального — включая повседневную работу с готовыми продуктами — оптимален **DeepSeek** с оплатой за фактические токены (доступен через шаблон OpenRouter). Если вы планируете и разрабатывать, и пользоваться готовым продуктом, заведите обе модели и переключайтесь под задачу.

После создания модели выберите её в **селекторе моделей** — выпадающий список рядом с полем ввода (он появляется, когда создана хотя бы одна модель). Можно создать несколько моделей для разных поставщиков и переключаться между ними в любой момент. Подробнее — в документации [Модели](/agents/agent/docs/models)
.

## Отправка первого сообщения

### Начать разговор просто:

- **Создайте чат** — в списке чатов нажмите **Новый чат**.
- **Введите сообщение** — в поле ввода напишите вопрос или опишите задачу обычными словами. Поле поддерживает многострочный текст.
- **Отправьте** — нажмите **Enter** или кнопку отправки. **Shift+Enter** добавляет перенос строки без отправки.
- **Следите за ответом** — ответ появляется в реальном времени. Если агент читает файлы или выполняет действия, вы увидите это прямо в чате.

**Совет:** будьте конкретны. Вместо «Исправь баг» напишите «Форма входа не отправляется при нажатии кнопки. Помоги найти проблему». Чем больше контекста — тем точнее помощь.

Пока агент работает, **заголовок страницы** показывает текущую статистику: затраченное время, скорость обработки (токенов в секунду — токены это «единицы текста», за которые вы платите поставщику) и стоимость на текущий момент. Рядом появляется кнопка остановки — нажмите, чтобы прервать запрос в любой момент.

Нажмите на любое сообщение, чтобы увидеть его детали — какие файлы были прочитаны или изменены. Для правок показывается diff — наглядное сравнение «было/стало»: добавленные строки зелёным, удалённые красным. Наведите курсор на сообщение, чтобы увидеть статистику (время обработки, токены, стоимость) и кнопки: **копировать** сообщение или **продолжить** разговор с этого места — удобно для возобновления остановленного чата.

Все возможности чата — типы сообщений, выбор навыка, переключение моделей, очередь сообщений — описаны в документации [Чат](/agents/agent/docs/chat)
.

## Работа с несколькими чатами

Каждый чат — самостоятельный разговор со своим контекстом: один можно посвятить отладке функции, другой — планированию нового проекта, третий — изучению части кода. Вот как этим пользоваться:

- **Создание чатов** — нажмите **Новый чат** в списке чатов. После первого сообщения агент сам придумает чату понятный заголовок.
- **Переключение между чатами** — вернитесь к списку чатов и выберите нужный. Каждый чат помнит весь разговор, поэтому вы продолжите ровно с того места, где остановились.

**Рекомендация:** заводите отдельный чат под каждую задачу или тему — так разговоры остаются сфокусированными, а нужную информацию легко найти. Например, один чат — «Обновление формы заказа», другой — «Настройка уведомлений по почте».

## Что дальше?

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

- **Чат** — типы сообщений, выбор навыка, переключение моделей, очередь сообщений и плавающая панель задач. [Читать о чате](/agents/agent/docs/chat)
- **Модели** — несколько поставщиков ИИ, управление API-ключами, переключение между конфигурациями. [Читать о моделях](/agents/agent/docs/models)
- **Файлы и проекты** — как агент читает, редактирует и управляет файлами вашего проекта. [Читать о файлах и проектах](/agents/agent/docs/files)
- **Сборка и развёртывание** — автоматические проверки качества, управление запуском приложения. [Читать о сборке и развёртывании](/agents/agent/docs/build-deploy)
- **Навыки** — использование, создание и управление навыками, расширяющими возможности агента. [Читать о навыках](/agents/agent/docs/skills)
- **Настройки** — карточный хаб: оформление, чат и звук, автоматизация, инструменты и конфигурация. [Читать о настройках](/agents/agent/docs/settings)

**Назад:** [Документация](/agents/agent/docs)
 | **Далее:** [Чат](/agents/agent/docs/chat)