Criar modelos 3D com o Claude AI e o Blender — da conversa ao ficheiro .blend

Descarregue o Blender em blender.org: é gratuito, de código aberto (licença GPL) e funciona em Windows, macOS e Linux. Instale a versão 4.0 ou mais recente. O Blender inclui um interpretador Python completo e uma API Python abrangente que permite programar cada operação do programa. É isso que o Claude usa para criar modelos 3D: cada botão, menu e ferramenta do Blender tem um equivalente em Python.

Depois da instalação, abra o Blender uma vez para confirmar que arranca. Verá a cena inicial predefinida com um cubo, uma câmara e uma luz. Feche-o: no fluxo de trabalho com IA, o Blender será controlado remotamente.

Há duas formas de ligar o Claude ao Blender. Escolha a que se adequa à sua configuração:

Método A — Servidor Blender MCP (Claude Desktop): instale no Blender um suplemento Model Context Protocol (MCP) que o transforma num servidor local. O Claude Desktop liga-se diretamente a ele e pode executar código Python, fazer capturas da vista e ler a informação da cena, enquanto vê o modelo a ser construído em tempo real na janela do Blender.

Método B — API do Blender sem interface (Claude Code): execute o Blender em modo sem interface (sem GUI), envolvido por um servidor FastAPI. O Claude Code envia scripts Python por HTTP, o Blender executa-os e devolve os ficheiros gerados. É mais rápido para trabalho em lote e corre num servidor remoto, mas não vê a vista ao vivo: revê depois o ficheiro .blend terminado.

O método A é melhor para design interativo, quando quer ver cada alteração. O método B é melhor para processos automatizados, geração no servidor e trabalho sem ecrã.

Instale o suplemento Blender MCP a partir do GitHub (o projeto 'blender-mcp', que lhe chama MCP for Blender; o suplemento corre dentro do Blender um servidor com o qual o Claude pode comunicar). Descarregue o ficheiro addon.py. No Blender: Edit → Preferences → Add-ons → Install… → selecione addon.py e ative 'Interface: MCP for Blender'. Na vista 3D, prima N para abrir a barra lateral e selecione o separador MCP for Blender.

Clique em 'Start MCP Server'. O Blender está agora à espera de ligações do Claude. Nas definições do Claude Desktop, adicione o servidor Blender MCP como fonte de ferramentas (o README do projeto indica o excerto de configuração). Depois de ligado, o Claude tem acesso a ferramentas como execute_blender_code, get_scene_info e get_viewport_screenshot: tudo o que é preciso para desenhar modelos 3D em conversa.

Crie um servidor FastAPI que envolva o Blender sem interface. O servidor aceita scripts Python através de um endpoint POST /execute, executa-os no modo de segundo plano do Blender (blender --background --python) e devolve os ficheiros gerados. Um servidor mínimo precisa apenas de um endpoint:

Escreva o código Python recebido do Claude num ficheiro de um diretório de trabalho, por exemplo job.py, e execute-o com: blender --background --python job.py. Guarde o ficheiro .blend resultante no diretório de trabalho e disponibilize-o através de um endpoint GET /files. O Claude Code chama estes endpoints HTTP para enviar scripts e obter os ficheiros do modelo terminado.

É a mesma arquitetura usada nos processos de geração de imagens com IA (ComfyUI): uma ferramenta criativa sem interface envolvida por uma API, a correr num servidor com acesso a GPU.

Diga ao Claude o que quer construir, em linguagem simples. Seja específico quanto a dimensões, materiais e propriedades físicas. Por exemplo:

'Desenha uma cabeça de martelo de ferreiro de pena transversal de 1 kg. A face de impacto deve ser um quadrado arredondado e a pena deve ser horizontal (fina em Z, larga em Y) para empurrar o metal. Acrescenta as runas do futhark antigo ᚦᛟᚱ (TOR) gravadas a 3 mm de profundidade nos dois lados planos. Dimensiona a geometria para que o volume seja exatamente 127,4 cm³ (1 kg de aço temperado com densidade de 7850 kg/m³). Inclui um olho oval para o cabo.'

O Claude traduzirá esta descrição numa sequência de operações Python para o Blender. Quanto mais precisa for a descrição, mais a primeira versão se aproximará do que pretende. Use medidas reais (milímetros, gramas, graus) em vez de termos relativos ('faz maior').

O Claude cria um script Python que usa a API Python do Blender (módulo bpy) para construir o modelo. Uma sequência típica para a cabeça de martelo:

