Como Usar o GPT-6 Astra no Blender com o Codex

Para controlar o Blender por meio do Codex com o GPT-6 Astra, você não precisa dominar todas as ferramentas de modelagem 3D. Basta descrever o resultado final desejado, e o Codex escolherá uma abordagem disponível: controlar a interface pelo plugin oficial Computer Use, executar scripts em Blender Python (bpy) ou rodar comandos do Blender em segundo plano. Você não precisa decidir qual ferramenta o agente deve usar a cada etapa. É suficiente revisar os resultados intermediários e salvar seu projeto a cada marco.

Escolha uma das duas formas de conectar o modelo:

Sua situação	Como conectar
Você tem uma conta e assinatura com acesso ao Codex e ao Astra	Entre na sua conta oficial e selecione o GPT-6 Astra
Você não tem assinatura	Conecte uma BetterToken API Key; não é necessário fazer login em uma conta oficial do Codex

Em ambos os casos, instale o mesmo Computer Use oficial por meio da seção Plugins. A API Key altera a forma como você acessa o modelo e paga pelas requisições; o processo de instalação do plugin permanece idêntico.

Abaixo está o passo a passo completo, desde a configuração dos programas até uma luminária de mesa editável e uma animação de órbita em 360 graus. Você precisará de um computador Mac ou Windows capaz de executar o Blender. O modelo recebe as tarefas pela internet, enquanto o Blender e a renderização rodam localmente na sua máquina.

Na análise oficial da OpenAI, o Astra cria uma cena arquitetônica mais complexa. Este guia utiliza um projeto compacto de luminária de mesa, realizado no ambiente descrito a seguir.

1. Instale o aplicativo e configure o acesso ao modelo no Codex

Acesse a página oficial de download do ChatGPT, selecione o aplicativo para desktop do seu sistema operacional e faça a instalação. No aplicativo atual, o Codex fica no seletor de modos. Se você já tem o aplicativo independente do Codex instalado, atualize-o e use a mesma seção do Codex.

Se você tiver uma assinatura

1. Abra o aplicativo e escolha a opção de entrar com o ChatGPT.
2. Entre na conta em que a assinatura está ativa.
3. Alterne para o Codex.
4. No seletor de modelos ao lado da caixa de mensagens, localize o GPT-6 Astra. Se ele não aparecer, verifique os modelos disponíveis para a sua conta.

Uma BetterToken Key separada não é necessária para este método. Prossiga diretamente para a criação do projeto.

Se você não tiver assinatura: conecte uma BetterToken API Key

Esta opção também funciona sem uma conta oficial do Codex. Você utiliza sua conta da BetterToken, e as requisições ao modelo são cobradas conforme o uso.

Crie uma BetterToken API Key para usar o GPT-6 Astra no Codex ao trabalhar com o Blender.

Se o Codex já estiver funcionando via API Key

Em uma conexão de API já existente, basta substituir a Base URL e a API Key pelas credenciais da BetterToken. Não é necessário rodar o instalador novamente.

1. Na BetterToken, crie uma chave para o provedor GPT.
2. Abra as configurações atuais do provedor de API do Codex. Substitua a Base URL (base_url) por https://www.bettertoken.ai/v1 e a API Key atual pela sua chave da BetterToken. Se a chave estiver salva em uma variável de ambiente, atualize seu valor.
3. Certifique-se de que o modelo gpt-6-astra esteja selecionado. Se outro modelo estava configurado antes, altere o identificador.
4. Salve as alterações, reinicie o Codex por completo e envie uma mensagem curta de teste para verificar a conexão.

Após o sucesso do teste, prossiga para a criação do projeto e o Blender. Caso o Computer Use já esteja instalado, você pode continuar usando-o; se o plugin ainda não estiver instalado, siga as etapas abaixo.

Se você estiver configurando a conexão de API pela primeira vez

