Claude в Houdini на Windows без API-ключа: агент собрал жеоду из 31 ноды

Houdini, программа для 3D-графики и спецэффектов, слишком большая, чтобы знать её целиком. Поэтому автор CG Pipeline Lab периодически тестирует ИИ-агентов и давно изучает MCP, стандарт, через который агент подключается к программам: без доступа к софту агент мало полезен. В новом тесте он выбрал панель с чатом прямо в окне Houdini, потому что так удобнее записывать видео. Заодно её пришлось чинить.

Что понадобится для подключения?

• Компьютер на Windows с установленным Houdini.
• Подписка Claude Pro или Max.
• Утилита uvx для установки панели из командной строки.
• Панель houdini-agent-panel (открытая лицензия MIT, бесплатная). Под капотом у неё MCP-сервер fxhoudinimcp.
• Время на установку и запас терпения на ошибки, о них ниже.

Пошаговая инструкция: от установки до чата в окне Houdini

1. Установите панель командой:

uvx --from houdini-agent-panel python -m houdini_agent_panel install

1. Перезапустите Houdini.
2. Нажмите «+» на панели вкладок, выберите New Pane Tab Type, а затем Agent в самом низу списка.
3. В настройках панели нажмите Install напротив Claude Agent.
4. Получите токен для входа по подписке (токен здесь работает как одноразовый пропуск вместо пароля) и сохраните его в переменной Windows:

claude setup-token
setx CLAUDE_CODE_OAUTH_TOKEN sk-ant-oat01-…

Вместо многоточия вставьте свой токен целиком. После этого агент работает без API-ключа.

Что сломалось на Windows и кто это починил?

Первое, что встречает пользователя, это сообщение «токен истёк». Автор называет это обычной историей: токен нужно получить там, где это не всегда очевидно.

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

Похожее было весной с проектом houdini-mcp и агентом Codex на Windows. Те исправления уже приняли в проект, запрос oculairmedia/houdini-mcp#8. Деталь показательная: агент чинит инструмент, через который сам же подключается.

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

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

Агента нужно направлять, иначе он спрячет всё в код

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

Без указаний агент соберёт всё на Python в паре нод, и редактировать это станет невозможно. Однажды Claude при срочной правке выкинул ноды автора и заменил своими, с кодом внутри. Поэтому в промпте выше прямо сказано: ноды по одной, не одним скриптом.

Зато на рутине агент полезен. Когда понадобилось назначить много материалов (автор говорит о сотне, точное число не помнит), Claude назначил их все в Karma, встроенном рендере Houdini.

Без интерфейса агент работает через hython

В игровых проектах автор подключает агента не через MCP, а через hython. Это Python с модулем hou, он идёт вместе с Houdini и работает без интерфейса. Агент сам пишет скрипт, например build_scene.py, и запускает его через hython.exe из папки bin вашей установки Houdini, у автора это версия 22.0.368.

Такой путь удобен, когда проект не нужно править в самом окне Houdini.

Что делать с этим прямо сейчас, по ролям

Автору Дзена, который пишет про 3D: запись экрана с чатом агента внутри Houdini даёт готовый таймлапс. Автор CG Pipeline Lab выложил так всю сессию с жеодой на YouTube.

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

Предпринимателю из РФ и СНГ: доступность подписки Claude в России источник не обсуждает, проверьте оплату заранее. Из доступных в РФ языковых моделей есть YandexGPT и GigaChat, но готовых панелей для Houdini с ними источник не упоминает.

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