1. Criar um cubo primitivo e dimensioná-lo para as medidas aproximadas do martelo
2. Subdividir a malha para acrescentar geometria a moldar
3. Percorrer os vértices para esculpir o afunilamento da pena transversal, o perfil da face de impacto e o abaulamento central
4. Aplicar um modificador Subdivision Surface para obter curvas suaves
5. Abrir o olho com uma operação booleana DIFFERENCE com um cilindro
6. Calcular o volume da malha e aplicar um fator de escala uniforme para chegar a 1 kg de aço
7. Criar pequenos cubos de corte para cada traço das runas e subtraí-los da superfície com operações booleanas

O Claude envia este script ao Blender (via MCP ou API). O Blender executa-o e produz a geometria 3D. Com MCP (método A), vê o modelo aparecer na vista em tempo real.

Inspecione o modelo. Com o método A, rode à volta dele na vista do Blender. Com o método B, descarregue o ficheiro .blend e abra-o no Blender, ou peça ao Claude que renderize uma captura da vista. Verifique dimensões, proporções e fidelidade dos detalhes. Problemas comuns na primeira versão e como pedir ao Claude que os corrija:

• O texto aparece ao contrário num lado → indique que face (+Y ou -Y) precisa de ser espelhada
• Modelo demasiado pequeno ou grande → dê a dimensão pretendida em mm
• As gravações desapareceram na superfície curva → o Claude tem de consultar a posição real da superfície em cada ponto de gravação
• As operações booleanas destruíram a malha → peça ao Claude que use um cortador individual por traço, não geometria unida
• Elementos no eixo errado → comunique sempre com referências de eixo (+X, -Y, +Z), nunca 'frente' ou 'trás', que são ambíguos em 3D

Cada correção é uma vez na conversa: descreve o problema, o Claude ajusta o script, volta a executá-lo e revê de novo. Duas a cinco iterações costumam produzir um modelo terminado.

Rode o modelo para verificar cada face. Confirme que as runas gravadas se leem corretamente nos dois lados planos: o texto na face +Y deve aparecer naturalmente espelhado quando visto da direção +Y, e o texto na face -Y deve ler-se corretamente da direção -Y. Verifique que o olho está limpo e centrado. Confirme que a pena transversal afunila suavemente, sem arestas irregulares.

No Blender, prima Numpad 1 para a vista de frente (vista -Y), Ctrl+Numpad 1 para trás (vista +Y), Numpad 3 para a direita (vista +X) e Numpad 7 para cima (vista +Z). Estas vistas ortográficas revelam problemas de alinhamento que a vista em perspetiva esconde.

Guarde o modelo como ficheiro .blend (File → Save As, ou por script: bpy.ops.wm.save_as_mainfile(filepath='model.blend')). O formato .blend é o formato nativo do Blender e a melhor escolha para arquivar e partilhar:

• Preserva todas as pilhas de modificadores, materiais, definições de cena e histórico de edição
• Totalmente editável: outro maker pode abri-lo, mudar o texto das runas, redimensioná-lo para outro peso ou ajustar qualquer parâmetro

O ficheiro .blend é a única fonte de verdade do modelo.

Ao criar ou editar um blueprint no Youblob, acrescente um passo de design (tipo de conteúdo: 'design') e carregue o ficheiro .blend. O Youblob mostra os ficheiros .blend como pré-visualização 3D interativa no navegador, disponibiliza-os para descarregar e pode prepará-los diretamente para impressão 3D, sem os converter para outro formato.

Inclua as dimensões, o peso e a densidade do material na descrição do passo, para que outros makers conheçam as especificações exatas. Nos modelos paramétricos (como este martelo dimensionado pelo peso), documente que variáveis alterar para personalizar: outros makers devem poder adaptar o design às suas necessidades sem começar do zero.

Lições aprendidas ao desenhar a cabeça de martelo nórdica e outros modelos com o Claude:

• Use referências de eixo, não direções: diga 'face +Y' e 'eixo -Z', nunca 'frente' ou 'cima': são ambíguos em 3D e levam a resultados espelhados.
• As operações booleanas precisam de cortadores individuais: unir várias formas primitivas antes de uma operação booleana cria geometria não-manifold. Mantenha cada cortador como objeto separado.
• Consulte a superfície real: depois da subdivisão e dos modificadores, a superfície da malha não está onde as dimensões originais sugerem. O Claude deve medir as posições dos vértices antes de colocar gravações ou cortes.
• Dimensione pelo volume, não pelas medidas: para atingir um peso-alvo, calcule o volume da malha pelo método dos tetraedros com sinal e aplique um fator de escala uniforme: (target_vol / current_vol) ^ (1/3).
• Itere em 2 a 5 rondas: o primeiro script acerta em 80 %. Cada ciclo de revisão e correção apanha os problemas restantes. Cinco iterações costumam produzir um modelo pronto para produção.