--- title: "Начало работы" id: "341" type: "page" slug: "getting-started" published_at: "2026-05-19T11:30:44+00:00" modified_at: "2026-06-13T00:52:52+00:00" url: "https://pastukhov.com/code/docs/getting-started" markdown_url: "https://pastukhov.com/code/docs/getting-started.md" excerpt: "Pastukhov Code работает на вашем компьютере или сервере, предоставляя полный контроль над средой разработки. Выберите…" --- # Начало работы [https://pastukhov.com/code/docs/getting-started.md](https://pastukhov.com/code/docs/getting-started.md) Pastukhov Code работает на вашем компьютере или сервере, предоставляя полный контроль над средой разработки. Выберите подходящий способ установки: - **Установка через Docker***(Рекомендуется)* — Запустите Pastukhov Code в Docker-контейнере на Linux, macOS или Windows. Обеспечивает полную изоляцию и полный набор инструментов, используемых Claude Code, из коробки. [Инструкция по установке Docker](/code/docker) - **Windows Docker Desktop** — Запустите Pastukhov Code через Docker Desktop на Windows с backend WSL 2. Объединяет графическое управление Docker с полной изоляцией контейнеров. [Инструкция по установке Windows Docker Desktop](/code/windows-docker-desktop) - **Mac Docker Desktop** — Запустите Pastukhov Code через Docker Desktop на macOS (Intel и Apple Silicon). Удобное графическое управление Docker с полной изоляцией контейнеров. [Инструкция по установке Mac Docker Desktop](/code/mac-docker-desktop) - **Установка WSL** — Запустите Pastukhov Code в Docker на Windows через WSL (Windows Subsystem for Linux) без Docker Desktop. Полная изоляция Docker с нативной производительностью Linux на Windows 10 или 11. [Инструкция по установке WSL](/code/wsl) - **Установка Windows** — Нативное приложение для Windows 10/11. Работает как консольный инструмент с веб-интерфейсом, настраиваемым через [переменные окружения](/code/docs/environments) или параметры командной строки. [Инструкция по установке Windows](/code/windows) **Почему рекомендуется Docker — даже на Windows:** Модели Claude Code в значительной степени полагаются на инструменты и Python, нативные для Linux, которые включены в Docker-контейнер из коробки, но требуют отдельной установки на Windows. Модели также часто испытывают трудности с путями и инструментами в стиле Windows. Docker обеспечивает полную изоляцию — модели не могут повредить вашу основную среду, а если что-то пойдёт не так внутри контейнера, его можно пересоздать за секунды. Наконец, Docker позволяет настроить среду для конкретной задачи только с нужными файлами, уменьшая путаницу от посторонних файлов в рабочей области. Все способы установки включают всё необходимое для работы Pastukhov Code. После установки нужно настроить окружение с API-ключом вашего провайдера AI, прежде чем можно будет начать чат — см. раздел [Настройка первого окружения](#setting-up-your-first-environment) ниже. ## Настройка учётных данных Pastukhov Code использует учётные данные для защиты доступа. Если переменные окружения `PASTUKHOV_CODE_LOGIN` и `PASTUKHOV_CODE_PASSWORD` не заданы при запуске приложения, они генерируются автоматически — логин `code`, а случайный пароль выводится в консоль. Эти временные учётные данные действительны до перезапуска приложения. Полный список переменных окружения уровня приложения см. на странице [Окружения](/code/docs/environments) . ### Установщик Windows Установщик Windows всё настроит за вас. Во время установки вы выбираете логин и пароль, которые сохраняются как переменные окружения вашей системы. После установки Pastukhov Code автоматически открывается в браузере с предустановленным демо-проектом. Если пропустить шаг настройки учётных данных при установке, приложение сгенерирует временные при запуске и выведет их в окно консоли. ### Docker Для установки через Docker задайте учётные данные с помощью переменных окружения `PASTUKHOV_CODE_LOGIN` и `PASTUKHOV_CODE_PASSWORD` в файле docker-compose или файле `.env`. Пароль хранится как SHA256-хэш. Подробнее см. в [инструкции по установке Docker](/code/docker) . Если пропустить эти переменные, приложение сгенерирует временные учётные данные и выведет их в лог контейнера — используйте `docker logs` для просмотра. ### Ручная установка Для ручной установки можно либо задать переменные окружения `PASTUKHOV_CODE_LOGIN` и `PASTUKHOV_CODE_PASSWORD` перед запуском, либо просто запустить приложение и использовать автоматически сгенерированные временные учётные данные из консоли. Пароль должен быть SHA256-хэшем при задании через переменную окружения. Используйте встроенный генератор SHA256 на странице входа для создания хэша или вычислите его самостоятельно. При использовании временных учётных данных на странице входа отображается уведомление о том, что они автоматически сгенерированы и являются временными. Чтобы сделать их постоянными, настройте [переменные окружения](/code/docs/environments) и перезапустите приложение. После настройки учётных данных откройте Pastukhov Code в браузере, введите логин и пароль, нажмите **Войти**. Вы получите JWT-токен, который поддерживает вашу сессию в течение 90 дней. Браузер откроется на главном экране со списком чатов. По умолчанию ключ подписи JWT генерируется автоматически и сохраняется во временной папке системы. Для повышенной безопасности можно указать свой ключ через переменную окружения `JWT_SECRET_KEY` (минимум 32 символа). Это гарантирует, что ключ сохраняется между перезапусками и не хранится в общей временной директории. Полный список доступных переменных окружения см. на странице [Окружения](/code/docs/environments) . ## Главный интерфейс После входа вы попадаете на **список чатов** — главный экран для управления всеми разговорами. Вот что вы увидите: - **Список чатов** — В центральной области отображаются все ваши чат-сессии. Каждый чат показывает заголовок и время последнего обновления. Когда чатов ещё нет, заметная кнопка **Новый чат** приглашает начать первый разговор. - **Новый чат** — Нажмите кнопку «Новый чат» для создания новой сессии. Каждый чат независим — сессии не разделяют контекст, поэтому можно работать над несколькими темами без путаницы. - **Обновления в реальном времени** — Список чатов обновляется в реальном времени через SignalR. Новые чаты появляются автоматически, активные чаты показывают прогресс в реальном времени. Список чатов кэшируется в браузере для производительности, поэтому загружается мгновенно при повторных посещениях. Если список рассинхронизировался с базой данных (например, после удаления чатов из другого браузера или напрямую из базы), нажмите кнопку **обновления** рядом с полем поиска чатов для перезагрузки. Нажмите на любой чат в списке, чтобы открыть его. В представлении чата вы взаимодействуете с AI — подробное описание интерфейса чата, типов сообщений и элементов управления см. в документации [Чат](/code/docs/chat) . ## Демо-проект (Windows) Установщик Windows включает демо-проект с несколькими фреймворками, демонстрирующий возможности Pastukhov Code — от разработки и сборки до линтинга, развёртывания и автокоррекции ошибок. При запуске установленного приложения вы увидите этот демо-проект. Для установки через Docker или вручную укажите путь к вашему проекту через переменную окружения `PASTUKHOV_CODE_PROJECT_PATH`. Pastukhov Code работает с любой кодовой базой — укажите директорию проекта и начинайте чат. Полный список переменных окружения см. на странице [Окружения](/code/docs/environments) . Демо-проект также поставляется с **демо-навыками** — готовыми навыками, предоставляющими специфичную для проекта guidance и возможности планирования. Они полезны сами по себе и служат шаблонами для создания собственных пользовательских навыков. Подробнее о создании и управлении навыками см. в документации [Навыки](/code/docs/skills) . 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` в проекте для добавления. Также можно [связаться с нами](/code/contact) , чтобы добавить его во встроенный список. После создания окружения перейдите к вводу чата и используйте **селектор окружений** (выпадающий список рядом с полем ввода) для его активации. Селектор появляется только после создания хотя бы одного окружения. Можно создать несколько окружений для разных провайдеров или конфигураций моделей и переключаться между ними в любой момент из области ввода чата. Подробнее см. в документации [Окружения](/code/docs/environments) . ## Отправка первого сообщения ### Начать разговор просто: - **Создайте чат** — В списке чатов нажмите **Новый чат** для создания нового разговора. - **Введите сообщение** — В поле ввода внизу экрана введите вопрос, запрос или описание задачи. Поле поддерживает многострочные сообщения. - **Отправьте** — Нажмите **Enter** или кнопку отправки. Удерживайте **Shift+Enter** для переноса строки без отправки. - **Следите за ответом** — Ответ AI появляется в чате с потоковым выводом в реальном времени. Если AI читает файлы или выполняет задачи, вы увидите сообщения об использовании инструментов и обновления статуса прямо в чате. **Совет:** Будьте конкретны в вопросах. Вместо «Исправь баг», попробуйте «Форма входа не отправляется при нажатии кнопки. Можешь помочь найти проблему?» Чем больше контекста вы предоставите, тем лучше AI сможет помочь. Пока AI работает, **заголовок страницы** показывает текущую статистику: затраченное время, скорость обработки (токенов/секунду) и стоимость на данный момент. Во время обработки появляется **кнопка остановки** в заголовке — нажмите её, чтобы отменить текущий запрос в любой момент. Нажмите на любое сообщение, чтобы увидеть его детали — какие файлы были прочитаны или изменены, с полными diffs для правок. Сообщения инструментов (например, чтение файлов, правки, обновления задач) разворачиваются прямо в чате для показа содержимого. Наведите курсор на сообщение, чтобы увидеть статистику по сообщению (время обработки, кэш/входные/выходные токены, стоимость) и кнопки действий для **копирования** сообщения или **продолжения** с этой точки в разговоре — полезно для возобновления остановленного чата с определённого сообщения. Подробное описание всех функций чата — типов сообщений, селектора навыков, переключения окружений, очереди сообщений и другое — см. в документации [Чат](/code/docs/chat) . ## Работа с несколькими чатами Каждая чат-сессия — это независимый разговор со своим контекстом. У вас может быть одна сессия для отладки определённой функции, другая для планирования нового проекта, и третья для изучения работы конкретной части кода. - **Создание чатов** — Нажмите **Новый чат** в списке чатов для начала новой сессии. При отправке первого сообщения Pastukhov Code генерирует описательный заголовок на основе вашего вопроса. - **Переключение между чатами** — Вернитесь к списку чатов для переключения между сессиями. Каждый чат запоминает весь разговор, поэтому можно продолжить точно с того места, где остановились. **Лучшая практика:** Создавайте новый чат для каждой отдельной задачи или темы. Это сохраняет разговоры сфокусированными и облегчает поиск информации. Например, используйте одну сессию для «Рефакторинга системы аутентификации» и другую для «Добавления комментариев в код обработки платежей». ## Что дальше? Теперь, когда вы знакомы с основами, углубитесь в функции Pastukhov Code: - **Чат** — Узнайте о типах сообщений, селекторе навыков, переключении окружений, очереди сообщений и плавающей панели задач. [Читать о чате](/code/docs/chat) - **Окружения** — Настройка нескольких провайдеров AI, управление API-ключами и переключение между конфигурациями моделей. [Читать об окружениях](/code/docs/environments) - **Файлы и проекты** — Узнайте, как Pastukhov Code читает, редактирует и управляет файлами вашего проекта. [Читать о файлах и проектах](/code/docs/files) - **Сборка и развёртывание** — Панель сборки, управление развёртыванием и автосборка. [Читать о сборке и развёртывании](/code/docs/build-deploy) - **Навыки** — Использование, создание и управление навыками, расширяющими возможности AI. [Читать о навыках](/code/docs/skills) - **Настройки** — Оформление, настройки API, звуки, речь, хуки и MCP-серверы. [Читать о настройках](/code/docs/settings) **Назад:** [Документация](/code/docs) | **Далее:** [Чат](/code/docs/chat)