Pastukhov Code > Документация > Начало работы

Технологии извлечения и анализа данных

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

Pastukhov Code работает на вашем компьютере или сервере, предоставляя полный контроль над средой разработки. Выберите подходящий способ установки:

  • Установка через Docker (Рекомендуется) — Запустите Pastukhov Code в Docker-контейнере на Linux, macOS или Windows. Обеспечивает полную изоляцию и полный набор инструментов, используемых Claude Code, из коробки. Инструкция по установке Docker
  • Windows Docker Desktop — Запустите Pastukhov Code через Docker Desktop на Windows с backend WSL 2. Объединяет графическое управление Docker с полной изоляцией контейнеров. Инструкция по установке Windows Docker Desktop
  • Mac Docker Desktop — Запустите Pastukhov Code через Docker Desktop на macOS (Intel и Apple Silicon). Удобное графическое управление Docker с полной изоляцией контейнеров. Инструкция по установке Mac Docker Desktop
  • Установка WSL — Запустите Pastukhov Code в Docker на Windows через WSL (Windows Subsystem for Linux) без Docker Desktop. Полная изоляция Docker с нативной производительностью Linux на Windows 10 или 11. Инструкция по установке WSL
  • Установка Windows — Нативное приложение для Windows 10/11. Работает как консольный инструмент с веб-интерфейсом, настраиваемым через переменные окружения или параметры командной строки. Инструкция по установке Windows

Почему рекомендуется Docker — даже на Windows: Модели Claude Code в значительной степени полагаются на инструменты и Python, нативные для Linux, которые включены в Docker-контейнер из коробки, но требуют отдельной установки на Windows. Модели также часто испытывают трудности с путями и инструментами в стиле Windows. Docker обеспечивает полную изоляцию — модели не могут повредить вашу основную среду, а если что-то пойдёт не так внутри контейнера, его можно пересоздать за секунды. Наконец, Docker позволяет настроить среду для конкретной задачи только с нужными файлами, уменьшая путаницу от посторонних файлов в рабочей области.

Все способы установки включают всё необходимое для работы Pastukhov Code. После установки нужно настроить окружение с API-ключом вашего провайдера AI, прежде чем можно будет начать чат — см. раздел Настройка первого окружения ниже.

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

Pastukhov Code использует учётные данные для защиты доступа. Если переменные окружения PASTUKHOV_CODE_LOGIN и PASTUKHOV_CODE_PASSWORD не заданы при запуске приложения, они генерируются автоматически — логин code, а случайный пароль выводится в консоль. Эти временные учётные данные действительны до перезапуска приложения. Полный список переменных окружения уровня приложения см. на странице Окружения.

Установщик Windows

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

Docker

Для установки через Docker задайте учётные данные с помощью переменных окружения PASTUKHOV_CODE_LOGIN и PASTUKHOV_CODE_PASSWORD в файле docker-compose или файле .env. Пароль хранится как SHA256-хэш. Подробнее см. в инструкции по установке Docker. Если пропустить эти переменные, приложение сгенерирует временные учётные данные и выведет их в лог контейнера — используйте docker logs для просмотра.

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

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

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

После настройки учётных данных откройте Pastukhov Code в браузере, введите логин и пароль, нажмите Войти. Вы получите JWT-токен, который поддерживает вашу сессию в течение 90 дней. Браузер откроется на главном экране со списком чатов.

По умолчанию ключ подписи JWT генерируется автоматически и сохраняется во временной папке системы. Для повышенной безопасности можно указать свой ключ через переменную окружения JWT_SECRET_KEY (минимум 32 символа). Это гарантирует, что ключ сохраняется между перезапусками и не хранится в общей временной директории. Полный список доступных переменных окружения см. на странице Окружения.

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

После входа вы попадаете на список чатов — главный экран для управления всеми разговорами. Вот что вы увидите:

  • Список чатов — В центральной области отображаются все ваши чат-сессии. Каждый чат показывает заголовок и время последнего обновления. Когда чатов ещё нет, заметная кнопка Новый чат приглашает начать первый разговор.
  • Новый чат — Нажмите кнопку «Новый чат» для создания новой сессии. Каждый чат независим — сессии не разделяют контекст, поэтому можно работать над несколькими темами без путаницы.
  • Обновления в реальном времени — Список чатов обновляется в реальном времени через SignalR. Новые чаты появляются автоматически, активные чаты показывают прогресс в реальном времени.

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

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

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

