Документация WorkAI
WorkAI — ИИ-редактор кода на базе VS Code: агент правит код в проекте, Создатель собирает сайт в браузере. Установка, модели, WorkCoins, правила, MCP.
WorkAI — это форк VS Code со встроенным AI-агентом, а не расширение поверх редактора. Это полноценная IDE: агент видит проект, читает и правит код, запускает команды в терминале и открывает превью прямо внутри среды разработки. Плюс отдельный браузерный режим Создатель, где проект генерируется с нуля вообще без установки клиента.
Чем WorkAI отличается от зарубежных AI-редакторов
- Оплата в рублях. Тарифы и докупка оплачиваются российской картой или через СБП — напрямую, без конвертации и посредников.
- Без VPN и зарубежных аккаунтов. Запросы к моделям идут через серверы WorkAI, отдельные ключи Anthropic или OpenAI заводить не нужно.
- Русскоязычный интерфейс. В сборку входит русская локализация редактора.
- Один каталог моделей на всех платных тарифах. Тарифы различаются объёмом WorkCoins, а не набором доступных моделей.
С чего начать
Выберите строку, которая описывает вашу ситуацию.
| Ситуация | Куда идти |
|---|---|
| Никогда не работал с AI-редактором | Быстрый старт — установка, первый разбор кодовой базы, первая правка |
| Перехожу из VS Code | Раздел «Что меняется при переходе» ниже на этой странице, затем Agent — обзор |
| Перехожу из Cursor | То же плюс Rules: файлы .cursor/rules из проекта читаются как есть |
| Нужен сайт или бот, а не редактор | Создатель — генерация в браузере, устанавливать ничего не нужно |
| Считаю, во сколько это обойдётся | Модели и цены — механика WorkCoins; рублёвые цифры на странице тарифов |
Что нужно для установки
Установщик скачивается на workai.su/download — сайт сам определяет вашу ОС и предлагает нужный файл, а после скачивания показывает три шага установки для вашей платформы.
| Платформа | Что публикуется |
|---|---|
| macOS 12 и новее | .dmg — отдельно для Apple Silicon и для Intel |
| Windows 10 и новее | .exe-установщик |
| Linux x64 | .deb, .rpm и .tar.gz |
Отдельного «серверного» или веб-варианта редактора нет: клиент ставится на вашу машину и работает с локальными папками. Единственный сценарий без установки — Создатель в браузере.
При первом запуске приложение попросит войти: открывается страница входа в браузере, после подтверждения вы возвращаетесь в редактор уже авторизованным — пароль в самом редакторе вводить не нужно. Новому аккаунту начисляется 500 бонусных WorkCoins, а в списке моделей всегда есть пункт WorkAI Free — открытая модель, которая не расходует Ⓦ вообще.
Что меняется, если вы переходите из VS Code или Cursor
Основа осталась прежней: сочетания клавиш, темы, файловое дерево, терминал, отладчик, settings.json — всё привычное на месте. Отличий, о которых стоит знать заранее, три.
- Расширения ставятся из Open VSX, а не из Marketplace Visual Studio Code. Большинство популярных расширений там есть, но некоторые проприетарные — нет; проверьте заранее те, без которых не работаете.
- Настройки агента живут на отдельном экране — «Параметры WorkAI» (
Cmd/Ctrl+Shift+,). Обычные настройки редактора (Cmd/Ctrl+,) остались там же, где были. Подробнее — Настройки. - Правила из чужих экосистем подхватываются как есть. Если в репозитории уже лежат
AGENTS.md,CLAUDE.md,.claude/rules,.github/instructionsили.cursor/rules— переписывать их под WorkAI не нужно, см. Rules.
Свои ключи провайдеров заводить не нужно — модели доступны через WorkAI сразу. Но если у вас они уже есть, ключ можно подключить, и запросы через него не будут списывать Ⓦ: см. Модели и цены.
Как работает агент
Раздел про десктопного агента: режимы, инструменты и границы того, что он может сделать без вашего подтверждения.
- Agent — обзор — из чего состоит агент и какие у него есть режимы работы.
- Как формулировать задачи агенту — как ставить задачу, чтобы получать полезный результат.
- Контекст —
@-упоминания файлов, вложения, изображения и документы. - Inline-правка — изменить выделенный фрагмент по
Cmd/Ctrl+I, не уходя в чат. - Plan Mode — сначала исследование и план, правки файлов — только после вашего согласия.
- Agent Review — просмотр правок агента и команда
/code-reviewдо того, как изменения уйдут в коммит. - Agents Window — отдельное окно, где несколько агентных сессий идут параллельно, каждая со своим чатом и статусом.
- Инструмент: Терминал — как агент выполняет команды и что при этом спрашивает.
- Инструмент: Поиск по коду — текстовый, файловый и семантический поиск по проекту.
- Инструменты: браузер — локальное превью с автообновлением и работа с внешними страницами.
- Безопасность агента и Режимы запуска и разрешения — что выполняется сразу, а что только после подтверждения.
Режимы чата — Создатель, Агент, Планирование и Обсуждение; переключаются в самом поле ввода, вместе с выбором модели.
Как настроить агента под проект
- Rules — постоянные инструкции агенту. WorkAI подхватывает файлы правил из проекта, включая форматы соседних экосистем:
AGENTS.md,CLAUDE.md,.claude/rules,.github/instructions,.cursor/rules. - Skills — переиспользуемые процедуры, которые агент подгружает сам, когда задача на них похожа. Часть скиллов идёт в комплекте — например ревью изменений, коммит, создание и обновление pull request'а, починка упавшего CI.
- Subagents — делегирование исследования и планирования вспомогательным агентам, чтобы не забивать контекст основной сессии.
- MCP — подключение внешних MCP-серверов и их инструментов в чат с агентом.
- Настройки — где что лежит и что переезжает вместе с аккаунтом на другую машину.
- Файл .workaignore — что исключить из индексации кодовой базы.
- Ссылки workai:// — открыть клиент из браузера сразу с нужным действием.
Оплата и WorkCoins
Расход по каждому запросу списывается во внутренней валюте — WorkCoins (Ⓦ). Сколько стоит запрос, зависит от класса модели.
- Модели и цены — тарифы, классы моделей и правила списания.
- Автовыбор модели — что на самом деле делает режим Auto.
- Докупка WorkCoins — что делать, если месячный объём закончился раньше срока.
Создатель: генерация проекта в браузере
Отдельный сценарий — без установки IDE. Вы описываете словами, что нужно построить, и получаете работающий проект с живым превью.
- Создатель (Builder Web) — как устроен процесс: промпт, итеративная генерация, публикация результата.
- Изоляция генерации в Создателе — почему Создатель не трогает вашу локальную рабочую копию.
- GitHub (Создатель) — выгрузка сгенерированного проекта в репозиторий и импорт существующего кода.
Для работы с git из десктопного агента отдельная интеграция не нужна: агент использует обычные git-команды в терминале.
Словарь: что означают слова в этой документации
| Термин | Что это |
|---|---|
| Агент | ИИ-ассистент внутри редактора, который читает проект, правит файлы, запускает команды. См. обзор |
| Режим чата | Что агенту разрешено делать в текущем диалоге: Создатель, Агент, Планирование, Обсуждение |
| Создатель | Полный цикл разработки: декомпозиция задачи, изолированная генерация, живое превью и деплой. В клиенте это режим чата, в браузере — отдельный продукт Builder Web |
| WorkCoins (Ⓦ) | Внутренняя валюта, в которой считается расход по каждому запросу. См. модели и цены |
| WorkAI Free | Один пункт в списке моделей: открытая модель, работа с которой не расходует Ⓦ |
| Правила (Rules) | Markdown-файлы с постоянными инструкциями, которые агент подмешивает в каждый диалог. См. Rules |
| Скиллы (Skills) | Процедуры под конкретную задачу, которые агент подгружает только когда они уместны. См. Skills |
| Субагенты | Вспомогательные агенты для отдельных подзадач; в основной диалог возвращается только выжимка. См. Subagents |
| MCP | Открытый протокол подключения внешних инструментов и данных к агенту. См. MCP |
| Индекс кодовой базы | Разобранное представление проекта, по которому работает семантический поиск; управляется файлом .workaignore |
| Agent Review | Отдельный шаг проверки правок перед их принятием. См. Agent Review |
Какие модели доступны в WorkAI
По каждой модели есть отдельная страница с назначением, сильными сторонами и ориентиром по стоимости. Колонка «Контекст по умолчанию» — это то, что реально работает без дополнительных действий; у моделей с переключателем Context полное окно нужно включить вручную, иначе история диалога начнёт сжиматься раньше, чем можно ожидать от заявленного максимума.
| Модель | Провайдер | Контекст по умолчанию | Максимум | Класс стоимости |
|---|---|---|---|---|
| Sonnet 5 | Anthropic | 200K | 1M | Средний |
| Opus 5 | Anthropic | 200K | 1M | Премиальный |
| Opus 4.8 | Anthropic | 200K | 1M | Премиальный |
| Fable 5 | Anthropic | 200K | 1M | Премиальный |
| Haiku 4.5 | Anthropic | 200K | 200K (без режима 1M) | Бюджетный |
| GPT-5.6 Sol | OpenAI | 272K | 1M | Премиальный |
| GPT-5.6 Terra | OpenAI | 272K | 1M | Средний |
| GPT-5.6 Luna | OpenAI | 272K | 1M | Средний (де-факто самая дешёвая в поколении) |
| GPT-5.4 | OpenAI | 272K | 1M | Премиальный |
| GPT-5.3 Codex | OpenAI | 272K | 400K | Премиальный |
| GPT-5.4 Mini | OpenAI | 272K | 400K | Средний |
| GPT-5.4 Nano | OpenAI | 272K | 400K | Бюджетный |
| GPT-4.1 | OpenAI | 272K | 1M | Средний |
| Grok 4.3 | xAI | 1M (переключателя нет) | 1M | Средний |
| Grok 4.20 Reasoning | xAI | 1M (переключателя нет) | 1M | Средний |
| Grok 4.20 Fast | xAI | 1M (переключателя нет) | 1M | Средний |
| Grok Build 0.1 | xAI | 256K (переключателя нет) | 256K | Бюджетный |
Сравнение по возможностям, уровням рассуждения и точным ценам — на странице Модели и цены; какая модель работает в режиме Auto без ручного выбора — на странице Автовыбор модели.
Что делать, если что-то не работает
Сначала посмотрите страницу нужного раздела: в конце каждой есть блок про типичные сбои — например, почему правило не применяется, если скилл не подхватился или если MCP-сервер не подключается.
Если ответа там нет — напишите нам через страницу поддержки: там форма обращения, Telegram и адрес support@workai.su. Вопросы по счетам и тарифам — туда же.