Codex에서 GPT-6 Astra로 Blender를 제어하는 방법

GPT-6 Astra가 탑재된 Codex를 통해 Blender를 제어하기 위해 모든 3D 모델링 도구를 완벽히 다룰 필요는 없습니다. 원하는 최종 결과물을 설명하기만 하면 Codex가 공식 Computer Use 플러그인을 통한 인터페이스 조작, Blender Python(bpy) 스크립트 실행, 또는 Blender 백그라운드 명령 등 사용 가능한 최적의 방식을 스스로 선택합니다. 매 단계마다 에이전트가 어떤 도구를 적용해야 할지 직접 결정할 필요는 없으며, 중간 결과를 검토하고 주요 단계마다 프로젝트를 저장하는 것만으로 충분합니다.

모델에 연결하는 두 가지 방법 중 하나를 선택하세요:

현재 상황	연결 방법
Codex 및 Astra 접근 권한이 포함된 계정과 구독이 있는 경우	공식 계정으로 로그인한 뒤 GPT-6 Astra를 선택합니다
구독이 없는 경우	BetterToken API Key를 연결합니다. Codex 공식 계정 로그인은 필요하지 않습니다

두 경우 모두 Plugins 섹션에서 완전히 동일한 공식 Computer Use를 설치합니다. API Key는 모델에 접근하고 요청 비용을 결제하는 방식을 바꿀 뿐이며, 플러그인 설치 절차는 동일합니다.

아래는 소프트웨어 설치부터 편집 가능한 탁상용 스탠드 조명 제작 및 360도 궤도 회전 애니메이션 완성까지의 전체 가이드입니다. Blender를 실행할 수 있는 Mac 또는 Windows 컴퓨터가 필요합니다. 모델은 인터넷을 통해 작업을 전달받으며, Blender 구동 및 렌더링은 로컬 컴퓨터에서 직접 처리됩니다.

OpenAI 공식 분석 글에서는 Astra가 더 복잡한 건축 씬을 구현합니다. 이 가이드에서는 아래에 설명된 환경에서 완성한 컴팩트한 탁상 스탠드 프로젝트를 다룹니다.

1. 앱 설치 및 Codex에서 모델 접근 권한 설정

ChatGPT 공식 다운로드 페이지를 방문하여 운영체제에 맞는 데스크톱 애플리케이션을 선택하고 설치합니다. 현재 앱에서 Codex는 모드 전환 메뉴 안에 위치해 있습니다. 이미 별도의 독립형 Codex App이 설치되어 있다면 최신 버전으로 업데이트한 후 동일한 Codex 섹션을 사용하면 됩니다.

구독 요금제를 이용 중인 경우

1. 애플리케이션을 실행하고 ChatGPT 계정으로 로그인을 선택합니다.
2. 구독이 활성화된 계정으로 로그인합니다.
3. Codex로 모드를 전환합니다.
4. 프롬프트 입력창 옆의 모델 선택기에서 GPT-6 Astra를 찾습니다. 목록에 보이지 않는다면 해당 계정에서 사용 가능한 모델 권한을 확인하세요.

이 방식에서는 별도의 BetterToken Key가 필요하지 않습니다. 바로 프로젝트 생성 단계로 넘어가세요.

구독 요금제가 없는 경우: BetterToken API Key 연결

이 옵션은 공식 Codex 계정 없이도 이용할 수 있습니다. 본인의 BetterToken 계정을 사용하며, 모델 호출 비용은 사용량에 따라 결제됩니다.

Blender 작업을 위해 Codex에서 GPT-6 Astra를 사용할 수 있는 BetterToken API Key 생성하기.

Codex가 이미 API Key로 작동 중인 경우

기존 API 연결이 설정되어 있다면 Base URL과 API Key만 BetterToken 정보로 교체하면 됩니다. 설치 스크립트를 다시 실행할 필요는 없습니다.

