Claude AI와 Blender로 3D 모델 만들기 — 대화에서 .blend 파일까지

blender.org에서 Blender를 내려받으세요. 무료 오픈소스(GPL 라이선스)이며 Windows, macOS, Linux에서 동작합니다. 4.0 이상 버전을 설치하세요. Blender에는 완전한 Python 인터프리터와 방대한 Python API가 들어 있어 프로그램의 모든 작업을 스크립트로 실행할 수 있습니다. Claude가 3D 모델을 만들 때 쓰는 것이 바로 이것으로, Blender의 모든 버튼, 메뉴, 도구에는 Python에 대응하는 명령이 있습니다.

설치한 뒤 Blender를 한 번 열어 실행되는지 확인하세요. 정육면체, 카메라, 조명이 있는 기본 시작 장면이 보입니다. 확인했으면 닫으세요. AI와 작업할 때는 Blender를 원격으로 제어합니다.

Claude를 Blender에 연결하는 방법은 두 가지입니다. 자신의 환경에 맞는 것을 고르세요.

방법 A — Blender MCP 서버(Claude Desktop): Blender에 Model Context Protocol(MCP) 애드온을 설치해 Blender를 로컬 서버로 만듭니다. Claude Desktop이 여기에 직접 연결되어 Python 코드를 실행하고, 뷰포트 스크린숏을 찍고, 장면 정보를 읽을 수 있습니다. 그동안 여러분은 Blender 창에서 모델이 실시간으로 만들어지는 모습을 봅니다.

방법 B — 화면 없는 Blender API(Claude Code): Blender를 화면 없는 모드(GUI 없음)로 실행하고 FastAPI 서버로 감쌉니다. Claude Code가 HTTP로 Python 스크립트를 보내면 Blender가 실행하고 결과 파일을 돌려줍니다. 일괄 작업에 더 빠르고 원격 서버에서도 돌아가지만 뷰포트를 실시간으로 볼 수는 없습니다. 완성된 .blend 파일은 나중에 검토합니다.

변경 사항을 하나하나 보며 설계하는 대화형 작업에는 방법 A가 낫습니다. 자동화된 처리, 서버 측 생성, 화면 없는 환경의 작업에는 방법 B가 낫습니다.

GitHub에서 Blender MCP 애드온을 설치하세요('blender-mcp' 프로젝트로, 프로젝트에서는 MCP for Blender라고 부릅니다. 이 애드온은 Blender 안에서 Claude와 통신할 수 있는 서버를 실행합니다). addon.py 파일을 내려받은 뒤 Blender에서 Edit → Preferences → Add-ons → Install… → addon.py를 선택하고 'Interface: MCP for Blender'를 활성화합니다. 3D 뷰포트에서 N을 눌러 사이드바를 열고 MCP for Blender 탭을 선택합니다.

'Start MCP Server'를 클릭하세요. 이제 Blender가 Claude의 연결을 기다립니다. Claude Desktop 설정에서 Blender MCP 서버를 도구 제공원으로 추가하세요(설정 스니펫은 프로젝트 README에 있습니다). 연결되면 Claude는 execute_blender_code, get_scene_info, get_viewport_screenshot 같은 도구를 쓸 수 있습니다. 대화로 3D 모델을 설계하는 데 필요한 모든 것이 갖춰집니다.

화면 없는 Blender를 감싸는 FastAPI 서버를 만드세요. 서버는 POST /execute 엔드포인트로 Python 스크립트를 받아 Blender의 백그라운드 모드(blender --background --python)에서 실행하고 결과 파일을 돌려줍니다. 가장 단순한 서버에는 엔드포인트 하나면 충분합니다.

Claude에게서 받은 Python 코드를 작업 디렉터리의 파일(예: job.py)에 쓰고 다음 명령으로 실행하세요: blender --background --python job.py. 만들어진 .blend 파일을 작업 디렉터리에 저장하고 GET /files 엔드포인트로 제공합니다. Claude Code는 이 HTTP 엔드포인트들을 호출해 스크립트를 보내고 완성된 모델 파일을 받아 옵니다.

