Написать в Telegram

REA: как научить Claude Code и Codex разобрать готовое приложение и собрать его копию. Пошагово

Содержание
  1. Зачем агенту больше контекста
  2. Что понадобится
  3. Если вы работаете из России
  4. Ограничения и риски перед стартом
  5. Шаг 1. Проверяем Node.js
  6. Шаг 2. Запускаем установку
  7. Шаг 3. Выбираем агентов
  8. Шаг 4. Ставим Hopper
  9. Шаг 5. Даём агенту задачу
  10. Шаг 6. Проверяем результат
  11. Что это меняет
  12. Что дальше

Кодинг-агент хорошо пишет код, пока ему ясно, что именно строить. Но если сказать «сделай как вот это приложение», он гадает. Видит только то, что снаружи, и додумывает остальное. Копия выходит похожей, но не такой.

Reverse Engineer Anything, сокращённо REA, решает эту проблему. Это открытый проект на GitHub: набор инструментов и инструкций, которые учат агента изучать готовое приложение изнутри. Агент смотрит, как оно устроено, что делает и из чего собрано, и только потом строит свою версию. Проект называет себя одним CLI и MCP-сервером для агентов, от бинарных файлов до сайтов. Сейчас о нём много говорят: он набрал десятки тысяч звёзд на GitHub за считанные дни.

Разбираем по шагам, как поставить REA, подключить агентов и дать первую задачу. И что из этого можно повторить в России.

Заставка REA: один CLI и MCP-сервер для агентов, от бинарных файлов до сайтов
Заставка REA: один CLI и MCP-сервер для агентов, от бинарных файлов до сайтов

Зачем агенту больше контекста

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

Устроено так. REA работает как навык для агента, то есть как набор инструкций. К нему подключены инструменты по MCP. MCP это способ дать агенту набор инструментов, которыми он пользуется сам. Для настольных программ это Hopper, для сайтов инструмент работы с браузером. Есть и инструменты для мобильных приложений и устройств. Навык учит агента, какой инструмент взять и какие сведения собрать.

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

Что понадобится

  • Компьютер. В примере всё на Mac. Работает ли это так же в Windows и Linux, в примере не показано, проверяйте по документации проекта.
  • Node.js версии 24 или выше. Это требование проекта.
  • Кодинг-агент. В примере Claude Code и Codex. Установщик REA знает и других: Cursor, Gemini CLI, Windsurf, OpenCode, GitHub Copilot CLI и ещё несколько.
  • Hopper. Это программа, которая разбирает готовые приложения на понятные части. REA использует её для глубокого анализа. У неё есть демо-режим.
  • Приложение, которое будем изучать. В примере это программа для превращения речи в текст: нажимаешь горячую клавишу, говоришь, текст появляется там, где стоит курсор.

Если вы работаете из России

REA лежит в открытом доступе под лицензией MIT, ставится из npm и работает на вашем компьютере. Сам проект от санкций не зависит. Ограничения в другом.

  • Агенты. Claude Code и Codex из России напрямую не работают. Но установщик REA поддерживает и другие: в его списке есть Cursor, Gemini CLI, OpenCode и ряд других. Для замены смотрите на агентов, которые умеют работать с открытыми моделями на вашем сервере. Подойдёт ли конкретная связка, нужно проверять самим.
  • Hopper. Это отдельная программа, в её окне есть кнопки покупки лицензии и демо. Для проверки лицензии нужен интернет. Доступна ли она вам и что взять вместо неё, выясняйте до начала. Для настольных программ REA использует именно Hopper, так что замена, скорее всего, потребует отдельной работы.
  • Модель. Для разбора и сборки нужна сильная модель. Если облачные недоступны, пробуйте крупные открытые модели на своём сервере, но качество может быть ниже.

Ограничения и риски перед стартом

  • Чужой продукт. В примере агент разбирает и воспроизводит чужое приложение. Копирование чужого продукта может нарушать авторские права и условия лицензии. Для работы берите свои программы, открытые проекты или те, на которые есть разрешение.
  • Агент не проверил себя сам. После сборки он честно написал, что не видел окно и не слышал звуков. Результат проверяет человек.
  • Доступ к вашему компьютеру. Установщик меняет настройки агентов, а сам агент ищет приложение в папке на рабочем столе. Установщик делает копии прежних настроек, но всё равно начинайте на отдельной машине или в отдельной папке.
  • Разрешения системы. В примере собранное приложение просило разрешение Accessibility в macOS. Выдавайте такие права только программам, которым доверяете.
  • Проект молодой. Он вышел недавно, развивается быстро, и меню установщика у вас может отличаться от скриншотов.
  • Копия не равна оригиналу. То, что агент не смог увидеть, он додумает. Просите его отдельно разделять, что доказано, что предположено, а что осталось скрытым.

Шаг 1. Проверяем Node.js

Сначала узнайте версию:

node -v

Нужна 24 или выше. Если версия старее, на Mac с Homebrew её обновляют так:

brew upgrade node

Шаг 2. Запускаем установку

В описании проекта есть раздел быстрого старта. Установка одной командой, Node.js и npm уже должны стоять:

npx rea-agents setup

По описанию, установщик предлагает выбрать агентов, показывает, какие изменения собирается внести, и ждёт вашего согласия. Он добавляет MCP-сервер REA и соответствующие инструкции для агента, а прежние настройки сохраняет в резервных копиях. После установки агента нужно перезапустить.

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

