WorkAI — это форк VS Code со встроенным AI-агентом, а не расширение поверх редактора. Это полноценная IDE: агент видит проект, читает и правит код, запускает команды в терминале и открывает превью прямо внутри среды разработки. Плюс отдельный браузерный режим **Создатель**, где проект генерируется с нуля вообще без установки клиента.

## Чем WorkAI отличается от зарубежных AI-редакторов

- **Оплата в рублях.** Тарифы и докупка оплачиваются российской картой или через СБП — напрямую, без конвертации и посредников.
- **Без VPN и зарубежных аккаунтов.** Запросы к моделям идут через серверы WorkAI, отдельные ключи Anthropic или OpenAI заводить не нужно.
- **Русскоязычный интерфейс.** В сборку входит русская локализация редактора.
- **Один каталог моделей на всех платных тарифах.** Тарифы различаются объёмом WorkCoins, а не набором доступных моделей.

## С чего начать

Выберите строку, которая описывает вашу ситуацию.

| Ситуация | Куда идти |
|---|---|
| Никогда не работал с AI-редактором | [Быстрый старт](/docs/get-started/quickstart) — установка, первый разбор кодовой базы, первая правка |
| Перехожу из VS Code | Раздел «Что меняется при переходе» ниже на этой странице, затем [Агент — обзор](/docs/agent/overview) |
| Перехожу из Cursor | То же плюс [Правила](/docs/rules): файлы `.cursor/rules` из проекта читаются как есть |
| Нужен сайт или бот, а не редактор | [Создатель](/docs/builder/overview) — генерация в браузере, устанавливать ничего не нужно |
| Считаю, во сколько это обойдётся | [Модели и цены](/docs/models-and-pricing) — механика WorkCoins; рублёвые цифры на странице [тарифов](/pricing) |
| Хочу узнать, что нового вышло | [Блог](/blog) — история версий и релизов; отдельной страницы changelog в докс-разделе нет намеренно, чтобы не дублировать |

## Что нужно для установки

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

| Платформа | Что публикуется |
|---|---|
| macOS 12 и новее | `.dmg` — отдельно для Apple Silicon и для Intel |
| Windows 10 и новее | `.exe`-установщик |
| Linux x64 | `.deb`, `.rpm` и `.tar.gz` |

Отдельного «серверного» или веб-варианта редактора нет: клиент ставится на вашу машину и работает с локальными папками. Единственный сценарий без установки — [Создатель](/docs/builder/overview) в браузере.

При первом запуске приложение попросит войти: открывается страница входа в браузере, после подтверждения вы возвращаетесь в редактор уже авторизованным — пароль в самом редакторе вводить не нужно. Новому аккаунту начисляется 500 бонусных WorkCoins, а в списке моделей всегда есть пункт **WorkAI Free** — открытая модель, которая не расходует Ⓦ вообще.

## Что меняется, если вы переходите из VS Code или Cursor

Основа осталась прежней: сочетания клавиш, темы, файловое дерево, терминал, отладчик, `settings.json` — всё привычное на месте. Отличий, о которых стоит знать заранее, три.

- **Расширения ставятся из Open VSX**, а не из Marketplace Visual Studio Code. Большинство популярных расширений там есть, но некоторые проприетарные — нет; проверьте заранее те, без которых не работаете.
- **Настройки агента живут на отдельном экране** — «Параметры WorkAI» (`Cmd/Ctrl+Shift+,`). Обычные настройки редактора (`Cmd/Ctrl+,`) остались там же, где были. Подробнее — [Настройки](/docs/configuration/settings).
- **Правила из чужих экосистем подхватываются как есть.** Если в репозитории уже лежат `AGENTS.md`, `CLAUDE.md`, `.claude/rules`, `.github/instructions` или `.cursor/rules` — переписывать их под WorkAI не нужно, см. [Правила](/docs/rules).

Свои ключи провайдеров заводить не нужно — модели доступны через WorkAI сразу. Но если у вас они уже есть, ключ можно подключить, и запросы через него не будут списывать Ⓦ: см. [Модели и цены](/docs/models-and-pricing).

## Как работает агент

Раздел про десктопного агента: режимы, инструменты и границы того, что он может сделать без вашего подтверждения.