이는 AI 이미지 생성 파이프라인(ComfyUI)에서 쓰는 것과 같은 구조입니다. API로 감싼 화면 없는 창작 도구를 GPU가 있는 서버에서 실행합니다.

만들고 싶은 것을 쉬운 말로 Claude에게 알려 주세요. 치수, 재료, 물리적 성질은 구체적으로 밝히세요. 예를 들면 다음과 같습니다.

'무게 1 kg의 가로 펜 대장장이 망치 머리를 설계해 줘. 타격면은 모서리를 둥글린 정사각형으로, 펜은 금속을 밀어 늘이도록 수평(Z 방향으로 얇고 Y 방향으로 넓게)으로 해 줘. 평평한 양면에 고대 푸사르크 룬 ᚦᛟᚱ(TOR)를 깊이 3 mm로 새겨 줘. 부피가 정확히 127.4 cm³(밀도 7850 kg/m³인 담금질 강철 1 kg)가 되도록 지오메트리 크기를 조정해 줘. 자루를 끼울 타원형 구멍도 넣어 줘.'

Claude는 이 설명을 Blender Python 작업의 순서로 바꿉니다. 설명이 정확할수록 첫 버전이 원하는 모습에 가까워집니다. '더 크게' 같은 상대적인 표현 대신 실제 수치(밀리미터, 그램, 도)를 쓰세요.

Claude는 Blender의 Python API(bpy 모듈)로 모델을 만드는 Python 스크립트를 작성합니다. 망치 머리의 전형적인 순서는 다음과 같습니다.

1. 정육면체 프리미티브를 만들고 망치의 대략적인 치수로 크기를 조정한다
2. 형태를 잡을 지오메트리를 늘리기 위해 메시를 세분한다
3. 정점을 하나씩 다뤄 가로 펜의 가늘어짐, 타격면의 윤곽, 가운데의 볼록한 부분을 빚는다
4. 부드러운 곡면을 위해 Subdivision Surface 모디파이어를 적용한다
5. 원기둥으로 불리언 DIFFERENCE 연산을 해 자루 구멍을 뚫는다
6. 메시의 부피를 계산해 강철 1 kg이 되도록 모든 방향에 같은 배율을 적용한다
7. 룬의 획마다 작은 절삭용 정육면체를 만들어 불리언 연산으로 표면에서 빼낸다

Claude는 이 스크립트를 Blender로 보냅니다(MCP나 API를 통해). Blender가 스크립트를 실행해 3D 지오메트리를 만듭니다. MCP(방법 A)를 쓰면 모델이 뷰포트에 실시간으로 나타나는 것을 볼 수 있습니다.

모델을 살펴보세요. 방법 A에서는 Blender 뷰포트에서 모델 주위를 돌아보세요. 방법 B에서는 .blend 파일을 내려받아 Blender에서 열거나, Claude에게 뷰포트 스크린숏을 렌더링해 달라고 하세요. 치수, 비율, 세부의 정확도를 확인하세요. 첫 버전에서 흔한 문제와 Claude에게 고쳐 달라고 하는 방법은 다음과 같습니다.

• 한쪽 면의 글자가 뒤집혀 보인다 → 어느 면(+Y 또는 -Y)을 대칭 반전해야 하는지 지정한다
• 모델이 너무 작거나 크다 → 목표 치수를 mm로 알려 준다
• 곡면에서 새긴 자국이 사라졌다 → 새기는 위치마다 표면의 실제 위치를 Claude가 조회해야 한다
• 불리언 연산이 메시를 망가뜨렸다 → 합친 지오메트리가 아니라 획마다 따로 절삭용 오브젝트를 쓰라고 알려 준다
• 형상이 엉뚱한 축에 있다 → 항상 축 표기(+X, -Y, +Z)로 전하고, 3D에서 모호한 '앞'이나 '뒤'는 절대 쓰지 않는다

