Быстрый старт
Путь от установки WorkAI до первой правки в кодовой базе: скачивание, знакомство с проектом через агента, диф и Plan Mode для более крупных задач.
Этот гайд проведёт вас от установки WorkAI до первой полезной правки в коде: вы скачаете и запустите IDE, попросите агента объяснить проект, сделаете небольшое изменение и посмотрите диф, а затем попробуете Plan Mode на задаче покрупнее.
Установите WorkAI и войдите
Скачайте установщик на workai.su/download — сайт сам определит вашу ОС (macOS, Windows или Linux) и предложит нужный файл.
Запустите установленное приложение и войдите в аккаунт. Новому пользователю при регистрации начисляется 500 бесплатных WorkCoins — их хватит, чтобы освоиться, не думая о тарифе. Если хотите работать вообще без оплаты, откройте каталог моделей и выберите пул «WorkAI Free» — открытые модели без лимита по WorkCoins.
Дальше откройте папку с проектом и переходите к первой задаче.
Попросите агента объяснить кодовую базу
Откройте панель Agent и опишите, что вы хотите понять — агент прочитает репозиторий и соберёт связную картину сам.
Объясни эту кодовую базу. Покажи основные точки входа, ключевые модули
и что стоит прочитать перед тем, как вносить изменения.
WorkAI пройдётся по репозиторию, откроет релевантные файлы и соберёт из них связное описание архитектуры. Это самый быстрый способ сориентироваться в незнакомом проекте — быстрее, чем читать README и структуру папок вручную.
Сделайте одну небольшую правку
Когда общая картина ясна, попросите агента предложить несколько безопасных мелких улучшений и выберите одно.
Предложи три небольших безопасных улучшения в этом коде.
Объясни компромиссы и дождись, пока я выберу одно.
Хорошая первая задача — низкорисковая: поправить текст в интерфейсе, исправить мелкий визуальный баг, добавить недостающий комментарий. Если вы уже точно знаете, что хотите изменить, — сформулируйте задачу и желаемый результат сразу, без предварительного брейнсторма.
Проверьте диф
После того как агент закончит, откройте диф изменённых файлов — WorkAI показывает построчные изменения прямо в интерфейсе, как обычный git diff, только привязанный к сессии агента.
Прежде чем принимать правку, попросите агента прогнать проверки, которые уже есть в проекте — тесты, тайпчекер, линтер или локальную сборку:
Прогони тесты и линтер для изменённых файлов и покажи результат.
Если что-то не так — попросите агента поправить прямо по результатам проверки, не переписывая всё заново вручную.
Используйте Plan Mode для задач покрупнее
Для задач, которые затрагивают несколько файлов, требуют предварительного исследования кода или согласования подхода перед тем, как агент начнёт писать код, — включите Plan Mode.
Выберите «Планирование» в выпадающем списке режимов в поле ввода чата (отдельного хоткея для переключения нет — режим выбирается через пикер), чтобы включить Plan Mode. Вместо того чтобы сразу писать код, WorkAI:
- исследует кодовую базу и находит релевантные файлы;
- задаёт уточняющие вопросы по требованиям;
- составляет подробный план реализации;
- ждёт вашего одобрения плана, прежде чем приступить к коду.
Это особенно полезно на worktrees — параллельных сессиях агента: можно спланировать несколько независимых задач, прежде чем запускать их одновременно.
Что дальше
- Agent — инструменты и возможности агента: терминал, браузер, поиск по коду.
- Rules — постоянные инструкции для проекта, которые агент учитывает в каждой сессии.
- Agent Review — более строгий процесс проверки правок перед принятием.
- Skills и Subagents — как собирать переиспользуемые сценарии работы поверх агента.