Claude no Houdini no Windows: dois bugs no painel do agente e uma geoda de 31 nós

Um agente sem acesso ao software serve para pouco. Por isso, o autor do Habr, que testa agentes de IA no Houdini com regularidade, conectou o Claude diretamente à janela do programa. No Windows, a integração não funcionou de primeira: foi preciso lidar com o token, as variáveis de ambiente e um servidor MCP que travava. O resultado, porém, é revelador: uma geoda procedural de 31 nós em cerca de 22 minutos de trabalho, com o vídeo acelerado aproximadamente 24 vezes.

Painel, MCP e login pela assinatura

O autor escolheu o painel houdini-agent-panel (licença MIT), ou seja, um chat com o agente dentro do Houdini. O motivo é prático: fica mais fácil gravar vídeo. Por baixo dos panos, roda o servidor MCP fxhoudinimcp.

A instalação funciona assim:

• executar `uvx --from houdini-agent-panel python -m houdini_agent_panel install`; • reiniciar o Houdini, clicar em «+» nas abas, escolher New Pane Tab Type → Agent (no fim da lista); • nas configurações do painel, clicar em Install ao lado de Claude Agent; • para entrar pela assinatura Claude Pro/Max sem chave de API, executar `claude setup-token` e depois `setx CLAUDE_CODE_OAUTH_TOKEN "sk-ant-oat01-…"`.

Do ponto de vista econômico, esse detalhe importa. O trabalho roda dentro de uma assinatura fixa, e não por tarifa de tokens. Para uma sessão longa, com dezenas de passos e capturas de tela do viewport, o custo fica bem mais previsível.

O que quebrou no Windows

O primeiro problema que o autor encontrou foi o aviso de «token expirado». Depois a situação piorou: segundo o autor, ninguém depura esse tipo de produto com muito cuidado. Quem achou as causas no código foi o Claude; o autor as verificou e enviou as correções.

Sintomas e soluções:

• 401 OAuth access token has expired logo após o setx. O agente usa o login antigo de ~/.claude/.

credentials.json. Para validar o novo token: `claude -p "reply with: ok"`.

• O Houdini não enxerga a variável após o setx. O Explorador de Arquivos e as janelas antigas do PowerShell continuam com o ambiente anterior. É preciso reiniciar o Explorador ou sair do Windows e entrar de novo.

• Ainda assim, 401. O painel lê as variáveis do login shell (/bin/sh), que não existe no Windows. Correção: MAY4VFX/houdini-agent-panel#46, em que o painel passa a ler HKCU\Environment.

• O agente responde, mas não tem as ferramentas do Houdini. O servidor MCP cai com No module named 'pywintypes', porque o .pth do pywin32 não é lido a partir do PYTHONPATH.

Correção: MAY4VFX/houdini-agent-panel#47. Manualmente, é preciso adicionar deps\py3.13\win32 e win32\lib ao HAP_MCP_PATH no arquivo Documents\houdini22.

0\packages\houdini_agent_panel.json.

Na primavera, o autor passou por algo parecido com houdini-mcp e Codex no Windows. Essas correções já foram aceitas no projeto: oculairmedia/houdini-mcp#8.

A geoda como teste

Para o teste, o próprio Claude sugeriu um asteroide, mas o resultado saiu «meio estranho», e a escolha passou para a geoda. A tarefa: uma «noz» de pedra partida ao meio, com um aglomerado de cristais de ametista por dentro. O prompt exigia que o agente trabalhasse mantendo a rede sempre visível, criasse os nós um por vez, desse nomes claros a eles, delimitasse as etapas com network box, colorisse as caixas e conferisse o resultado com capturas de tela.

As etapas foram estas:

• casca: esfera → ruído → VDB → casca oca → polígonos; • corte: fatia por um plano irregular, com borda serrilhada; • cristais: pontos no interior, direção pela normal, cristais curtos junto às paredes e longos rumo ao centro, cristal hexagonal com ponta aguda, copy to points; • cor: pedra cinza-amarronada, faixas claras de ágata no corte, cristais do roxo-escuro até pontas claras; • final: tudo em OUT, viewport no ângulo do corte.

A geoda em si, nas palavras do autor, não empolga. O que surpreendeu foi outra coisa: o Claude percebeu e corrigiu os próprios erros, embora nessa etapa normalmente seja preciso chamar o Codex, porque a visão do Claude deixa a desejar.

Como o autor trabalha de fato

Um agente no Houdini lembra um júnior que leu a internet inteira. Até pouco tempo atrás, ele não conseguia montar nem um cilindro simples de polígonos, e o autor testou isso com Claude, ChatGPT, Perplexity e outros. O essencial é guiá-lo. Do contrário, ele monta tudo em Python dentro de poucos nós, e editar o resultado se torna impossível. Uma vez, o Claude descartou os nós do autor e os substituiu pelos seus, com Python dentro. Em compensação, o agente é útil nas tarefas de rotina: por exemplo, atribuiu cem materiais no Karma.

Nos jogos, o autor usa hython, e não MCP. Trata-se do Python com o módulo hou, que roda sem interface: `& "C:\Program Files\Side Effects Software\Houdini 22.0.368\bin\hython.exe" build_scene.py`. O agente escreve o script e o executa sozinho. Isso é conveniente quando não é preciso editar o projeto no próprio Houdini.

Conclusões práticas

O agente conectado pode executar qualquer código Python no seu Houdini, e a conexão não tem senha. Por isso, só vale usar essa integração na sua própria máquina de trabalho. Cada ação do agente é um passo de undo separado, o que facilita desfazer alterações.

A ordem prática é esta: primeiro, validar o token com o comando `claude -p`; depois, confirmar que o Houdini enxerga a variável de ambiente; só então investigar o MCP. Para tarefas de rotina, como atribuir materiais em massa, o agente funciona bem. Para a estrutura do projeto, é melhor definir regras explícitas: nós um por vez, nomes claros, nenhum Python dentro. Em tarefas autônomas, sem edição da cena na interface, o hython é mais simples e mais confiável que o MCP.