Claude en Houdini sobre Windows: dos bugs en el panel del agente y una geoda de 31 nodos

Un agente sin acceso al software sirve de poco, así que el autor de Habr, que prueba con regularidad agentes de IA en Houdini, conectó Claude directamente a la ventana del programa. En Windows la combinación no funcionó de entrada: hubo que lidiar con el token, las variables de entorno y un servidor MCP que se caía. El resultado, en cambio, es ilustrativo: una geoda procedural de 31 nodos en unos 22 minutos de trabajo, con el vídeo acelerado aproximadamente 24 veces.

El panel, MCP y el acceso por suscripción

El autor eligió el panel houdini-agent-panel (licencia MIT), es decir, un chat con el agente dentro de Houdini. La razón es práctica: resulta más cómodo para grabar vídeo. Por debajo funciona el servidor MCP fxhoudinimcp.

La instalación es así:

• ejecutar `uvx --from houdini-agent-panel python -m houdini_agent_panel install`; • reiniciar Houdini, pulsar «+» en las pestañas y elegir New Pane Tab Type → Agent (al final de la lista); • en los ajustes del panel, pulsar Install junto a Claude Agent; • para entrar con la suscripción Claude Pro/Max sin clave de API, ejecutar `claude setup-token` y luego `setx CLAUDE_CODE_OAUTH_TOKEN "sk-ant-oat01-…"`.

Desde el punto de vista económico, este detalle es importante. El trabajo se enmarca en una suscripción fija, no en una tarifa por tokens. En una sesión larga, con decenas de pasos y capturas del viewport, resulta bastante más predecible.

Qué se rompió en Windows

Lo primero con lo que se topó el autor fue «el token ha caducado». Después la cosa empeoró: según el autor, nadie depura demasiado este tipo de productos. Las causas en el código las encontró Claude; el autor las verificó y envió las correcciones.

Síntomas y soluciones:

• 401 OAuth access token has expired justo después de setx. El agente toma el acceso antiguo de ~/.claude/.

credentials.json. Para comprobar el token nuevo: `claude -p "reply with: ok"`.

• Houdini no ve la variable tras setx. El Explorador y las ventanas antiguas de PowerShell siguen con el entorno anterior. Hay que reiniciar el Explorador o cerrar sesión en Windows.

• Sigue el 401. El panel toma las variables del login shell (/bin/sh), que no existe en Windows. Corrección: MAY4VFX/houdini-agent-panel#46, el panel lee HKCU\Environment.

• El agente responde, pero no tiene herramientas de Houdini. El servidor MCP se cae con No module named 'pywintypes', porque el .pth de pywin32 no se lee desde PYTHONPATH.

Corrección: MAY4VFX/houdini-agent-panel#47. A mano hay que añadir deps\py3.13\win32 y win32\lib a HAP_MCP_PATH en el archivo Documents\houdini22.

0\packages\houdini_agent_panel.json.

En primavera, el autor vivió algo parecido con houdini-mcp y Codex en Windows. Esas correcciones ya se han aceptado en el proyecto: oculairmedia/houdini-mcp#8.

La geoda como prueba

Para la prueba, el propio Claude propuso un asteroide, pero salió «algo raro», y pasaron a una geoda. El encargo: una «nuez» de piedra partida por la mitad, con una drusa de cristales de amatista en su interior. El prompt exigía trabajar de modo que la red estuviera siempre visible, crear los nodos de uno en uno, darles nombres claros, rodear las etapas con network box, colorearlas y comprobarse con una captura de pantalla.

Las etapas fueron estas:

• corteza: esfera → ruido → VDB → corteza hueca → polígonos; • corte: sección con un plano irregular de borde desgarrado; • cristales: puntos en el interior, dirección según la normal, cortos junto a las paredes y largos hacia el centro, cristal hexagonal con punta afilada, copy to points; • color: piedra gris parduzca, bandas claras de ágata en el corte, cristales de violeta oscuro a puntas claras; • final: todo en OUT, viewport con el encuadre del corte.

La geoda en sí, según reconoce el autor, no despierta grandes emociones. Lo que sorprendió fue otra cosa: Claude detectó y corrigió sus propios errores, aunque normalmente en esta fase hay que recurrir a Codex, porque la visión de Claude es mediocre.

Cómo trabaja realmente el autor

Un agente en Houdini se parece a un júnior que se ha leído todo internet. Hace poco aún era incapaz de construir un cilindro normal con polígonos, y el autor lo comprobó con Claude, ChatGPT, Perplexity y otros. Lo principal es guiarlo. De lo contrario, lo montará todo en Python dentro de un par de nodos y será imposible editarlo. En una ocasión, Claude eliminó los nodos del autor y los sustituyó por los suyos, con Python dentro. En cambio, en tareas rutinarias el agente es útil: por ejemplo, asignó un centenar de materiales en Karma.

Para los videojuegos, el autor no usa MCP, sino hython, es decir, Python con el módulo hou, que funciona sin interfaz: `& "C:\Program Files\Side Effects Software\Houdini 22.0.368\bin\hython.exe" build_scene.py`. El agente escribe el script y lo ejecuta por sí mismo. Es cómodo cuando no hace falta editar el proyecto en el propio Houdini.

Conclusiones prácticas

Un agente conectado puede ejecutar cualquier código Python en tu Houdini, y la conexión no tiene contraseña. Conviene usar esta combinación solo en tu propio equipo de trabajo. Además, cada acción del agente es un paso de undo independiente, lo que facilita deshacer cambios.

El orden práctico es este: primero comprobar el token con el comando `claude -p`, después asegurarse de que Houdini ve la variable de entorno y solo entonces ocuparse de MCP. Para tareas rutinarias, como la asignación masiva de materiales, el agente sirve. Para la estructura del proyecto, es mejor fijar las reglas de forma explícita: nodos de uno en uno, nombres claros, nada de Python dentro. Para tareas autónomas sin editar la escena en la interfaz, hython es más sencillo y fiable que MCP.