17 октября 2026 г.

Claude Code собрал океан в 61 КБ: что внутри и как запустить

Андрей Присекин
Автор

Андрей Присекин

Создаю AI-агентов, автоматизирую бизнес-процессы

Разработчик собрал с Claude Code интерактивный океан в одном HTML-файле размером около 61 КБ. Внутри - симуляция волн на WebGPU, закатное небо и камера, которой можно управлять. Демо открывается в браузере, исходники доступны. Для запуска нужен браузер с WebGPU и подходящая видеокарта; цифры скорости автора не стоит принимать за обещание для своего ноутбука.

Меня здесь зацепила не история про «один волшебный промпт». Автор описал цикл, в котором агент делал скриншоты сцены, а отдельные агенты критиковали результат. Я скачал репозиторий, посмотрел сборку и собрал её локально. Теперь можно разложить по полкам, что лежит в этих килобайтах, почему океан двигается и где заканчиваются доказательства красивого демо.

Что на самом деле помещается в 61 КБ

Проект называется web-ocean. В репозитории лежат два готовых файла: читаемый ocean.html и сжатый ocean.min.html. Второй занимает 62 236 байт на диске - это примерно 61 КиБ в привычном округлении автора. Оба файла самодостаточны: HTML, CSS, JavaScript и текст шейдеров для видеокарты находятся внутри. Дополнительный движок при открытии страницы не скачивается.

Но «61 КБ» не означает, что весь проект состоит из 61 КБ исходного кода. В отдельных папках лежат исходники JavaScript и шейдеров; build.mjs собирает их в страницу и удаляет лишние пробелы, комментарии и часть длинных имён. Сжатый файл удобен, чтобы переслать демо или открыть его без развёрнутой инфраструктуры. Если хочешь разобраться в физике воды или что-то поправить, открывай исходники, а не одну длинную строку минифицированного файла.

Я запустил в скачанной копии npm ci и npm run build: скрипт повторно создал обе страницы, размер ocean.min.html остался 62 236 байт. Это проверка воспроизводимости сборки, а не независимое подтверждение частоты кадров или красоты картинки на каждом устройстве. Их нужно проверять в браузере с работающим WebGPU.

После минификации самодостаточный HTML-файл уменьшился со 102 до 61 КБ

Почему волны выглядят как вода, а не как ковёр

Обычная анимация воды быстро выдаёт себя: одинаковые гребни повторяются, мелкая рябь не связана с крупной, отражение солнца стоит на месте. Здесь автор описывает другую механику. Поверхность собирается из нескольких масштабов волн: большие задают движение моря вдали, маленькие меняют блики рядом с камерой. В README указаны шесть каскадов сетки по 256 на 256 отсчётов. Это описание реализации автора, а не моя оценка её физической точности.

За словами «FFT-океан» стоит вычислительный трюк. Сначала задаёшь спектр волн: сколько энергии приходится на разные направления и длины. Затем обратное быстрое преобразование Фурье превращает это описание в высоты поверхности на сетке. Повторяешь расчёт во времени - получаешь движущуюся воду. Такой подход известен задолго до нейросетей; его подробно разбирал Джерри Тессендорф в работе Simulating Ocean Water. Claude здесь написал реализацию, а не изобрёл метод.

Одной высоты волны для картинки мало. Шейдеру нужны направление наклона поверхности, отражение неба, пенистые вершины и понимание, как мелкая рябь выглядит издалека. В исходниках проекта есть отдельные модули для симуляции, неба, поверхности и обработки готового кадра. По описанию автора, пена появляется на крутых гребнях, а солнечные блики меняются вместе с наклоном маленьких волн. Я бы не выдавал подробные названия физических моделей из README за независимую экспертизу: важен проверяемый факт, что код делит эту работу на разные стадии.

Схема от спектра волн через обратное FFT и поверхность к бликам на воде

При чём тут WebGPU и почему нужен нормальный компьютер

WebGPU даёт веб-странице доступ к видеокарте для вычислений и вывода сложной графики. Здесь часть работы выполняют вычислительные шейдеры: они рассчитывают состояние волн, пока графический конвейер готовит изображение. Браузер становится местом запуска программы, но работу всё равно делает GPU. Маленький HTML-файл не превращает старый офисный ноутбук в игровую видеокарту.

