---
title: "Начало работы"
id: "341"
type: "page"
slug: "getting-started"
published_at: "2026-05-19T11:30:44+00:00"
modified_at: "2026-11-06T09:29:17+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 — это личный ИИ-помощник, который работает над вашим проектом на компьютере или сервере: читает и изменяет файлы, выполняет команды, следит за качеством кода и ведёт с вами обычный чат. Он пригодится и разработчику, и владельцу бизнеса, который хочет самостоятельно вносить изменения в свой проект. Эта страница — с чего начать.

Pastukhov Agent разворачивается на вашем сервере или компьютере через Pastukhov MultiAgent — в рамках «Фабрики агентов». Отдельно ставить ничего не нужно: MultiAgent сам подготовит окружение и запустит приложение.

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

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

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

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

### Пароль и его отпечаток

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

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

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

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

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

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

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

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

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

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

## Демо-проект

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

Для своего проекта укажите путь к нему переменной окружения `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)