Cómo usar GPT-6 Astra en Blender con Codex
Instala Blender, configura GPT-6 Astra en Codex mediante suscripción o BetterToken API Key y crea tu primer modelo 3D utilizando Computer Use.
Índice

Para controlar Blender a través de Codex con GPT-6 Astra, no es necesario dominar cada herramienta de modelado 3D. Basta con describir el resultado final deseado y Codex elegirá el método disponible más adecuado: manejar la interfaz mediante el plugin oficial Computer Use, ejecutar scripts de Blender Python (bpy) o lanzar comandos de Blender en segundo plano. No necesitas decidir qué herramienta debe aplicar el agente en cada paso; es suficiente con revisar los resultados intermedios y guardar el proyecto en cada etapa.
Elige una de las dos formas de conectar el modelo:
| Tu situación | Cómo conectarte |
|---|---|
| Tienes una cuenta y una suscripción con acceso a Codex y Astra | Inicia sesión en tu cuenta oficial y selecciona GPT-6 Astra |
| No tienes suscripción | Conecta una BetterToken API Key; no se requiere iniciar sesión en una cuenta oficial de Codex |
En ambos casos, instala el mismo plugin oficial Computer Use a través de la sección Plugins. La API Key cambia la forma de acceder al modelo y abonar las solicitudes; el proceso de instalación del plugin sigue siendo exactamente el mismo.
A continuación se muestra el recorrido completo, desde la instalación del software hasta una lámpara de escritorio editable y una animación orbital de 360 grados. Necesitarás un ordenador Mac o Windows capaz de ejecutar Blender. El modelo recibe las tareas a través de internet, mientras que Blender y el renderizado se ejecutan localmente en tu equipo.