1. BetterToken에서 GPT 제공자용 키를 생성합니다.
2. 현재 Codex API 제공자 설정을 엽니다. Base URL(base_url)을 https://www.bettertoken.ai/v1로 변경하고, 사용 중인 API Key를 본인의 BetterToken 키로 바꿉니다. 키가 환경 변수에 저장되어 있다면 해당 환경 변수의 값을 업데이트합니다.
3. 모델로 **gpt-6-astra**가 선택되어 있는지 확인합니다. 이전에 다른 모델을 사용했다면 모델 식별자를 변경합니다.
4. 설정을 저장하고 Codex를 완전히 재시작한 뒤, 짧은 테스트 메시지를 보내 연결 상태를 확인합니다.

연결 테스트에 성공하면 프로젝트 생성 및 Blender 단계로 이동하세요. Computer Use가 이미 설치되어 있다면 그대로 사용하면 되고, 아직 없다면 아래 단계에 따라 설치합니다.

API 연결을 처음 구성하는 경우

1. BetterToken Workspace를 열고 GPT 제공자용 API Key를 생성합니다. 컴퓨터에 설정할 수 있도록 키를 복사해 둡니다.
2. 키 연결 설정에서 Codex와 gpt-6-astra 모델을 선택합니다. 전체 식별자를 정확히 입력해야 하며, astra로 줄여 쓰지 마세요.
3. BetterToken의 Codex 안내 가이드를 열고 Command-line setup 섹션으로 이동합니다. 설치 프로그램에는 Node.js가 필요하므로, 아직 설치되지 않았다면 설정 안내에 따라 먼저 설치하세요.
4. Codex를 완전히 종료합니다. Mac에서는 Terminal을, Windows에서는 PowerShell을 열고 아래에서 운영체제에 맞는 명령을 실행합니다.
5. 설치 프로그램이 API Key를 요청하면 로컬 터미널에 키를 붙여넣습니다. 에이전트와의 대화창에 키를 입력해서는 안 됩니다. 구성 및 연결 테스트가 완료될 때까지 기다립니다.

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"

설치 프로그램이 BetterToken 제공자와 Responses API 연결을 구성한 뒤 빠른 모델 확인을 진행합니다. 이 확인 요청 역시 API 토큰을 소모합니다. 완료되면 애플리케이션을 다시 열고 Codex를 선택합니다. 이 워크플로에서는 ChatGPT 로그인이 필요하지 않습니다.

설정 중 오류가 발생하면 먼저 원인을 해결하세요. 키 유효성, 모델 접근 권한, API 호출 잔액을 확인해야 합니다. Computer Use를 설치한다고 해서 모델 연결 오류가 해결되지는 않습니다.

2. 로컬 프로젝트 생성

1. 컴퓨터에 astra-blender 폴더를 생성합니다(예: Documents 내부).
2. Codex에서 Projects 옆의 ”+” 버튼을 클릭하고 이 폴더를 로컬 프로젝트로 추가합니다. 버튼 이름은 언어 및 앱 버전에 따라 다를 수 있으나, 로컬 컴퓨터의 프로젝트를 추가하는 옵션을 선택하면 됩니다.
3. 해당 프로젝트 내에서 새 작업을 열고 Astra가 선택되어 있는지 확인합니다.
4. 짧은 확인 메시지를 전송합니다: “한 단어로 답해줘: 완료”.

연결 오류 없이 응답이 돌아온다면 Blender로 넘어갈 준비가 된 것입니다. API 연결의 경우 이 호출 내역이 BetterToken 사용 기록에도 표시되어야 합니다. 이는 모델 연결을 확인하는 과정이며, Blender 창 제어는 별도로 테스트합니다.

프로젝트 폴더에는 .blend 파일, 렌더링된 이미지 및 애니메이션이 저장됩니다. 다음 수정 작업 시에도 동일한 작업 세션으로 돌아와야 Codex가 이전 지시 사항의 맥락을 유지할 수 있습니다.

3. Blender 설치 및 실행

Blender는 모델링, 재질, 애니메이션, 렌더링을 모두 지원하는 무료 3D 제작 도구입니다. Blender 공식 다운로드 페이지에서 다운로드할 수 있습니다.