수정 하나하나가 대화의 한 턴입니다. 문제를 설명하면 Claude가 스크립트를 고쳐 다시 실행하고, 여러분이 다시 검토합니다. 보통 두세 번에서 다섯 번 반복하면 완성된 모델이 나옵니다.

모델을 돌려 가며 모든 면을 확인하세요. 평평한 양면에서 룬 새김이 제대로 읽히는지 확인합니다. +Y 면의 글자는 +Y 방향에서 보면 자연스럽게 거울상으로 보여야 하고, -Y 면의 글자는 -Y 방향에서 바르게 읽혀야 합니다. 자루 구멍이 깔끔하고 가운데에 있는지 확인하세요. 가로 펜이 들쭉날쭉한 가장자리 없이 매끄럽게 가늘어지는지도 확인하세요.

Blender에서 Numpad 1은 앞(-Y 방향 보기), Ctrl+Numpad 1은 뒤(+Y 방향 보기), Numpad 3은 오른쪽(+X 방향 보기), Numpad 7은 위(+Z 방향 보기)입니다. 이런 정사영 보기는 원근 보기에서 숨겨지는 정렬 문제를 드러냅니다.

모델을 .blend 파일로 저장하세요(File → Save As, 또는 스크립트로 bpy.ops.wm.save_as_mainfile(filepath='model.blend')). .blend는 Blender 고유의 형식이며 보관과 공유에 가장 좋은 선택입니다.

• 모든 모디파이어 스택, 머티리얼, 장면 설정, 편집 기록을 그대로 보존한다
• 완전히 편집할 수 있다: 다른 maker가 열어서 룬 글자를 바꾸거나, 다른 무게에 맞게 크기를 바꾸거나, 어떤 매개변수든 조정할 수 있다

.blend 파일이 이 모델의 유일한 원본입니다.

Youblob에서 blueprint를 만들거나 편집할 때 디자인 단계(콘텐츠 유형: 'design')를 추가하고 .blend 파일을 업로드하세요. Youblob은 .blend 파일을 브라우저 안에서 대화형 3D 미리 보기로 보여 주고, 내려받을 수 있게 하며, 다른 형식으로 변환하지 않고 바로 3D 프린팅용으로 준비할 수 있습니다.

다른 makers가 정확한 사양을 알 수 있도록 모델의 치수, 무게, 재료 밀도를 단계 설명에 적으세요. 파라메트릭 모델(무게에 맞춰 크기를 조정한 이 망치처럼)에서는 맞춤 설정을 위해 어떤 변수를 바꾸면 되는지 기록하세요. 다른 makers가 처음부터 시작하지 않고도 자신의 필요에 맞게 설계를 고칠 수 있어야 합니다.

Claude와 함께 북유럽풍 망치 머리와 다른 모델을 설계하며 얻은 교훈입니다.

• 방향이 아니라 축으로 말하기: '+Y 면', '-Z 축'이라고 말하고 '앞'이나 '위'라고는 절대 말하지 않는다. 이런 말은 3D에서 모호해 거울상 결과로 이어진다.
• 불리언 연산에는 개별 절삭용 오브젝트가 필요하다: 불리언 연산 전에 여러 프리미티브를 합치면 매니폴드가 아닌(non-manifold) 지오메트리가 생긴다. 절삭용 오브젝트는 각각 별도 오브젝트로 둔다.
• 실제 표면을 조회하기: 세분과 모디파이어를 거치면 메시 표면은 원래 치수가 가리키는 위치에 있지 않다. 새김이나 절삭을 배치하기 전에 Claude가 정점 위치를 측정해야 한다.
• 치수가 아니라 부피로 크기 조정하기: 목표 무게에 맞추려면 부호 있는 사면체 방법으로 메시 부피를 계산한 다음 모든 방향에 같은 배율을 적용한다: (target_vol / current_vol) ^ (1/3).
• 2~5회 반복하기: 첫 스크립트는 80% 정도 맞는다. 검토와 수정을 한 바퀴 돌 때마다 남은 문제가 잡힌다. 다섯 번 정도 반복하면 보통 생산에 쓸 수 있는 모델이 된다.