En el artículo oficial de OpenAI, Astra crea una escena arquitectónica más compleja. Esta guía utiliza un proyecto más compacto de una lámpara de escritorio, realizado en el entorno que se describe a continuación.
1. Instala la aplicación y configura el acceso al modelo en Codex
Visita la página oficial de descarga de ChatGPT, selecciona la aplicación de escritorio para tu sistema operativo e instálala. En la aplicación actual, Codex se encuentra en el selector de modo. Si ya tienes instalada la aplicación independiente de Codex, actualízala y utiliza la misma sección de Codex.
Si tienes una suscripción
- Inicia la aplicación y selecciona iniciar sesión con ChatGPT.
- Accede con la cuenta en la que esté activa tu suscripción.
- Cambia a Codex.
- En el selector de modelos junto a la entrada de mensajes, busca GPT-6 Astra. Si no aparece, comprueba los modelos disponibles para tu cuenta.
No necesitas una BetterToken Key independiente para este método. Pasa directamente a crear el proyecto.
Si no tienes suscripción: conecta una BetterToken API Key
Esta opción también funciona sin una cuenta oficial de Codex. Utilizas tu propia cuenta de BetterToken y las solicitudes al modelo se pagan según el uso.
Crea una BetterToken API Key para usar GPT-6 Astra en Codex y trabajar con Blender.
Si Codex ya funciona mediante una API Key
En una conexión de API existente, basta con sustituir la Base URL y la API Key por las credenciales de BetterToken. No es necesario volver a ejecutar el script de instalación.
- En BetterToken, crea una clave para el proveedor GPT.
- Abre la configuración actual del proveedor de API en Codex. Cambia la Base URL (
base_url) porhttps://www.bettertoken.ai/v1y sustituye la API Key actual por tu clave de BetterToken. Si la clave se almacena en una variable de entorno, actualiza su valor. - Asegúrate de seleccionar el modelo
gpt-6-astra. Si antes se utilizaba otro modelo, actualiza su identificador. - Guarda los ajustes, reinicia Codex por completo y envía un mensaje breve para comprobar la conexión.
Una vez superada la comprobación, continúa con el proyecto y Blender. Si ya tienes Computer Use instalado, puedes seguir utilizándolo; si aún no lo tienes, instálalo siguiendo los pasos que figuran más abajo.
Si configuras la conexión por API por primera vez
- Abre tu Workspace en BetterToken y crea una API Key para el proveedor GPT. Copia la clave para configurarla en tu ordenador.
- En la configuración de conexión de la clave, selecciona Codex y el modelo
gpt-6-astra. El identificador completo es fundamental: no lo acortes aastra. - Abre la guía de BetterToken para Codex y dirígete a la sección Command-line setup. El instalador requiere Node.js; si todavía no está instalado, instálalo primero siguiendo las instrucciones de configuración.
- Cierra Codex por completo. Abre Terminal en macOS o PowerShell en Windows y ejecuta el comando correspondiente para tu sistema operativo que aparece abajo.
- Cuando el instalador te solicite la API Key, pega tu clave localmente. No la envíes al chat con el agente. Espera a que finalicen la configuración y la prueba de conexión.
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"
El instalador configura el proveedor de BetterToken y la conexión a través de la Responses API, y después realiza una comprobación rápida del modelo. Ten en cuenta que la solicitud de verificación también consume tokens de la API. Al terminar, abre de nuevo la aplicación y selecciona Codex. Para este flujo de trabajo no se requiere iniciar sesión a través de ChatGPT.
Si la configuración falla con un error, soluciónalo primero: verifica tu clave, comprueba el acceso al modelo y asegúrate de tener saldo suficiente para las llamadas a la API. Instalar Computer Use no solucionará un fallo de conexión con el modelo.
2. Crea un proyecto local
- Crea una carpeta
astra-blenderen tu ordenador, por ejemplo, dentro de Documentos. - En Codex, haz clic en el botón «+» junto a Projects y añade esta carpeta como un proyecto local. La etiqueta del botón puede variar según el idioma y la versión de la aplicación; elige la opción de añadir un proyecto ubicado en tu equipo.
- Abre una nueva tarea dentro del proyecto y confirma que Astra esté seleccionada.
- Envía un mensaje breve de prueba: «Responde con una sola palabra: listo».
Recibir una respuesta sin errores de conexión significa que ya puedes pasar a Blender. En las conexiones mediante API, también debe aparecer un registro de esta llamada en el historial de uso de BetterToken. Esto verifica la conexión con el modelo; el acceso a la ventana de Blender se comprobará por separado.
En la carpeta del proyecto se guardarán el archivo .blend, las imágenes renderizadas y los archivos de animación. Para las siguientes modificaciones, regresa a esta misma tarea para que Codex conserve el contexto de las instrucciones previas.
3. Instala y abre Blender
Blender es un programa gratuito de creación 3D que abarca modelado, materiales, animación y renderizado. Puedes descargarlo desde la página oficial de descargas de Blender.
- Selecciona el instalador para tu sistema operativo. En Mac, asegúrate de elegir la arquitectura adecuada: Apple Silicon o Intel.
- En macOS, abre la imagen de disco descargada y arrastra Blender a Applications. En Windows, ejecuta el instalador y sigue los pasos del asistente.
- Inicia Blender. En la primera apertura, puedes mantener los ajustes predeterminados y seleccionar un nuevo archivo General.
- Por defecto, verás el cubo inicial en el centro; a la derecha, en la lista de la escena, aparecerán Cube, Camera y Light. No los elimines todavía.
- Mediante File → Save As, guarda el archivo en la carpeta
astra-blendercon el nombredesk-lamp.blend.
Si prefieres encargarle la instalación a Codex, envía esta instrucción dentro del proyecto creado:
Ayúdame a instalar Blender desde https://www.blender.org/download/ en este ordenador.
Primero, comprueba si Blender ya está instalado. Utiliza la versión estable oficial.
Explica cualquier paso del instalador o permiso del sistema que deba completar manualmente.
Abre Blender y confirma qué versión se está ejecutando.
La instalación estará completa cuando la propia ventana de Blender esté abierta. No basta con que Codex proporcione un enlace de descarga en su respuesta. Las guías oficiales de instalación para cada sistema operativo están disponibles en el manual de Blender.
4. Instala el plugin oficial Computer Use
Los pasos siguientes son idénticos tanto para la suscripción como para la BetterToken API Key:
- En la aplicación, abre Plugins.
- Localiza Computer Use de OpenAI y haz clic en Install plugin.
- Si tras la instalación aparece el botón Enable, activa el plugin.
- En la tarjeta del plugin, activa tanto su MCP server como su Skill: el servidor proporciona las herramientas de control y la Skill incluye las instrucciones sobre cómo utilizarlas.
- Ve a Settings → Computer use y activa el control de aplicaciones Any App, si este interruptor aparece en tu versión. Concede permiso para controlar Blender cuando la aplicación lo solicite.
- En Mac, otorga los permisos solicitados de Screen Recording y Accessibility en los ajustes del sistema. Si el sistema operativo te pide reiniciar la aplicación, hazlo.
- Regresa a la tarea del proyecto. Si es necesario, abre una nueva tarea para que se carguen las herramientas del plugin recién instalado.