1. 운영체제에 맞는 설치 파일을 선택합니다. Mac의 경우 프로세서 아키텍처(Apple Silicon 또는 Intel)를 올바르게 확인하세요.
2. macOS에서는 다운로드한 디스크 이미지를 열고 Blender를 Applications 폴더로 드래그합니다. Windows에서는 설치 프로그램을 실행하고 안내 단계를 따릅니다.
3. Blender를 실행합니다. 처음 열릴 때는 기본 설정을 유지하고 새 파일에서 General을 선택합니다.
4. 화면 중앙에 기본 큐브가 보이고 오른쪽 씬 아웃라이너에 Cube, Camera, Light가 표시됩니다. 아직은 삭제하지 마세요.
5. File → Save As로 이동하여 astra-blender 폴더 안에 **desk-lamp.blend**라는 이름으로 파일을 저장합니다.

설치 과정을 Codex에 맡기고 싶다면 생성한 프로젝트 안에서 다음 프롬프트를 전송하세요:

이 컴퓨터에 https://www.blender.org/download/ 에서 Blender를 설치하도록 도와줘.
먼저 Blender가 이미 설치되어 있는지 확인해 줘. 공식 안정화 빌드를 사용해야 해.
내가 직접 진행해야 하는 설치 프로그램 단계나 시스템 권한 설정이 있다면 설명해 줘.
Blender를 실행하고 어떤 버전이 실행 중인지 알려줘.

Blender 창이 실제로 열려야 설치가 완료된 것입니다. Codex의 답변에 다운로드 링크만 포함된 것으로는 충분하지 않습니다. 운영체제별 공식 설치 가이드는 Blender 매뉴얼에서 확인할 수 있습니다.

4. 공식 Computer Use 플러그인 설치

이후의 단계는 구독 방식과 BetterToken API Key 방식 모두 동일합니다:

1. 애플리케이션 내에서 Plugins로 이동합니다.
2. OpenAI의 Computer Use를 찾아 Install plugin을 클릭합니다.
3. 설치 후 버튼에 Enable이 표시되면 플러그인을 활성화합니다.
4. 플러그인 카드에서 MCP server와 Skill을 모두 켭니다. 서버는 제어 도구를 제공하고, Skill은 이를 사용하는 지침을 제공합니다.
5. Settings → Computer use로 이동하여 애플리케이션 제어 옵션인 Any App 토글이 있다면 활성화합니다. 앱에서 Blender 제어 권한을 요청하면 허용합니다.
6. Mac에서는 시스템 설정에서 요청된 화면 기록(Screen Recording) 및 손쉬운 사용(Accessibility) 권한을 부여합니다. 시스템 재시작 요청이 있으면 앱을 다시 실행합니다.
7. 프로젝트 작업으로 돌아옵니다. 필요한 경우 새로 설치된 플러그인 도구가 올바르게 로드되도록 새 작업을 엽니다.

공식 Computer Use 가이드에서 해당 설정의 상세 위치를 확인할 수 있습니다. Windows 환경에서는 에이전트가 활성 세션의 마우스와 키보드를 사용하므로, Blender를 활성 데스크톱 화면에 표시해 두고 작업 중 컴퓨터를 잠그지 마세요.

이제 인터페이스 직접 제어 테스트를 진행합니다:

공식 Computer Use 플러그인을 사용하여 열려 있는 Blender 창을 확인해 줘.
현재 파일 이름과 씬 목록에 보이는 오브젝트들을 알려줘.
Blender 인터페이스를 통해 Cube의 이름을 Connection_Test로 변경해 줘.
업데이트된 씬 목록을 보여준 뒤 작업을 멈춰줘. 오브젝트를 새로 만들거나 삭제하지 마.

Blender 창을 확인합니다. 큐브는 제자리에 그대로 남아 있어야 하며, 씬 목록에서의 이름이 Connection_Test로 변경되어야 합니다. Codex가 직접 실행하지 않고 설명만 제시한다면 Computer Use를 통해 작업을 직접 수행하도록 명시적으로 지시하세요. 이 간단한 단계로 에이전트가 올바른 창을 보고 조작할 수 있는지 검증할 수 있습니다.

