Claude в Houdini на Windows: как подключить агента и что по дороге сломалось

Весь Houdini знать невозможно — поэтому я периодически тестирую AI‑агентов. Тему MCP изучаю давно: агент без доступа к софту мало полезен.

Почему панель

Панель внутри Houdini я выбрал потому, что так удобнее записывать видео. Заодно пришлось её отремонтировать.

Как сделать. Панель — 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-…"

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

Первое, что встречает, — «токен истёк». Обычная история: токен нужно получить где‑то, где это не всегда очевидно.

Дальше хуже. Такие продукты никто особо не отлаживает, и из коробки они работают не всегда. Причины в коде нашёл Claude, а я проверил и отправил исправления авторам.

Как сделать — грабли на Windows и что с ними делать:

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

Жеода

Для проверки Claude сам предложил астероид, но он получился какой‑то не такой, и мы переключились на жеоду.

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

Как сделать — промпт из видео:

Построй в /obj/geode процедурную жеоду: каменный «орех», расколотый пополам,
внутри друза кристаллов аметиста.
Сразу открой /obj/geode в Network Editor и работай так, чтобы сеть всегда была видна.
Ноды создавай по одной, не одним скриптом. Нодам давай понятные имена.
После каждого этапа: разложи сеть, обведи ноды этапа network box с подписью,
покрась их в свой цвет, поставь display на последнюю ноду и проверь себя скриншотом вьюпорта.

1. ОБОЛОЧКА: сфера → шум (неровный камень, не шар) → VDB → полая оболочка → полигоны.
2. РАСКОЛ: срез примерно пополам неровной плоскостью, край скола рваный.
3. КРИСТАЛЛЫ: точки внутри → направление по нормали, у стенок короткие, к центру длинные →
   шестигранный кристалл с острой верхушкой → copy to points.
4. ЦВЕТ: серо-бурый камень, светлые полосы агата на срезе, кристаллы от тёмно-фиолетового
   у основания к светлым кончикам.
5. ФИНАЛ: всё в OUT, вьюпорт на красивый ракурс среза.

Если нода падает с ошибкой — найди причину и почини, не начинай заново.
В конце: сколько нод получилось и где ошибался.

Итог в видео: 31 нода, около 22 минут, ускорено примерно в 24 раза.

Что такое агент в Houdini

Агент — это джуниор, который прочитал весь интернет 😃 С каждой версией он становится лучше. Ещё недавно для него было проблемой построить обычный цилиндр из полигонов — ничего особенного, а не мог. Я проверял это на Claude, ChatGPT, Perplexity и ещё на ком‑то.

Главное — агента надо направлять. Иначе он соберёт всё на питоне в паре нод, и редактировать это будет невозможно. Однажды мне нужно было быстро поправить проект, а Claude выкинул мои ноды и заменил их своими — с питоном внутри.

Зато на рутине он очень полезен. Например, когда нужно накинуть сотню материалов. Не помню точно, сколько их было, но много — Claude назначил их все в Karma.

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

В играх я агента использую, но не через MCP, а через hython: Claude работает с Houdini из скриптов. Особенно это удобно, когда не нужно править проект в самом Houdini.

Как сделать. hython — Python с модулем hou, который идёт с Houdini и работает без интерфейса. Агент пишет скрипт и запускает его сам:

& "C:\Program Files\Side Effects Software\Houdini 22.0.368\bin\hython.exe" build_scene.py

Совет

Не ждите, что агент сделает всё за вас. Хотя пару раз такое бывало: один раз это был простой проект в Houdini, второй — простая карточная игра (YUI в Telegram).

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