1. Abra o Workspace na BetterToken e crie uma API Key para o provedor GPT. Copie a chave para configurá-la no seu computador.
2. Na configuração de conexão da chave, selecione o Codex e o modelo gpt-6-astra. O identificador completo é fundamental: não abrevie para astra.
3. Abra o guia da BetterToken para o Codex e acesse a seção Command-line setup. O instalador requer o Node.js; se ainda não o tiver, instale-o primeiro de acordo com as instruções de configuração.
4. Feche o Codex completamente. Abra o Terminal no Mac ou o PowerShell no Windows e execute o comando correspondente ao seu sistema operacional abaixo.
5. Quando o instalador solicitar a API Key, cole sua chave localmente. Não a envie no chat com o agente. Aguarde a conclusão da configuração e o teste de conexão.

macOS — Terminal:

curl -fsSL "https://www.bettertoken.ai/install-codex-provider.sh" -o /tmp/install-codex-provider.sh
bash /tmp/install-codex-provider.sh --model gpt-6-astra

Windows — PowerShell:

iwr "https://www.bettertoken.ai/install-codex-provider.ps1" -OutFile "$env:TEMP\install-codex-provider.ps1"
powershell -ExecutionPolicy Bypass -File "$env:TEMP\install-codex-provider.ps1" -Model "gpt-6-astra"

O instalador configura o provedor da BetterToken e a conexão via Responses API, executando em seguida uma verificação rápida do modelo. A requisição de teste também consome tokens da API. Após a conclusão, abra o aplicativo novamente e selecione o Codex. Fazer login via ChatGPT não é necessário neste fluxo.

Se a configuração falhar com erro, resolva-o primeiro: verifique sua chave, o acesso ao modelo e se sua conta possui saldo suficiente para as chamadas de API. A instalação do Computer Use não corrige uma falha de conexão com o modelo.

2. Crie um projeto local

1. Crie uma pasta chamada astra-blender no seu computador — por exemplo, dentro de Documentos.
2. No Codex, clique em ”+” ao lado de Projects e adicione essa pasta como um projeto local. O texto do botão pode variar de acordo com o idioma e a versão do aplicativo; escolha a opção de adicionar um projeto no seu computador.
3. Abra uma nova tarefa dentro dele e confirme se o Astra está selecionado.
4. Envie uma mensagem curta de teste: “Responda com uma palavra: pronto”.

Receber uma resposta sem erros de conexão significa que você pode prosseguir para o Blender. Em conexões de API, o registro dessa chamada também deve aparecer no histórico de uso da BetterToken. Isso confirma a conexão com o modelo; o acesso à janela do Blender será testado separadamente.

A pasta do projeto armazenará seu arquivo .blend, as imagens renderizadas e os arquivos de animação. Volte a esta mesma tarefa para as próximas alterações, para que o Codex mantenha o contexto das instruções anteriores.

3. Instale e abra o Blender

O Blender é um pacote gratuito de criação 3D que engloba modelagem, materiais, animação e renderização. Você pode baixá-lo na página oficial de download do Blender.

1. Escolha o instalador para o seu sistema operacional. No Mac, certifique-se de escolher a arquitetura correta: Apple Silicon ou Intel.
2. No macOS, abra a imagem de disco baixada e arraste o Blender para a pasta Aplicativos (Applications). No Windows, execute o instalador e siga as etapas do assistente.
3. Abra o Blender. Na primeira inicialização, você pode manter as configurações padrão e selecionar um novo arquivo General.
4. No centro da tela, você verá o cubo padrão; à direita, no outliner da cena, estarão Cube, Camera e Light. Não os exclua por enquanto.
5. Vá em File → Save As, navegue até a pasta astra-blender e salve o arquivo como desk-lamp.blend.

Se você preferir que o Codex realize a instalação, envie este prompt dentro do projeto criado:

Ajude-me a instalar o Blender a partir de https://www.blender.org/download/ neste computador.
Primeiro, verifique se o Blender já está instalado. Use a versão estável oficial.
Explique quaisquer etapas do instalador ou permissões do sistema que eu precise concluir manualmente.
Abra o Blender e confirme qual versão está em execução.