5. 첫 번째 3D 모델 제작

검증하기 쉬운 형태인 원형 받침대, 수직 기둥, 각도가 있는 암, 그리고 갓으로 구성된 탁상용 스탠드 조명부터 시작합니다. 에이전트에게 전체 요구사항을 제시하고 사용 가능한 도구 중 가장 안정적인 방식을 선택하도록 허용하세요.

현재 Blender 프로젝트에 작은 탁상용 스탠드를 만들어 줘. 필요한 경우
Computer Use, Blender Python (bpy) 또는 Blender 백그라운드 명령을
사용해도 좋아. 사용 가능한 도구 중 가장 안정적인 방식을 선택하고,
Blender MCP가 설치되어 있다고 가정하지 마.

연결 확인에 사용했던 Connection_Test 오브젝트만 교체해 줘.
Z=0의 평평한 바닥 위에 놓이는 둥근 받침대, 수직 기둥, 짧고 기울어진 암,
두께감이 있는 원뿔형 갓, 그리고 내부 전구를 만들어 줘.
각 부품은 Lamp_Base, Lamp_Stem, Lamp_Arm, Lamp_Shade, Lamp_Bulb, Ground
라는 이름의 개별적으로 편집 가능한 오브젝트로 유지해야 해.

실제 결과물의 정렬 상태, 비율, 부품 간의 연결 상태를 검증해 줘.
램프 전체가 잘 보이도록 카메라를 배치하고, 이 프로젝트에 desk-lamp.blend로
저장한 뒤 정면 뷰와 원근 뷰를 보여주고 피드백을 위해 멈춰줘.

실제 실행 과정과 결과

이 실제 작업은 macOS 환경의 ChatGPT 데스크톱 앱 버전 26.908.40834에서 Blender 5.2.1 LTS와 GPT-6 Astra High 모델을 사용하여 진행되었습니다. 먼저 Computer Use가 큐브의 이름을 Connection_Test로 변경했습니다. 그런 다음 Codex는 bpy 스크립트를 작성하고 Blender 내장 Python을 활용해 실행했습니다. 사용자가 별도의 Python 환경을 설치하거나 가상 환경을 구성하거나 단계별 도구를 일일이 지정할 필요가 없었습니다.

열려 있는 Blender 대화형 콘솔을 통한 키보드 입력이 불안정해졌을 때, Codex는 Blender 백그라운드 CLI로 전환하여 Lamp_Arm과 Lamp_Shade의 연결을 마무리하고 렌더링을 준비했습니다. 이후 에이전트는 저장된 .blend 파일을 Blender GUI에서 다시 열고 결과를 시각적으로 검토했습니다.

씬에는 Lamp_Base, Lamp_Stem, Lamp_Arm, Lamp_Shade, Lamp_Bulb, Ground라는 독립된 오브젝트들이 유지되었습니다. 받침대 바닥면은 Z=0 위치에 정확히 안착되었고, 조명 갓은 적절한 두께를 가졌으며, 전구는 갓 내부에 올바르게 배치되었습니다.

본인의 씬에서도 동일한 기준을 확인하세요. 받침대가 바닥 평면에 평평하게 닿아 있는지, 기둥이 갓과 깔끔하게 연결되었는지, 램프 전체가 카메라 프레임 안에 들어오는지, 각 부품을 개별적으로 선택할 수 있는지 점검합니다. 문제가 있다면 한 번에 하나씩 수정하고 성공할 때마다 파일을 저장하세요.

6. 재질 및 조명 추가

외형 모델링이 만족스럽다면 재질과 씬의 시각적 요소로 넘어갑니다:

desk-lamp.blend에 있는 기존 탁상용 스탠드 작업을 이어가 줘.
지오메트리와 오브젝트 이름은 그대로 유지해야 해. Lamp_Base와 Lamp_Shade에는
다크 그린 에나멜 마감을, Lamp_Stem과 Lamp_Arm에는 브러시드 황동을,
Lamp_Bulb에는 따뜻한 발광 효과를 지정해 줘. Ground에는 중립적인 재질을
적용하고 3점 스튜디오 조명을 설치해 줘.