Шаг 3. Выбираем агентов

Установщик показывает список. Он сам находит агентов, которые уже стоят на компьютере. Управление такое: стрелки вверх и вниз для перемещения, пробел чтобы отметить, Enter чтобы подтвердить.

В примере отмечены Claude Code и Codex. В списке есть и другие, например Cursor, Gemini CLI, OpenCode, Windsurf. Выбирайте тех, кем действительно работаете.

Выбор агентов в установщике: отмечены Claude Code и Codex, остальные можно добавить
Выбор агентов в установщике: отмечены Claude Code и Codex, остальные можно добавить

Шаг 4. Ставим Hopper

Дальше установщик предлагает поставить Hopper для глубокого анализа. В примере ответ «да». После этого он показывает список из пяти изменений: установка Hopper как провайдера анализа, подключение выбранных агентов и добавление навыков для реверс-инжиниринга. Соглашаемся со всеми.

Сразу открывается окно Hopper. В нём можно ввести файл лицензии, купить её или запустить демо. В примере выбрано демо, нажата кнопка проверки автоматически, и компоненты встали.

Окно Hopper при первом запуске: выбираем пробный демо-режим вместо лицензии
Окно Hopper при первом запуске: выбираем пробный демо-режим вместо лицензии

В конце установщик подводит итог. Глубокий анализ идёт через Hopper, доступ получили выбранные агенты, а рабочие сценарии для разбора установлены. Готов и запуск без агента: npx rea-agents analyze /path/to/app, где вместо пути указывают папку приложения.

Итог установки: Hopper, доступ агентов и готовые сценарии разбора на месте
Итог установки: Hopper, доступ агентов и готовые сценарии разбора на месте

Шаг 5. Даём агенту задачу

Откройте агента в рабочей папке. В примере это Claude Code, команда claude. Для проекта лучше завести отдельную папку.

Claude Code запущен в папке проекта, готов принять задачу
Claude Code запущен в папке проекта, готов принять задачу

Теперь задача. Она устроена удачно: в ней четыре части, и каждая заставляет агента опираться на факты. Вот её смысл по-русски:

Найди Wispr Flow в папке Desktop. Используй REA, чтобы изучить приложение. Опирайся также на его официальный сайт. Проследи, как оно захватывает речь, получает результат расшифровки и вставляет текст в другие приложения. Объясни, что можно доказать по файлам приложения, что ты предполагаешь и что остаётся скрытым. Затем предложи небольшую рабочую версию, которую я мог бы собрать, включая нужные ей сервисы.

Обратите внимание на третью часть. Агента просят разделить доказанное, предполагаемое и неизвестное. Так вы видите, где копия опирается на факты, а где на догадки.

Текст задачи для агента: найти приложение, изучить через REA, описать устройство и предложить рабочую версию
Текст задачи для агента: найти приложение, изучить через REA, описать устройство и предложить рабочую версию

Дальше агент работает сам. Он нашёл приложение, разобрал его через Hopper и составил инструкцию для сборки. В ней четыре пункта: глобальная горячая клавиша Option+1, запись с микрофона, превращение звука в текст, вставка текста в приложение, где стоит курсор. После этого он собрал рабочую версию.

Шаг 6. Проверяем результат

Собранное приложение открылось на компьютере. В нём есть история расшифровок, раздел заметок и настройки. На главной странице написано, что голос остаётся на компьютере, а слова записываются локально, без интернета.

Готовая копия приложения: баннер «голос остаётся на Mac» и история расшифровок
Готовая копия приложения: баннер «голос остаётся на Mac» и история расшифровок

Что проверили в примере:

  • Горячая клавиша. Нажимаете Option+1, говорите, нажимаете снова, текст появляется в окне.
  • Два языка в одной фразе. Английский и китайский вперемешку расшифровались без переключения.
  • Заметки. Раздел для записей совещаний, можно открыть полный текст.
  • Скорость. Расшифровка идёт очень быстро, потому что работает локально.

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

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

Что это меняет

Если агент способен за короткое время разобрать и повторить готовый продукт, одного кода уже мало, чтобы защититься от копирования. Показательный пример в этой теме: проект PhotoCraft, нативное приложение на Rust с открытым кодом. Про него рассказывают как про клон пакета Adobe, написанный целиком на Rust.

Сайт PhotoCraft: редактор изображений на Rust с открытым исходным кодом
Сайт PhotoCraft: редактор изображений на Rust с открытым исходным кодом

Вывод такой: ценность смещается от кода к бренду, пользователям и данным. Код скопировать легко, а доверие клиентов и накопленные данные нельзя.

Как это применить в компании. Первое: выяснить устройство собственных старых программ, у которых нет документации. Второе: проверить свой продукт глазами агента и понять, что в нём легко повторить. Это идеи, а не результаты из примера, их нужно проверять на своих задачах.

Что дальше

Главная мысль REA не в самом реверс-инжиниринге. Она в том, что агенту надо давать не описание, а доказательства, и просить его отделять факты от догадок. Эту привычку стоит перенять в любых задачах с агентами.

Мы в Агентехе учим сотрудников ставить задачи агентам так, чтобы результат можно было проверить, и подключать к ним нужные инструменты. Как устроено обучение.

Написать в Telegram