Этот гайд проведёт вас от установки WorkAI до первой полезной правки в коде: вы скачаете и запустите IDE, попросите агента объяснить проект, сделаете небольшое изменение и посмотрите диф, а затем попробуете «Планирование» на задаче покрупнее.

## Установите WorkAI и войдите

Скачайте установщик на [workai.su/download](https://workai.su/download) — сайт сам определит вашу ОС (macOS, Windows или Linux) и предложит нужный файл.

Запустите установленное приложение и войдите в аккаунт. Новому пользователю при регистрации начисляется 500 бесплатных WorkCoins — их хватит, чтобы освоиться, не думая о тарифе. Если хотите работать вообще без оплаты, откройте каталог моделей и выберите пул «WorkAI Free» — открытые модели без лимита по WorkCoins.

Дальше откройте папку с проектом и переходите к первой задаче.

## Попросите агента объяснить кодовую базу

Откройте панель Agent и опишите, что вы хотите понять — агент прочитает репозиторий и соберёт связную картину сам.

```
Объясни эту кодовую базу. Покажи основные точки входа, ключевые модули
и что стоит прочитать перед тем, как вносить изменения.
```

WorkAI пройдётся по репозиторию, откроет релевантные файлы и соберёт из них связное описание архитектуры. Это самый быстрый способ сориентироваться в незнакомом проекте — быстрее, чем читать README и структуру папок вручную.

## Сделайте одну небольшую правку

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

```
Предложи три небольших безопасных улучшения в этом коде.
Объясни компромиссы и дождись, пока я выберу одно.
```

Хорошая первая задача — низкорисковая: поправить текст в интерфейсе, исправить мелкий визуальный баг, добавить недостающий комментарий. Если вы уже точно знаете, что хотите изменить, — сформулируйте задачу и желаемый результат сразу, без предварительного брейнсторма.

## Проверьте диф

После того как агент закончит, откройте диф изменённых файлов — WorkAI показывает построчные изменения прямо в интерфейсе, как обычный git diff, только привязанный к сессии агента.

Прежде чем принимать правку, попросите агента прогнать проверки, которые уже есть в проекте — тесты, тайпчекер, линтер или локальную сборку:

```
Прогони тесты и линтер для изменённых файлов и покажи результат.
```

Если что-то не так — попросите агента поправить прямо по результатам проверки, не переписывая всё заново вручную.

## Используйте планирование для задач покрупнее

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

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

1. исследует кодовую базу и находит релевантные файлы;
2. задаёт уточняющие вопросы по требованиям;
3. составляет подробный план реализации;
4. ждёт вашего одобрения плана, прежде чем приступить к коду.

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

## Что дальше

- **[Агент — обзор](/docs/agent/overview)** — инструменты и возможности агента: терминал, браузер, поиск по коду.
- **[Правила](/docs/rules)** — постоянные инструкции для проекта, которые агент учитывает в каждой сессии.
- **[Проверка кода](/docs/agent/agent-review)** — просмотр правок перед принятием.
- **[Навыки](/docs/skills)** и **[подагенты](/docs/subagents)** — как собирать переиспользуемые сценарии поверх агента.