Cycles를 사용하여 카메라 뷰에서 깔끔한 프리뷰를 렌더링해 줘.
공중에 뜬 부품, 교차 오류, 구도 문제, 비정상적인 반사가 없는지 이미지를
검토한 다음, 프리뷰와 desk-lamp.blend를 저장해 줘.

실제 실행에서 받침대와 갓에는 짙은 녹색 에나멜 재질이, 기둥과 암에는 브러시드 황동 재질이 적용되었으며, 전구에는 따뜻한 발광 효과가 부여되었습니다. Codex는 3점 스튜디오 조명을 구성하고 Cycles로 결과를 렌더링했습니다. 최종 완성 컷은 글 상단에서 확인할 수 있습니다.

심화 작업을 위한 단계: 공식 Blender MCP 연결

Computer Use는 화면 인터페이스를 조작합니다. 반면 MCP는 실행 중인 Blender 인스턴스와 Codex 사이에 전용 통신 채널을 제공하여 씬 데이터를 직접 읽고 작업을 실행할 수 있게 합니다. 위에서 설명한 워크플로에서는 Blender MCP가 설치되지 않았으며 필수적이지도 않았습니다. Codex는 Computer Use와 Blender의 내장 Python/CLI 기능을 활용했습니다. MCP는 향후 프로젝트를 위한 선택적 확장 기능입니다.

1. Blender 웹사이트의 MCP 페이지를 방문하여 공식 Setup 가이드로 이동합니다.
2. Blender 버전을 확인합니다. 현재 공식 프로젝트는 5.1 이상을 요구합니다.
3. 동일한 Codex 작업 세션에서 Setup 링크를 제공하고 Blender 확장 기능(Add-on)과 독립형 MCP server를 모두 설정한 뒤 server를 Codex에 등록하도록 요청합니다. 이 둘은 연결을 구성하는 별개의 요소입니다.
4. 확장 기능 패키지가 준비되면 Blender에서 Edit → Preferences → Add-ons → Install from Disk로 이동하여 ZIP 파일을 선택하고 확장 기능을 활성화합니다. Codex가 Computer Use로 이 과정을 안내할 수도 있습니다.
5. 확장 기능 환경설정에서 연결 서버를 시작합니다. 확장 기능과 MCP server는 반드시 동일한 호스트 주소와 포트를 공유해야 하며, 최신 공식 가이드에 명시된 값을 사용하세요.
6. 동일한 Codex 프로젝트에서 새 작업을 열고 MCP를 통해 오브젝트 목록을 조회하도록 요청합니다. Lamp_Base, Lamp_Shade 및 기타 부품 이름이 Blender와 일치하는지 확인합니다.

오브젝트 목록이 정확히 일치할 때까지는 형상 수정을 진행하지 마세요. 연결이 검증된 후에는 형상 제작은 MCP에 맡기고, 창 상태 검토와 렌더링 프레임 확인은 Computer Use에 맡길 수 있습니다. 연결이 끊어지면 오브젝트가 중복 생성되지 않도록 항상 현재 씬의 상태를 먼저 점검하세요.

7. 짧은 애니메이션 제작

안정적인 정적 모델이 저장되었다면 Codex에 360도 카메라 턴테이블 애니메이션 구성을 요청합니다. 애니메이션은 동일한 desk-lamp.blend 파일 안에서 작업할 수 있습니다:

기존 desk-lamp.blend 씬에서 24 fps 기준 5초짜리 360도 카메라 궤도 회전
애니메이션을 만들어 줘. 1프레임(0도)과 121프레임(360도)에 키프레임을 설정하고,
반복 재생 시 끝점이 중복되지 않도록 1프레임부터 120프레임까지만 렌더링해 줘.
Cycles를 사용하고 해상도는 1280x720, 샘플 수는 32 samples로 설정해 줘.
램프는 고정된 상태를 유지하고 모든 부품은 편집 가능한 상태여야 해.