La documentación oficial de Computer Use muestra la ubicación exacta de estos ajustes. En Windows, mantén Blender visible en un escritorio activo y no bloquees el equipo mientras el agente trabaje: utilizará el ratón y el teclado de esa sesión.
Ahora comprueba el control directo de la interfaz:
Utiliza el plugin oficial Computer Use para inspeccionar la ventana abierta de Blender.
Indícame el nombre del archivo actual y los objetos visibles en la lista de la escena.
Mediante la interfaz de Blender, renombra Cube a Connection_Test.
Muestra la lista de la escena actualizada y luego detente. No crees ni elimines ningún objeto.
Comprueba la ventana de Blender: el cubo debe permanecer en su sitio y su nombre en la lista de la escena debe cambiar a Connection_Test. Si Codex solo describe las acciones sin ejecutarlas, pídele explícitamente que las realice mediante Computer Use. Este pequeño paso confirma que el agente ve la ventana correcta e interactúa con ella.

5. Crea tu primer modelo
Comienza con un objeto fácil de verificar: una lámpara de escritorio con base circular, soporte vertical, brazo inclinado y pantalla. Encomienda la tarea completa al agente y permítele elegir la herramienta disponible más fiable.
Crea una pequeña lámpara de escritorio en el proyecto actual de Blender. Si es
necesario, puedes utilizar Computer Use, Blender Python (bpy) o comandos de
Blender en segundo plano. Elige la herramienta disponible más fiable y no asumas
que Blender MCP esté instalado.
Sustituye únicamente el objeto Connection_Test de nuestra prueba de conexión.
Crea una base circular apoyada en una superficie plana en Z=0, un soporte
vertical, un brazo angular corto, una pantalla cónica con grosor de pared
y una bombilla interna. Mantén las piezas como objetos editables independientes
llamados Lamp_Base, Lamp_Stem, Lamp_Arm, Lamp_Shade, Lamp_Bulb y Ground.
Verifica el resultado real en cuanto a alineación, proporciones y unión de las piezas.
Configura una cámara que muestre la lámpara por completo, guarda desk-lamp.blend en este
proyecto y muestra vistas frontal y en perspectiva antes de detenerte para recibir comentarios.
Cómo transcurrió la ejecución real
Esta ejecución real se llevó a cabo en macOS en la versión de la aplicación de escritorio de ChatGPT 26.908.40834, utilizando Blender 5.2.1 LTS y el modelo GPT-6 Astra High. Primero, Computer Use renombró el cubo a Connection_Test. Después, Codex generó scripts en bpy y los ejecutó utilizando el entorno de Python integrado en Blender. El usuario no tuvo que instalar un entorno de Python independiente, configurar entornos virtuales ni microgestionar la selección de herramientas en cada paso.
Cuando la entrada por teclado a través de la consola interactiva abierta de Blender se volvió inestable, Codex cambió a la CLI en segundo plano de Blender, completó la unión entre Lamp_Arm y Lamp_Shade, y preparó los renders. Tras ello, el agente volvió a abrir el archivo .blend guardado en la interfaz de Blender para inspeccionar el resultado visualmente.