A instalação estará concluída quando a própria janela do Blender estiver aberta. Apenas um link para download na resposta do Codex não é suficiente. Os guias oficiais de instalação para todos os sistemas operacionais estão reunidos no Manual do Blender.

4. Instale o plugin oficial Computer Use

As etapas seguintes são idênticas tanto para assinatura quanto para quem usa BetterToken API Key:

1. No aplicativo, acesse Plugins.
2. Localize o Computer Use da OpenAI e clique em Install plugin.
3. Se após a instalação aparecer Enable, ative o plugin.
4. No card do plugin, ative tanto o seu MCP server quanto a Skill — o servidor disponibiliza as ferramentas de controle, enquanto a Skill traz as instruções de uso.
5. Vá em Settings → Computer use e ative o controle de aplicativos Any App, se essa opção estiver visível na sua versão. Conceda permissão para controlar o Blender quando solicitado pelo app.
6. No Mac, conceda as permissões de Screen Recording e Accessibility solicitadas nos Ajustes do Sistema. Se o sistema solicitar a reinicialização do aplicativo, reinicie-o.
7. Retorne à tarefa do seu projeto. Se necessário, abra uma nova tarefa para que as ferramentas do plugin recém-instalado sejam carregadas corretamente.

A documentação oficial do Computer Use mostra a disposição exata dessas configurações. No Windows, mantenha o Blender visível na área de trabalho ativa e não bloqueie o computador enquanto o agente estiver trabalhando: ele utilizará o mouse e o teclado desta sessão.

Agora, teste o controle direto da interface:

Use o plugin oficial Computer Use para inspecionar a janela aberta do Blender.
Informe-me o nome do arquivo atual e os objetos visíveis na lista da cena.
Usando a interface do Blender, renomeie Cube para Connection_Test.
Mostre a lista da cena atualizada e pare. Não crie nem exclua nenhum objeto.

Olhe para a janela do Blender: o cubo deve permanecer no lugar, e o nome dele na lista da cena deve mudar para Connection_Test. Se o Codex apenas descrever o que fazer sem agir, peça explicitamente para executar as ações via Computer Use. Essa pequena etapa comprova que o agente enxerga e consegue interagir com a janela correta.

5. Crie seu primeiro modelo

Comece com um objeto fácil de verificar: uma luminária de mesa com base circular, haste, braço articulado inclinado e cúpula. Delegue a tarefa completa ao agente e permita que ele escolha a ferramenta disponível mais confiável.

Crie uma luminária de mesa pequena no projeto atual do Blender. Se necessário,
você pode usar Computer Use, Blender Python (bpy) ou comandos em segundo plano
do Blender. Escolha a ferramenta disponível mais confiável e não presuma
que o Blender MCP esteja instalado.

Substitua apenas o objeto Connection_Test da nossa verificação de conexão.
Crie uma base circular apoiada em uma superfície plana em Z=0, uma haste
vertical, um braço articulado curto e inclinado, uma cúpula cônica com
espessura de parede e uma lâmpada interna. Mantenha as peças como objetos
editáveis separados chamados Lamp_Base, Lamp_Stem, Lamp_Arm, Lamp_Shade,
Lamp_Bulb e Ground.

Verifique o resultado real quanto a alinhamento, proporções e conexão das peças.
Configure uma câmera mostrando a luminária inteira, salve desk-lamp.blend neste
projeto e mostre vistas frontal e em perspectiva antes de parar para avaliação.

Como foi a execução real

Essa execução real aconteceu no macOS no aplicativo ChatGPT para desktop versão 26.908.40834, com o Blender 5.2.1 LTS e o modelo GPT-6 Astra High. Primeiro, o Computer Use renomeou o cubo para Connection_Test. Em seguida, o Codex gerou scripts em bpy e os executou usando o Python integrado do Blender. O usuário não precisou instalar um ambiente Python separado, configurar ambientes virtuais nem microgerenciar as ferramentas a cada etapa.