먼저 테스트용으로 1, 41, 81프레임을 렌더링해 줘. 확인이 완료되면 120개의
모든 PNG 프레임을 renders/ 폴더에 렌더링하고, desk-lamp-orbit.mp4라는
이름의 5초짜리 H.264 MP4 파일로 인코딩해 줘. 씬을 desk-lamp.blend에 저장해 줘.

실제 프로젝트에서 Codex는 먼저 1, 41, 81프레임을 테스트 렌더링하여 확인했습니다. 그런 다음 Cycles(32 samples)를 통해 1280x720 해상도의 PNG 파일 120개를 renders/ 폴더에 렌더링했습니다. 121프레임은 360° 위치 데이터를 담고 있지만 최종 출력에서는 제외되어 5초 루프의 시작점과 끝점이 겹치지 않도록 처리되었습니다.

시스템 FFmpeg 바이너리가 libvpx.11.dylib 라이브러리 누락으로 실행되지 않는 문제가 발생했습니다. Codex는 Blender 5.2.1의 자체 기능을 확인하고, 시스템 환경을 수정하는 대신 Blender 내장 H.264 비디오 인코더를 활용했습니다. 컴파일 전 120개의 PNG 파일이 모두 존재하며 파일 크기가 0이 아님을 확인한 후, 120프레임, 24 fps, 1280x720 설정으로 H.264 MP4 출력을 구성했습니다. 인코딩이 끝나면 비디오 파일을 열어 5초 동안 부드럽게 재생되는지 확인하세요.

프레임 렌더링 속도가 느리다면 Codex에 현재 렌더링 진행률 보고를 요청하세요. 이전 렌더링의 완료 여부를 확인하기 전에 동일한 씬의 렌더링을 중복 실행하지 마세요.

문제 해결

증상	확인 사항
Codex가 응답하지 않거나 401 오류를 반환하거나 모델을 찾지 못함	API 연결의 경우 API Key, GPT 제공자, gpt-6-astra 설정 및 설치 스크립트 결과를 확인하세요. 애플리케이션을 완전히 재시작하세요
모델은 응답하지만 Computer Use 도구가 표시되지 않음	플러그인 설치 상태를 확인하고, 서버와 Skill 토글이 모두 켜져 있는지 확인한 후 새 작업을 시작하세요
도구는 있지만 Blender 창에 접근할 수 없음	Blender 접근 권한을 허용하세요. Mac의 경우 화면 기록(Screen Recording) 및 손쉬운 사용(Accessibility) 권한을 확인하고, Windows의 경우 활성 데스크톱이 잠겨 있지 않은지 확인하세요
에이전트가 작업 내용만 설명하고 실제로 변경하지 않음	Computer Use를 통해 작은 작업을 직접 실행하고 완료 후 상태를 보여달라고 명시적으로 요청하세요
MCP가 연결되었지만 다른 씬이 표시됨	현재 열려 있는 .blend 파일, 실행 중인 Blender 인스턴스, 확장 프로그램의 호스트 주소 및 포트를 확인하세요
호출이 중단되었거나 시간 초과(timeout)가 발생함	먼저 오브젝트 목록과 저장된 파일 목록을 요청하세요. 마지막으로 완료된 단계부터 작업을 이어가세요
시스템 FFmpeg가 실행되지 않음	이번 프로젝트에서 Codex는 Blender 내장 H.264 인코더를 사용했습니다. 현재 Blender 빌드가 필요한 형식을 지원한다면 안정적인 대안이 될 수 있습니다
이미지가 부자연스럽게 보임	기본 지오메트리와 단일 카메라 앵글로 돌아가세요. 전체 렌더링을 진행하기 전에 비율, 교차 문제, 조명을 먼저 수정하세요

이 과정을 모두 마치면 desk-lamp.blend, 검증용 이미지, renders/ 폴더 내 120개의 PNG 파일, 그리고 desk-lamp-orbit.mp4가 생성되어 있어야 합니다. .blend 파일을 다시 한 번 열고 Codex에 특정 수정 작업을 한 가지 지시하여 부품들이 여전히 개별적으로 편집 가능한지 확인해 보세요.