La escena conservó los objetos independientes llamados Lamp_Base, Lamp_Stem, Lamp_Arm, Lamp_Shade, Lamp_Bulb y Ground. Se confirmó que la parte inferior de la base estaba apoyada en Z=0, la pantalla mantuvo el grosor de sus paredes y la bombilla quedó ubicada en su interior.

Comprueba estos mismos detalles en tu propia escena: la base descansa plana sobre el plano de apoyo, el soporte se conecta con limpieza a la pantalla, la lámpara completa encaja en el encuadre de la cámara y las piezas pueden seleccionarse individualmente. Corrige un solo aspecto a la vez y guarda el archivo tras cada ajuste satisfactorio.
6. Añade materiales e iluminación
Cuando la geometría sea satisfactoria, pasa a la apariencia de la escena y los materiales:
Continúa trabajando con la lámpara de escritorio existente en desk-lamp.blend.
Conserva su geometría y los nombres de los objetos. Asigna un acabado de esmalte
verde oscuro a Lamp_Base y Lamp_Shade, latón cepillado a Lamp_Stem y Lamp_Arm,
y un brillo cálido a Lamp_Bulb. Añade un material neutro para Ground y configura
una iluminación de estudio de tres puntos.
Utiliza Cycles para renderizar una vista previa limpia desde la cámara. Inspecciona
la imagen en busca de piezas flotantes, intersecciones, problemas de encuadre
o reflejos extraños, y luego guarda la vista previa y desk-lamp.blend.
En la ejecución real, la base y la pantalla recibieron un acabado de esmalte verde, el soporte y el brazo se configuraron con latón cepillado y la bombilla obtuvo un brillo cálido. Codex configuró una iluminación de estudio de tres puntos y renderizó el resultado en Cycles. La imagen final se muestra al principio de este artículo.
Para proyectos posteriores: conecta el Blender MCP oficial
Computer Use controla la interfaz visual. MCP proporciona a Codex un canal de comunicación específico con una instancia de Blender en ejecución, a través del cual puede inspeccionar los datos de la escena y ejecutar operaciones directamente. En el flujo de trabajo descrito anteriormente, Blender MCP no se instaló ni fue necesario: Codex utilizó Computer Use y las funciones integradas de Python y CLI de Blender. MCP sigue siendo una ampliación opcional para futuros proyectos.
- Visita la página de MCP en el sitio web de Blender y accede a la guía oficial de Setup.
- Comprueba la versión de Blender: el proyecto oficial actual requiere la versión 5.1 o más reciente.
- En la misma tarea de Codex, proporciona el enlace de Setup y pídele que configure tanto el complemento para Blender como el MCP server independiente, y que después registre el server en Codex. Son dos componentes distintos de la conexión.
- Una vez preparado el complemento, abre Blender y ve a Edit → Preferences → Add-ons → Install from Disk, selecciona el archivo ZIP y activa el complemento. Codex puede guiarte en este paso mediante Computer Use.
- En las preferencias del complemento, inicia el servidor de conexión. El complemento y el MCP server deben compartir exactamente la misma dirección y puerto; utiliza los valores indicados en la guía oficial actual.
- Abre una nueva tarea en el mismo proyecto de Codex y pide leer la lista de objetos a través de MCP. Comprueba que los nombres
Lamp_Base,Lamp_Shadey las demás piezas coincidan con Blender.
No realices modificaciones hasta que la lista de objetos coincida a la perfección. A partir de ahí, puedes delegar el modelado a MCP mientras empleas Computer Use para inspeccionar la ventana y comprobar el fotograma final. Si se interrumpe la conexión, revisa primero el estado actual de la escena para evitar crear piezas duplicadas.
7. Crea una animación corta
Una vez guardado un modelo estático sólido, pide a Codex que configure una animación de cámara orbital de 360 grados. Puedes mantener la animación en el mismo archivo desk-lamp.blend:
En la escena existente desk-lamp.blend, crea un giro orbital de cámara de 360 grados
de 5 segundos a 24 fps. Establece fotogramas clave en el fotograma 1 (0 grados)
y en el fotograma 121 (360 grados), y renderiza los fotogramas del 1 al 120 para
que el bucle no duplique el punto final. Utiliza Cycles a 1280x720 con 32 samples.
Mantén la lámpara inmóvil y todas las piezas editables.
Primero, renderiza los fotogramas de prueba 1, 41 y 81. Una vez confirmados,
renderiza los 120 fotogramas PNG en la carpeta renders/ y codifica un MP4 H.264
de 5 segundos llamado desk-lamp-orbit.mp4. Guarda la escena en desk-lamp.blend.
En el proyecto finalizado, Codex comprobó primero los fotogramas 1, 41 y 81. Después, Cycles con 32 samples renderizó 120 archivos PNG a 1280x720 en la carpeta renders/. El fotograma 121 contenía la posición de 360°, pero se excluyó del resultado final para que el inicio no se duplique al final del bucle de cinco segundos.
El binario de FFmpeg del sistema no se ejecutó debido a la ausencia de la biblioteca libvpx.11.dylib. Codex comprobó las capacidades de Blender 5.2.1 y, en lugar de solucionar la instalación del sistema, utilizó el codificador H.264 integrado en Blender. Antes de la compilación, comprobó que los 120 archivos PNG existieran y tuvieran un tamaño superior a cero, y a continuación configuró la exportación a H.264 MP4 para 120 fotogramas a 24 fps y 1280x720. Tras la codificación, abre el archivo y comprueba que se reproduzca por completo durante los cinco segundos.