- **[Агент — обзор](/docs/agent/overview)** — из чего состоит агент и какие у него есть режимы работы.
- **[Как формулировать задачи агенту](/docs/agent/prompting)** — как ставить задачу, чтобы получать полезный результат.
- **[Контекст](/docs/agent/context)** — `@`-упоминания файлов, вложения, изображения и документы.
- **[Встроенный чат](/docs/agent/inline-edit)** — изменить выделенный фрагмент по `Cmd/Ctrl+I`, не уходя в чат.
- **[Планирование](/docs/agent/plan-mode)** — сначала исследование и план, правки файлов — только после вашего согласия.
- **[Проверка кода](/docs/agent/agent-review)** — просмотр правок агента и команда `/code-review` до того, как изменения уйдут в коммит.
- **[Окно агентов](/docs/agent/agents-window)** — отдельное окно, где несколько агентных сессий идут параллельно, каждая со своим чатом и статусом.
- **[Инструмент: Терминал](/docs/agent/tools/terminal)** — как агент выполняет команды и что при этом спрашивает.
- **[Инструмент: Поиск по коду](/docs/agent/tools/search)** — текстовый, файловый и семантический поиск по проекту.
- **[Инструменты: браузер](/docs/agent/tools/browser)** — локальное превью с автообновлением и работа с внешними страницами.
- **[Безопасность агента](/docs/agent/security)** и **[Режимы запуска и разрешения](/docs/agent/security/run-modes)** — что выполняется сразу, а что только после подтверждения.

Режимы чата — **Создатель**, **Агент**, **Планирование** и **Обсуждение**; переключаются в самом поле ввода, вместе с выбором модели.

## Как настроить агента под проект