Quando a entrada de teclado pelo console interativo aberto do Blender ficou instável, o Codex alternou para a CLI em segundo plano do Blender, concluiu a junção do Lamp_Arm com o Lamp_Shade e preparou as renderizações. Depois disso, o agente reabriu o arquivo .blend salvo na interface gráfica do Blender para inspecionar o resultado visualmente.

A cena manteve os objetos separados chamados Lamp_Base, Lamp_Stem, Lamp_Arm, Lamp_Shade, Lamp_Bulb e Ground. A parte inferior da base foi confirmada no nível Z=0, a cúpula manteve a espessura de parede e a lâmpada ficou posicionada dentro dela.

Verifique os mesmos pontos no seu projeto: a base apoiada perfeitamente no plano do chão, a haste conectada à cúpula, a luminária inteira enquadrada na câmera e as peças selecionáveis individualmente. Corrija um detalhe de cada vez e salve o arquivo após cada alteração bem-sucedida.

6. Adicione materiais e iluminação

Quando a geometria estiver do seu agrado, passe para o acabamento visual da cena:

Continue trabalhando com a luminária de mesa existente em desk-lamp.blend. Mantenha
sua geometria e os nomes dos objetos intactos. Atribua um acabamento em esmalte
verde-escuro para Lamp_Base e Lamp_Shade, latão escovado para Lamp_Stem e Lamp_Arm
e um brilho quente para Lamp_Bulb. Adicione um material neutro para Ground e configure
uma iluminação de estúdio de três pontos.

Use o Cycles para renderizar uma prévia limpa a partir da câmera. Inspecione a imagem
em busca de peças flutuando, interseções, problemas de enquadramento ou reflexos
anômalos e, em seguida, salve a prévia e o arquivo desk-lamp.blend.

Na nossa execução, a base e a cúpula receberam acabamento em esmalte verde-escuro, a haste e o braço ficaram com latão escovado e a lâmpada recebeu uma emissão de luz quente. O Codex configurou uma iluminação de estúdio de três pontos e renderizou o resultado no Cycles. O render final está ilustrado no início do artigo.

Para trabalhos futuros: conecte o Blender MCP oficial

O Computer Use controla a interface visual. O MCP fornece ao Codex um canal de comunicação dedicado com uma instância ativa do Blender, permitindo ler a cena e executar operações diretamente. No fluxo descrito acima, o Blender MCP não foi instalado e não foi necessário: o Codex utilizou o Computer Use e os recursos integrados de Python/CLI do Blender. O MCP continua sendo uma extensão opcional para projetos futuros.

1. Acesse a página do Blender MCP e avance para o guia oficial de Setup.
2. Verifique sua versão do Blender: o projeto oficial atual exige a versão 5.1 ou mais recente.
3. Na mesma tarefa do Codex, envie o link de Setup e peça para configurar tanto o add-on do Blender quanto o MCP server independente, registrando em seguida o servidor no Codex. Essas são duas partes distintas da conexão.
4. Quando o pacote do add-on estiver pronto, abra o Blender, vá em Edit → Preferences → Add-ons → Install from Disk, selecione o arquivo ZIP e ative o add-on. O Codex pode guiar você nessa etapa usando o Computer Use.
5. Nas preferências do add-on, inicie o servidor de conexão. O add-on e o MCP server devem compartilhar exatamente o mesmo endereço de host e porta; use os valores indicados no guia oficial atual.
6. Abra uma nova tarefa no mesmo projeto do Codex e peça para ler a lista de objetos via MCP. Confirme se Lamp_Base, Lamp_Shade e as demais peças correspondem ao que está no Blender.

Não faça alterações até que a lista de objetos coincida perfeitamente. A partir daí, você pode encarregar o MCP da modelagem enquanto usa o Computer Use para inspecionar a janela e avaliar os quadros renderizados. Se a conexão cair, verifique primeiro o estado atual da cena para não criar peças duplicadas.

