Claude dans Houdini sous Windows : deux bugs dans le panneau d'agent et une géode de 31 nœuds

Un agent sans accès au logiciel n'est guère utile. L'auteur de Habr, qui teste régulièrement des agents IA dans Houdini, a donc connecté Claude directement à la fenêtre du programme. Sous Windows, l'association n'a pas fonctionné d'emblée : il a fallu s'occuper du jeton, des variables d'environnement et d'un serveur MCP qui plantait. Le résultat est en revanche parlant : une géode procédurale de 31 nœuds en environ 22 minutes de travail, avec une vidéo accélérée d'environ 24 fois.

Panneau, MCP et connexion par abonnement

L'auteur a choisi le panneau houdini-agent-panel (licence MIT), c'est-à-dire un chat avec l'agent à l'intérieur de Houdini. La raison est pratique : c'est plus commode pour enregistrer des vidéos. Le serveur MCP fxhoudinimcp fait tourner l'ensemble en coulisses.

Voici comment se déroule l'installation :

• exécuter `uvx --from houdini-agent-panel python -m houdini_agent_panel install` ; • redémarrer Houdini, cliquer sur « + » dans les onglets, choisir New Pane Tab Type → Agent (tout en bas de la liste) ; • dans les réglages du panneau, cliquer sur Install en face de Claude Agent ; • pour se connecter avec un abonnement Claude Pro/Max sans clé API, exécuter `claude setup-token`, puis `setx CLAUDE_CODE_OAUTH_TOKEN "sk-ant-oat01-…"`.

C'est un détail important sur le plan économique. Le travail s'effectue dans le cadre d'un abonnement fixe, et non à la tarification au token. Pour une longue session de dizaines d'étapes avec des captures d'écran du viewport, le coût est nettement plus prévisible.

Ce qui a cassé sous Windows

La première chose à laquelle l'auteur s'est heurté, c'est « token expiré ». Ensuite, cela s'est aggravé : selon lui, personne ne débogue vraiment ce type de produits. Claude a trouvé les causes dans le code ; l'auteur les a vérifiées et a envoyé les correctifs.

Symptômes et solutions :

• 401 OAuth access token has expired juste après setx. L'agent utilise l'ancienne connexion stockée dans ~/.claude/.

credentials.json. Pour tester le nouveau jeton : `claude -p "reply with: ok"`.

• Houdini ne voit pas la variable après setx. L'Explorateur et les anciennes fenêtres PowerShell fonctionnent avec l'ancien environnement. Il faut redémarrer l'Explorateur ou fermer la session Windows.

• Toujours un 401. Le panneau lit les variables depuis le login shell (/bin/sh), qui n'existe pas sous Windows. Correctif : MAY4VFX/houdini-agent-panel#46, le panneau lit HKCU\Environment.

• L'agent répond, mais n'a aucun outil Houdini. Le serveur MCP plante avec No module named 'pywintypes', car le .pth de pywin32 n'est pas lu depuis PYTHONPATH.

Correctif : MAY4VFX/houdini-agent-panel#47. À la main, il faut ajouter deps\py3.13\win32 et win32\lib à HAP_MCP_PATH dans le fichier Documents\houdini22.

0\packages\houdini_agent_panel.json.

Au printemps, l'auteur avait connu des problèmes similaires avec houdini-mcp et Codex sous Windows. Ces correctifs ont déjà été acceptés dans le projet : oculairmedia/houdini-mcp#8.

La géode comme test

Pour le test, Claude a lui-même proposé un astéroïde, mais le résultat était « pas tout à fait ça », et ils sont passés à une géode. La consigne : une « noix » de pierre fendue en deux, avec à l'intérieur une druse de cristaux d'améthyste. Le prompt exigeait de travailler de façon à ce que le réseau reste toujours visible, de créer les nœuds un par un, de leur donner des noms explicites, d'entourer les étapes avec des network box, de les colorer et de se vérifier par capture d'écran.

Les étapes étaient les suivantes :

• coque : sphère → bruit → VDB → coque creuse → polygones ; • fracture : coupe par un plan irrégulier avec un bord déchiqueté ; • cristaux : points à l'intérieur, direction selon la normale, cristaux courts près des parois et longs vers le centre, cristal hexagonal à sommet pointu, copy to points ; • couleur : pierre gris-brun, bandes claires d'agate sur la coupe, cristaux allant du violet foncé à des pointes claires ; • final : tout dans OUT, viewport cadré sur l'angle de la coupe.

De l'aveu de l'auteur, la géode elle-même ne suscite pas d'émotion particulière. Autre chose l'a surpris : Claude a lui-même repéré et corrigé ses erreurs, alors qu'à ce stade, il faut d'ordinaire faire intervenir Codex, car la vision de Claude est plutôt médiocre.

Comment l'auteur travaille réellement

Un agent dans Houdini ressemble à un junior qui aurait lu tout Internet. Il y a peu encore, il était incapable de construire un simple cylindre en polygones, et l'auteur l'a vérifié avec Claude, ChatGPT, Perplexity et d'autres. L'essentiel est de le guider. Sinon, il assemble tout en Python dans quelques nœuds, et il devient impossible de modifier le résultat. Un jour, Claude a jeté les nœuds de l'auteur pour les remplacer par les siens, avec du Python à l'intérieur. En revanche, l'agent est utile pour les tâches routinières : il a par exemple assigné une centaine de matériaux dans Karma.

Pour les jeux, l'auteur n'utilise pas MCP mais hython, c'est-à-dire Python avec le module hou, qui s'exécute sans interface : `& "C:\Program Files\Side Effects Software\Houdini 22.0.368\bin\hython.exe" build_scene.py`. L'agent écrit le script et le lance lui-même. C'est pratique quand il n'y a pas besoin de modifier le projet dans Houdini même.

Conclusions pratiques

L'agent connecté peut exécuter n'importe quel code Python dans votre Houdini, et la connexion n'est protégée par aucun mot de passe. Il ne faut utiliser cette association que sur sa propre machine de travail. Chaque action de l'agent constitue en outre une étape d'annulation (undo) distincte, ce qui facilite le retour en arrière.

L'ordre pratique est le suivant : vérifier d'abord le jeton avec la commande `claude -p`, s'assurer ensuite que Houdini voit la variable d'environnement, et seulement après s'occuper de MCP. Pour les tâches routinières comme l'assignation massive de matériaux, l'agent convient. Pour la structure du projet, mieux vaut fixer des règles explicites : nœuds un par un, noms clairs, pas de Python à l'intérieur. Pour les tâches autonomes sans modification de la scène dans l'interface, hython est plus simple et plus fiable que MCP.