Claude в Houdini на Windows: два бага в панели агента и жеода за 31 ноду

Агент без доступа к софту мало полезен, поэтому автор Habr, который регулярно тестирует ИИ-агентов в Houdini, подключил Claude прямо в окно программы. Из коробки на Windows связка не завелась: пришлось разбираться с токеном, переменными окружения и падающим MCP-сервером. Зато итог показательный: процедурная жеода из 31 ноды за около 22 минут работы, видео ускорено примерно в 24 раза.

Панель, MCP и вход по подписке

Автор выбрал панель houdini-agent-panel (лицензия MIT), то есть чат с агентом внутри Houdini. Причина практическая: так удобнее записывать видео. Под капотом работает MCP-сервер fxhoudinimcp.

Установка выглядит так:

• выполнить `uvx --from houdini-agent-panel python -m houdini_agent_panel install`; • перезапустить Houdini, нажать «+» на вкладках, выбрать New Pane Tab Type → Agent (в самом низу списка); • в настройках панели нажать Install напротив Claude Agent; • для входа по подписке Claude Pro/Max без API-ключа выполнить `claude setup-token`, затем `setx CLAUDE_CODE_OAUTH_TOKEN "sk-ant-oat01-…"`.

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

Что сломалось на Windows

Первое, что встретило автора, это «токен истёк». Дальше стало хуже: по словам автора, такие продукты никто особо не отлаживает. Причины в коде нашёл Claude, автор проверил их и отправил исправления.

Симптомы и решения:

• 401 OAuth access token has expired сразу после setx. Агент берёт старый вход из ~/.claude/.credentials.json. Проверка нового токена: `claude -p "reply with: ok"`. • Houdini не видит переменную после setx. Проводник и старые окна PowerShell живут со старым окружением. Нужно перезапустить Проводник или выйти из Windows. • Всё равно 401. Панель берёт переменные из login shell (/bin/sh), которого на Windows нет. Исправление: MAY4VFX/houdini-agent-panel#46, панель читает HKCU\Environment. • Агент отвечает, но инструментов Houdini у него нет. MCP-сервер падает с No module named 'pywintypes', потому что .pth pywin32 не читается из PYTHONPATH. Исправление: MAY4VFX/houdini-agent-panel#47. Вручную нужно добавить deps\py3.13\win32 и win32\lib в HAP_MCP_PATH в файле Documents\houdini22.0\packages\houdini_agent_panel.json.

Весной у автора было похожее с houdini-mcp и Codex на Windows. Те исправления уже приняты в проект: oculairmedia/houdini-mcp#8.

Жеода как тест

Для проверки Claude сам предложил астероид, но тот получился «какой-то не такой», и перешли на жеоду. Задача: каменный «орех», расколотый пополам, внутри друза кристаллов аметиста. Промпт требовал работать так, чтобы сеть всегда была видна, создавать ноды по одной, давать им понятные имена, обводить этапы network box, красить их и проверять себя скриншотом.

Этапы были такие:

• оболочка: сфера → шум → VDB → полая оболочка → полигоны; • раскол: срез неровной плоскостью с рваным краем; • кристаллы: точки внутри, направление по нормали, у стенок короткие, к центру длинные, шестигранный кристалл с острой верхушкой, copy to points; • цвет: серо-бурый камень, светлые полосы агата на срезе, кристаллы от тёмно-фиолетового к светлым кончикам; • финал: всё в OUT, вьюпорт на ракурсе среза.

Сама жеода, по признанию автора, особых эмоций не вызывает. Удивило другое: Claude сам заметил и поправил свои ошибки, хотя обычно на этом этапе приходится подключать Codex, потому что зрение у Claude так себе.

Как автор работает на самом деле

Агент в Houdini похож на джуниора, который прочитал весь интернет. Ещё недавно он не мог построить обычный цилиндр из полигонов, и автор проверял это на Claude, ChatGPT, Perplexity и других. Главное — направлять его. Иначе он соберёт всё на Python в паре нод, и редактировать это будет невозможно. Однажды Claude выкинул ноды автора и заменил своими, с Python внутри. Зато на рутине агент полезен: например, он назначил сотню материалов в Karma.

В играх автор использует не MCP, а hython, то есть Python с модулем hou, который работает без интерфейса: `& "C:\Program Files\Side Effects Software\Houdini 22.0.368\bin\hython.exe" build_scene.py`. Агент пишет скрипт и запускает его сам. Это удобно, когда проект не нужно править в самом Houdini.

Практические выводы

Подключённый агент может выполнить любой Python в вашем Houdini, а пароля на подключение нет. Использовать связку стоит только на своей рабочей машине. Каждое действие агента при этом является отдельным шагом undo, что облегчает откат.

Практический порядок такой: сначала проверить токен командой `claude -p`, затем убедиться, что Houdini видит переменную окружения, и только потом разбираться с MCP. Для рутины вроде массового назначения материалов агент годится. Для структуры проекта лучше задавать правила явно: ноды по одной, понятные имена, никакого Python внутри. Для автономных задач без правки сцены в интерфейсе hython проще и надёжнее MCP.