7. Crie uma animação curta

Depois de salvar um modelo estático sólido, peça ao Codex para configurar uma animação de órbita da câmera em 360 graus. Você pode manter a animação no mesmo arquivo desk-lamp.blend:

Na cena existente de desk-lamp.blend, crie uma rotação de câmera orbital de 360 graus
em 5 segundos a 24 fps. Defina quadros-chave no quadro 1 (0 graus) e no quadro 121
(360 graus) e renderize os quadros de 1 a 120 para que o loop não duplique o ponto final.
Use o Cycles a 1280x720 com 32 samples. Mantenha a luminária estática e todas
as peças editáveis.

Primeiro, renderize os quadros de teste 1, 41 e 81. Após a confirmação, renderize
todos os 120 quadros em PNG na pasta renders/ e codifique um MP4 em H.264 de 5 segundos
chamado desk-lamp-orbit.mp4. Salve a cena em desk-lamp.blend.

No projeto concluído, o Codex primeiro renderizou os quadros de teste 1, 41 e 81. Em seguida, o Cycles com 32 samples renderizou 120 quadros em PNG a 1280×720 na pasta renders/. O quadro 121 continha a posição de 360°, mas ficou de fora da saída final, garantindo que o início do loop de 5 segundos não seja duplicado no final.

O executável do FFmpeg do sistema não rodou devido à ausência da biblioteca libvpx.11.dylib. O Codex verificou os recursos do Blender 5.2.1 e, em vez de tentar consertar a instalação do sistema, usou o codificador de vídeo H.264 integrado do Blender. Antes da montagem, ele verificou se todos os 120 arquivos PNG existiam e tinham tamanho diferente de zero, configurando a exportação em H.264 MP4 para 120 quadros a 24 fps e 1280×720. Concluída a codificação, abra o arquivo e verifique se ele é reproduzido perfeitamente durante todos os cinco segundos.

Se os quadros estiverem demorando para renderizar, peça para exibir o progresso da renderização atual. Não inicie uma segunda renderização da mesma cena até confirmar se a primeira foi finalizada.

Solução de problemas

O que você vê	O que verificar
O Codex não responde, informa 401 ou não encontra o modelo	Em uma conexão de API, verifique sua chave, o provedor GPT, gpt-6-astra e o retorno do script de configuração; reinicie o aplicativo por completo
O modelo responde, mas as ferramentas do Computer Use não aparecem	Verifique a instalação do plugin, certifique-se de que os seletores de server e Skill estejam ativos e inicie uma nova tarefa
As ferramentas estão presentes, mas a janela fica inacessível	Conceda permissão para acessar o Blender; no Mac, verifique Screen Recording e Accessibility; no Windows, certifique-se de que a área de trabalho ativa esteja desbloqueada
O agente descreve as etapas, mas não altera nada	Peça explicitamente para executar uma ação pequena via Computer Use e mostrar o estado logo em seguida
O MCP está conectado, mas exibe uma cena diferente	Verifique o arquivo .blend aberto, a instância ativa do Blender e o endereço/porta da extensão
A chamada foi interrompida ou atingiu timeout	Peça primeiro a lista de objetos e arquivos salvos; continue a partir da última etapa concluída
O FFmpeg do sistema não inicializa	Nesta execução, o Codex usou o codificador H.264 integrado do Blender; essa é uma alternativa viável se a versão atual do Blender suportar o formato necessário
A imagem tem aparência ruim	Volte para a geometria básica e um único ângulo de câmera; corrija proporções, interseções e iluminação antes de fazer uma renderização completa

Após concluir o exercício, você deverá ter o arquivo desk-lamp.blend, as imagens de verificação, 120 arquivos PNG na pasta renders/ e o arquivo desk-lamp-orbit.mp4. Abra o .blend mais uma vez e solicite ao Codex uma alteração específica para confirmar que as partes continuam editáveis individualmente.