По документации Chrome поддержка WebGPU зависит от браузера, операционной системы, драйвера и видеокарты. Актуальный Chrome с включённым аппаратным ускорением - разумная первая попытка. На ноутбуке со встроенной и дискретной графикой проверь, какая из них досталась браузеру. Если страница чёрная или показывает ошибку инициализации, сначала проверь поддержку WebGPU и драйвер, а уже потом обвиняй файл в поломке.

Автор сообщает о времени GPU примерно 6-8 миллисекунд на кадр при разрешении 2560 на 1440 на RTX 5070 Ti. В исходном Reddit-посте он также называл около 260 кадров в секунду в своём сценарии. Не смешивай эти измерения в универсальный тест производительности: время одного участка GPU и итоговый FPS всей страницы - разные показатели, а браузер, настройки и фоновые программы меняют результат. Своего замера на аналогичном железе я не проводил.

Как Claude Code проверял собственную картинку

По словам автора проекта, стартовая просьба была простой: сделать максимально реалистичную воду на WebGPU со свободно плавающей камерой. Архитектуру и реализацию он оставил Claude Code с моделью Opus 5.5. Потом агент открывал результат в безголовом Chrome и делал скриншоты. Отдельные субагенты смотрели на эти кадры и давали замечания. Человек тоже вмешивался, особенно по облакам.

Это важная граница для тех, кто строит визуальные продукты с ИИ. Код может успешно собраться, а море всё равно будет выглядеть пластиком. Скриншот даёт агенту наблюдение о настоящем результате, которого нет в исходном запросе. Отдельный критик может заметить изъян, который автор кода проигнорировал, хотя это не гарантия независимости: все участники могут разделять одну и ту же ошибку. В документации Anthropic о субагентах такие помощники описаны как отдельные рабочие контексты с назначенной задачей и своими инструментами. Конкретный ход этой сессии мы знаем только из рассказа разработчика.

Хороший пример - облака. Автор пишет, что после замечаний от сложного объёмного варианта отказались в пользу двух плоских слоёв, а затем исправляли рваные края. То есть критика привела к смене решения, а не к очередному комплименту «выглядит отлично». У автора в разделе ограничений по-прежнему указано: объёмных облаков нет, у воды нет берега и объектов. Я больше доверяю демо, у которого явно перечислены недоделки, чем ролику, где каждый пиксель объявлен победой нейросети.

Как открыть демо и проверить исходники

Самый короткий путь - открыть готовую страницу автора в Chrome и посмотреть, запускается ли она на твоём компьютере. Нажми на сцену, чтобы захватить курсор; мышью осматривайся, W A S D двигайся, H открывай настройки ветра, волн и света, Esc освобождай мышь. Если хочется изучать код без установки инструментов, на GitHub есть исходные файлы в папке js/ и собранные HTML-версии.

Для локальной копии я использовал такой путь:

git clone https://github.com/Noniv/web-ocean.git
cd web-ocean
npm ci
npm run build
npm start

После запуска npm start проект по README доступен на http://localhost:8080/. Сборка создаёт ocean.html и ocean.min.html; их можно открыть и прямо с диска, если браузер разрешает WebGPU для локальной страницы. Репозиторий распространяется под MIT, но перед переносом чужого кода в коммерческий проект всё равно прочитай файл LICENSE и сохрани требуемое уведомление. Никакие аккаунты или API-ключи для просмотра готовой сцены не нужны.

Отдельно проверь, что ты действительно видишь WebGPU, а не пустой чёрный холст. Покрути ветер и солнце в меню H, посмотри, меняются ли вода и блики. Только после этого имеет смысл смотреть на счётчик FPS и сравнивать режимы на своём железе. Скриншот с чужой RTX здесь не заменит собственного теста.

Где этот приём пригодится тебе

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

Есть и урок про размер файла. Один HTML удобен, когда хочется отправить человеку самостоятельное демо без установки зависимостей. Но при разработке лучше сохранить нормальную структуру проекта: исходники, сборочный скрипт и читаемые изменения в Git. Здесь обе формы лежат рядом. Такой подход куда практичнее, чем пытаться поддерживать минифицированную строку вручную.

Рядом в блоге уже есть история о Pokémon Red, собранном Claude. Там вопрос - может ли агент вытянуть большую игру без готовых картинок. Здесь меня интересует другое: как получить правдоподобную движущуюся графику через шейдеры и как её проверять глазами в цикле разработки. Я бы забрал именно этот способ работы, даже если океан мне в собственном продукте никогда не понадобится.

Источники

← Все статьи