Установщик Windows включает демо-проект с несколькими фреймворками, демонстрирующий возможности Pastukhov Code — от разработки и сборки до линтинга, развёртывания и автокоррекции ошибок. При запуске установленного приложения вы увидите этот демо-проект.

Для установки через Docker или вручную укажите путь к вашему проекту через переменную окружения PASTUKHOV_CODE_PROJECT_PATH. Pastukhov Code работает с любой кодовой базой — укажите директорию проекта и начинайте чат. Полный список переменных окружения см. на странице Окружения.

Демо-проект также поставляется с демо-навыками — готовыми навыками, предоставляющими специфичную для проекта guidance и возможности планирования. Они полезны сами по себе и служат шаблонами для создания собственных пользовательских навыков. Подробнее о создании и управлении навыками см. в документации Навыки.

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

Настройка первого окружения

Прежде чем начать чат, нужно создать окружение — именованный набор конфигурационных переменных, указывающий Pastukhov Code, какую AI-модель использовать и как к ней подключиться. Как минимум, это означает предоставление API-ключа вашего провайдера AI.

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

Для настройки первого окружения:

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

Если вашего провайдера или модели нет в списке, можно использовать любой существующий провайдер как шаблон и отредактировать переменные после создания, либо отредактировать файл .pastukhov/providers.yml в проекте для добавления. Также можно связаться с нами, чтобы добавить его во встроенный список.

После создания окружения перейдите к вводу чата и используйте селектор окружений (выпадающий список рядом с полем ввода) для его активации. Селектор появляется только после создания хотя бы одного окружения.

Можно создать несколько окружений для разных провайдеров или конфигураций моделей и переключаться между ними в любой момент из области ввода чата. Подробнее см. в документации Окружения.

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

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

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

Совет: Будьте конкретны в вопросах. Вместо «Исправь баг», попробуйте «Форма входа не отправляется при нажатии кнопки. Можешь помочь найти проблему?» Чем больше контекста вы предоставите, тем лучше AI сможет помочь.

Пока AI работает, заголовок страницы показывает текущую статистику: затраченное время, скорость обработки (токенов/секунду) и стоимость на данный момент. Во время обработки появляется кнопка остановки в заголовке — нажмите её, чтобы отменить текущий запрос в любой момент.

Нажмите на любое сообщение, чтобы увидеть его детали — какие файлы были прочитаны или изменены, с полными diffs для правок. Сообщения инструментов (например, чтение файлов, правки, обновления задач) разворачиваются прямо в чате для показа содержимого. Наведите курсор на сообщение, чтобы увидеть статистику по сообщению (время обработки, кэш/входные/выходные токены, стоимость) и кнопки действий для копирования сообщения или продолжения с этой точки в разговоре — полезно для возобновления остановленного чата с определённого сообщения.

Подробное описание всех функций чата — типов сообщений, селектора навыков, переключения окружений, очереди сообщений и другое — см. в документации Чат.

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

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

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

Лучшая практика: Создавайте новый чат для каждой отдельной задачи или темы. Это сохраняет разговоры сфокусированными и облегчает поиск информации. Например, используйте одну сессию для «Рефакторинга системы аутентификации» и другую для «Добавления комментариев в код обработки платежей».

Что дальше?

Теперь, когда вы знакомы с основами, углубитесь в функции Pastukhov Code:

  • Чат — Узнайте о типах сообщений, селекторе навыков, переключении окружений, очереди сообщений и плавающей панели задач. Читать о чате
  • Окружения — Настройка нескольких провайдеров AI, управление API-ключами и переключение между конфигурациями моделей. Читать об окружениях
  • Файлы и проекты — Узнайте, как Pastukhov Code читает, редактирует и управляет файлами вашего проекта. Читать о файлах и проектах
  • Сборка и развёртывание — Панель сборки, управление развёртыванием и автосборка. Читать о сборке и развёртывании
  • Навыки — Использование, создание и управление навыками, расширяющими возможности AI. Читать о навыках
  • Настройки — Оформление, настройки API, звуки, речь, хуки и MCP-серверы. Читать о настройках

Назад: Документация | Далее: Чат