Si los fotogramas tardan en calcularse, pide a Codex que te muestre el progreso del render activo. Nunca inicies un segundo render de la misma escena hasta confirmar que el primero haya finalizado.
Resolución de problemas
| Qué observas | Qué comprobar |
|---|---|
Codex no responde, devuelve un error 401 o no encuentra el modelo | En una conexión por API, verifica tu clave, el proveedor GPT, gpt-6-astra y el resultado del script de configuración; reinicia la aplicación por completo |
| El modelo responde, pero no aparecen las herramientas de Computer Use | Comprueba la instalación del plugin, verifica los selectores de server y Skill, e inicia una nueva tarea |
| Las herramientas están disponibles, pero la ventana no es accesible | Concede permiso para acceder a Blender; en Mac, revisa Screen Recording y Accessibility; en Windows, asegúrate de que el escritorio activo no esté bloqueado |
| El agente describe los pasos pero no modifica nada | Pídele explícitamente que realice una acción pequeña mediante Computer Use y muestre el estado tras ella |
| MCP está conectado, pero muestra una escena diferente | Comprueba el archivo .blend abierto, la instancia activa de Blender y la dirección/puerto de la extensión |
| La llamada se interrumpió o se agotó el tiempo de espera (timeout) | Solicita primero la lista de objetos y archivos guardados; continúa desde la última fase completada |
| El ejecutable FFmpeg del sistema no se inicia | En esta ejecución, Codex utilizó el codificador H.264 integrado en Blender; es una solución práctica si la versión actual de Blender admite el formato requerido |
| La imagen no se ve bien | Regresa a la geometría básica y a un único ángulo de cámara; corrige proporciones, intersecciones e iluminación antes del renderizado completo |
Tras completar este ejercicio, deberías conservar desk-lamp.blend, las imágenes de comprobación, 120 archivos PNG en la carpeta renders/ y desk-lamp-orbit.mp4. Abre el archivo .blend una vez más y solicita a Codex un cambio concreto para comprobar que las piezas siguen siendo editables por separado.