- **[Правила](/docs/rules)** — постоянные инструкции агенту. WorkAI подхватывает файлы правил из проекта, включая форматы соседних экосистем: `AGENTS.md`, `CLAUDE.md`, `.claude/rules`, `.github/instructions`, `.cursor/rules`.
- **[Навыки](/docs/skills)** — переиспользуемые процедуры, которые агент подгружает сам, когда задача на них похожа. Часть скиллов идёт в комплекте — например ревью изменений, коммит, создание и обновление pull request'а, починка упавшего CI.
- **[Подагенты](/docs/subagents)** — делегирование исследования и планирования вспомогательным агентам, чтобы не забивать контекст основной сессии.
- **[MCP](/docs/mcp)** — подключение внешних MCP-серверов и их инструментов в чат с агентом.
- **[Настройки](/docs/configuration/settings)** — где что лежит и что переезжает вместе с аккаунтом на другую машину.
- **[Файл .workaignore](/docs/configuration/ignore-files)** — что исключить из индексации кодовой базы.
- **[Приватность и данные](/docs/privacy)** — где лежит код, что уходит в индекс и к моделям.
- **[Ссылки workai://](/docs/configuration/deeplinks)** — открыть клиент из браузера сразу с нужным действием.

## Оплата и WorkCoins

Расход по каждому запросу списывается во внутренней валюте — WorkCoins (Ⓦ). Сколько стоит запрос, зависит от класса модели.

- **[Модели и цены](/docs/models-and-pricing)** — тарифы, классы моделей и правила списания.
- **[Автовыбор модели](/docs/model-router)** — что на самом деле делает режим Auto.
- **[Докупка WorkCoins](/docs/billing/workcoins-packs)** — что делать, если месячный объём закончился раньше срока.

## Создатель: генерация проекта в браузере

Отдельный сценарий — без установки IDE. Вы описываете словами, что нужно построить, и получаете работающий проект с живым превью.

- **[Создатель](/docs/builder/overview)** — как устроен процесс: промпт, итеративная генерация, публикация результата.
- **[Изоляция генерации в Создателе](/docs/configuration/worktrees)** — почему Создатель не трогает вашу локальную рабочую копию.
- **[GitHub (Создатель)](/docs/integrations/github)** — выгрузка сгенерированного проекта в репозиторий и импорт существующего кода.

Для работы с git из десктопного агента отдельная интеграция не нужна: агент использует обычные git-команды в терминале.

## Словарь: что означают слова в этой документации

| Термин | Что это |
|---|---|
| Агент | ИИ-ассистент внутри редактора, который читает проект, правит файлы, запускает команды. См. [обзор](/docs/agent/overview) |
| Режим чата | Что агенту разрешено делать в текущем диалоге: Создатель, Агент, Планирование, Обсуждение |
| Создатель | Полный цикл разработки: декомпозиция задачи, изолированная генерация, живое превью и деплой. В клиенте это режим чата, в браузере — отдельный продукт [Создатель](/docs/builder/overview) |
| WorkCoins (Ⓦ) | Внутренняя валюта, в которой считается расход по каждому запросу. См. [модели и цены](/docs/models-and-pricing) |
| WorkAI Free | Один пункт в списке моделей: открытая модель, работа с которой не расходует Ⓦ |
| Правила (Rules) | Markdown-файлы с постоянными инструкциями, которые агент подмешивает в каждый диалог. См. [Правила](/docs/rules) |
| Скиллы (Skills) | Процедуры под конкретную задачу, которые агент подгружает только когда они уместны. См. [Навыки](/docs/skills) |
| Субагенты | Вспомогательные агенты для отдельных подзадач; в основной диалог возвращается только выжимка. См. [Подагенты](/docs/subagents) |
| MCP | Открытый протокол подключения внешних инструментов и данных к агенту. См. [MCP](/docs/mcp) |
| Индекс кодовой базы | Разобранное представление проекта, по которому работает семантический поиск; управляется файлом [.workaignore](/docs/configuration/ignore-files) |
| Проверка кода | Отдельный шаг проверки правок перед их принятием. См. [Проверка кода](/docs/agent/agent-review) |

## Какие модели доступны в WorkAI

По каждой модели есть отдельная страница с назначением, сильными сторонами и ориентиром по стоимости. Колонка «Контекст по умолчанию» — это то, что реально работает без дополнительных действий; у моделей с переключателем **Context** полное окно нужно включить вручную, иначе история диалога начнёт сжиматься раньше, чем можно ожидать от заявленного максимума.

| Модель | Провайдер | Контекст по умолчанию | Максимум | Класс стоимости |
|---|---|---|---|---|
| [Sonnet 5](/docs/models/claude-sonnet-5) | Anthropic | 200K | 1M | Средний |
| [Opus 5](/docs/models/claude-opus-5) | Anthropic | 200K | 1M | Премиальный |
| [Opus 4.8](/docs/models/claude-opus-4-8) | Anthropic | 200K | 1M | Премиальный |
| [Fable 5](/docs/models/claude-fable-5) | Anthropic | 200K | 1M | Премиальный |
| [Haiku 4.5](/docs/models/claude-haiku-4-5) | Anthropic | 200K | 200K (без режима 1M) | Бюджетный |
| [GPT-5.6 Sol](/docs/models/gpt-5-6-sol) | OpenAI | 272K | 1M | Премиальный |
| [GPT-5.6 Terra](/docs/models/gpt-5-6-terra) | OpenAI | 272K | 1M | Средний |
| [GPT-5.6 Luna](/docs/models/gpt-5-6-luna) | OpenAI | 272K | 1M | Средний (де-факто самая дешёвая в поколении) |
| [GPT-5.4](/docs/models/gpt-5-4) | OpenAI | 272K | 1M | Премиальный |
| [GPT-5.3 Codex](/docs/models/gpt-5-3-codex) | OpenAI | 272K | 400K | Премиальный |
| [GPT-5.4 Mini](/docs/models/gpt-5-4-mini) | OpenAI | 272K | 400K | Средний |
| [GPT-5.4 Nano](/docs/models/gpt-5-4-nano) | OpenAI | 272K | 400K | Бюджетный |
| [GPT-4.1](/docs/models/gpt-4-1) | OpenAI | 272K | 1M | Средний |
| [Grok 4.3](/docs/models/grok-4-3) | xAI | 1M (переключателя нет) | 1M | Средний |
| [Grok 4.20 Reasoning](/docs/models/grok-4-20-reasoning) | xAI | 1M (переключателя нет) | 1M | Средний |
| [Grok 4.20 Fast](/docs/models/grok-4-20-fast) | xAI | 1M (переключателя нет) | 1M | Средний |
| [Grok Build 0.1](/docs/models/grok-build-0-1) | xAI | 256K (переключателя нет) | 256K | Бюджетный |

Сравнение по возможностям, уровням рассуждения и точным ценам — на странице [Модели и цены](/docs/models-and-pricing); какая модель работает в режиме Auto без ручного выбора — на странице [Автовыбор модели](/docs/model-router).

## Что делать, если что-то не работает

Сначала посмотрите страницу нужного раздела: в конце каждой есть блок про типичные сбои — например, [почему правило не применяется](/docs/rules), [если скилл не подхватился](/docs/skills) или [если MCP-сервер не подключается](/docs/mcp).

Если ответа там нет — напишите нам через [страницу поддержки](/support): там форма обращения, Telegram и адрес `support@workai.su`. Вопросы по счетам и тарифам — туда же.