이미 사용하고 있는 도구 내에서 작동하는 Blender 에이전트입니다.
Codex와 Claude Code를 위한 무료 오픈 소스 Blender AI 플러그인으로, 모델, 애니메이션 및 씬을 생성하고 다듬는 데 사용할 수 있습니다. 이 플러그인은 에이전트가 작업을 계획하고, 로컬 Blender 설치에서 구축하며, 전달하기 전에 결과를 검사할 수 있는 방법을 제공합니다.
만들고 싶은 것을 설명하세요. 편집 가능한 .blend 파일과 이를 구축한 Python 코드를 보관합니다. 목표는 이식 가능한(portable) Blender 에이전트입니다: 기존의 에이전트 하네스에서 사용할 수 있는 열린 워크플로우와 로컬 도구들이 필요합니다. Codex와 Claude Code는 오늘날 플러그인 설치 프로그램을 번들로 제공합니다. 다른 호스트들은 호환되는 스킬 로딩과 로컬 실행이 필요합니다. 포터빌리티 및 호스트 요구 사항을 참고하세요.
문서(Docs) · 설치(Install) · 예시(Examples) · 사용해 보기(Try it) · 작동 방식(How it works) · 워크플로우(Workflows) · 개발(Development) · 버그 신고(Report a bug)
게시된 갤러리 중 하나의 예시는 Claude Code와 Sonnet 5.5로 구축한 독서실입니다. 이미지는 저장된 씬의 HD 렌더링 결과물입니다. 플러그인 사용 유무에 따른 실패 검사 및 혼합 시각적 리뷰를 포함하여 쌍을 이루는 예시들을 탐색해 보세요. 이 선택된 예시는 평균적인 품질을 보장하는 것이 아닙니다.
-
소품, 환경, 캐릭터, Geometry Nodes 설정을 구축합니다.
-
선택적으로 실제 모델링 마일스톤을 기록하고, 빈/기본 씬에서 완성된 렌더까지 타임랩스를 제공합니다. 모델링 시작 전에 질문하세요; 가이드를 캡처합니다.
-
여러 각도에서 레퍼런스를 수집하고 디테일을 추가하기 전에 모델의 비율을 비교합니다.
-
참조 이미지 위에 투영된 지오메트리(projected geometry)를 오버레이하고, 누락되거나 과도한 커버리지를 위한 선택적 실루엣 마스크 측정 기능을 사용합니다. 레퍼런스 모델링을 참고하세요.
-
모델을 리깅하고 애니메이션하거나, 천, 연기 및 기타 시뮬레이션 작업을 수행합니다.
-
씬의 조명을 그대로 유지하며 씬 카메라를 통해 렌더링하거나, 스튜디오 뷰를 사용하여 모든 각도에서 모델을 검사할 수 있습니다.
-
Poly Haven에서 CC0 텍스처와 HDRI를 1K, 2K, 4K 또는 8K로 다운로드합니다.
-
브라우저를 통해 Mixamo 모션을 찾고 다운로드한 FBX 애니메이션을 새로운 .blend 파일에 가져옵니다.
-
브라우저 요구 사항 및 리타겟팅 제한에 대한 Mixamo 워크플로우를 참조하세요. - 브라우저 핸드오프를 통해 Pixabay 사운드 효과를 찾고 미리 볼 수 있습니다. 이 도구는 검색 URL과 워크플로우를 제공하며, 실시간 결과나 오디오 가져오기는 수행하지 않습니다. MCP 통합 가이드를 참조하세요.
-
지오메트리를 확인하고 내보낸 파일을 검토하며, 렌더링을 검토하고 작동하지 않는 부분을 수정합니다.
-
장면의 부분과 평가된 치수를 질의하고, 명시적 지오메트리와 바닥 제약을 확인하며, 선택적 Rust 런타임을 사용하여 수리 사항을 보존된 SceneIR 기준선과 비교합니다.
이 플러그인은 11가지 전문 기술과 검사, 렌더링 및 에셋 다운로드를 위한 로컬 MCP 서버를 포함합니다. 생성된 장면에는 Python 소스가 함께 제공되어 재구축하고 지속적으로 변경 사항을 적용할 수 있습니다.
이 기술들은 모델링, 렌더링, 애니메이션 및 기타 작업을 통해 에이전트를 안내합니다. Blender는 로컬에서 실행되어 저장된 장면을 구축하거나 검사하며, 인터페이스를 계속 열어둘 필요가 없습니다. 에이전트가 요청에 맞는 관련 단계를 선택합니다. 워크플로우와 도구들은 다음과 같은 도움을 줍니다:
- 간략한 내용을 부분, 비율, 마감 목표 및 전달 확인 사항으로 변환합니다. 재료나 작은 세부 사항에 시간을 투자하기 전에 그레이박스를 검토하세요.
- 지오메트리, 재료, 치수 및 기타 장면 세부 사항을 확인합니다. 내보내기를 위해 새 Blender 프로세스에서 파일을 다시 열어 무엇이 살아남았는지 확인할 수 있습니다.
- 히어로 뷰와 고정된 전면, 후면, 좌측, 우측, 상단 뷰를 렌더링합니다. 수리 중에는 전체 검사 전에 더 빠른 피드백을 위해 두 개의 작은 뷰를 사용할 수 있습니다.
- 에셋에 맞춰 조정된 스튜디오 설정으로 진단 뷰를 조명합니다.
auto 프리셋은 단순한 재료 색상 힌트에서 대비되는 배경을 선택하며, 에이전트는 여전히 이미지를 검사하고 선택이 실패할 때 조정해야 합니다. - 아름다운 이미지의 경우 장면 자체의 카메라와 조명을 통해 렌더링합니다. 이 도구는 해상도, 샘플 수 및 렌더 시간을 제한합니다. 더 빠른 preview와 더 높은 품질의 final을 제공합니다.
디노이징 정책(denoising policies); 기본적으로 장면의 작성된 디노이징 설정은 유지됩니다. 에이전트가 작업에 맞는 정책을 선택합니다.
.blend 파일은 수정 가능한 결과물입니다. Python 소스 코드는 빌드 단계를 기록하므로, 나중에 이를 재생성하거나 에이전트에게 변경하도록 요청할 수 있습니다. 워크플로우 가이드에서는 각 유형의 작업에 적용되는 전문 기술(specialist skills)을 설명합니다. 스튜디오 뷰는 검사용이며, 아름다운 렌더링(beauty renders)에서 장면 작성 디스플레이 라이팅을 대체하지 않습니다.
Codex 또는 Claude Code와 플러그인 지원, Bun, 그리고 Blender가 필요합니다. 테스트된 버전은 Blender 5.2 LTS이며, Bun 1.3.5 이상을 사용하세요. 두 호스트 모두 이 저장소에서 동일한 기술(skills), MCP 서버, 및 SceneIR 도구를 설치합니다.
Codex
codex plugin marketplace add ifBars/blender-agent-studio
codex plugin add blender-agent-studio@blender-agent-studio
Claude Code
claude plugin marketplace add ifBars/blender-agent-studio
claude plugin install blender-agent-studio@blender-agent-studio
Claude Code 세션 내부에서는 /plugin marketplace add ifBars/blender-agent-studio와 /plugin install blender-agent-studio@blender-agent-studio가 동일한 작업을 수행합니다.
blender를 PATH에 추가하거나, BLENDER_EXECUTABLE을 해당 위치로 설정하세요. 예를 들어, PowerShell에서는 다음과 같습니다:
$env:BLENDER_EXECUTABLE = "C:\path\to\Blender\blender.exe"
플러그인을 설치하거나 업데이트한 후 새로운 Codex 작업 또는 Claude Code 세션을 시작하세요. Codex에서는 $blender-agent-studio:blender-modeling-workflow와 같이 기술을 호출하고, Claude Code에서는 /blender-agent-studio:blender-modeling-workflow와 같이 호출합니다. 두 호스트 모두 일반 요청에서 관련 기술을 가져옵니다.
선택적인 장면 이해 도구(scene-understanding tools)의 경우, bun run setup:runtime으로 설치된 플러그인 디렉터리에서 Rust 런타임을 빌드하세요. 설정, 예제 및 측정 한계에 대해서는 장면 이해(scene understanding)를 참조하세요. 기존 도구들은 Rust가 필요하지 않습니다.
기존 GitHub 설치 업데이트
Codex:
codex 플러그인 마켓플레이스 업그레이드 blender-agent-studio
codex 플러그인 추가 blender-agent-studio@blender-agent-studio
Claude Code:
claude 플러그인 마켓플레이스 업데이트 blender-agent-studio
claude 플러그인 업데이트 blender-agent-studio@blender-agent-studio
Skills만 선호하십니까? 대체 설치 옵션을 확인하고 skills.sh에서 워크플로우를 찾아보세요.
Blender Agent Studio를 사용하여 월넛 책상 램프를 제작해 보세요. 따뜻한 조명을 주고, 두 각도에서 렌더링하여 .blend 및 Python 소스를 저장하도록 요청하세요.
스타일, 치수, 의도된 용도가 중요할 때는 포함시키세요. 게임 에셋의 경우 GLB 내보내기(export)와 올바르게 가져오는지 확인하는 점검을 요청하세요. 렌더링의 경우 카메라 각도, 조명 또는 참조 이미지를 지정할 수 있습니다.
또한 에이전트에게 기존 .blend 파일을 제공하고 장면을 검사하거나 개선하도록 요청할 수도 있습니다. 두 번째 검토를 위해 여러 시점에서 결과를 확인하도록 요청해 보세요.
랜턴, 레버 프레스, 애니메이션 도개교를 다루는 다섯 쌍의 새롭고 일치하는 사례에서, 이 플러그인의 안내된 워크플로우는 기술 게이트(technical gate)를 5번 통과했습니다. 반면 에이전트 단독으로는 5번 실패했습니다. 세 명의 블라인드 시각 심사위원들은 다섯 쌍 중 네 쌍에서 플러그인 에셋을 선호했습니다. 한 랜턴 반복 사례에서는, 기하학적 구조가 기술 게이트를 통과하지 못했음에도 불구하고 세 명 모두 기준선(baseline)의 외관을 선호했습니다. 이 플러그인은 더 많은 토큰이 사용된 것으로 보고되었습니다. 랜턴 제작 시간은 세 쌍에 걸쳐 비슷했지만, 프레스와 도개교 플러그인 실행 시간이 약 두 배 더 오래 걸렸습니다. 점수, 제어 장치 및 결함에 대한 현재의 페어드 증거(paired evidence)를 확인하세요.
이 결과들은 테스트된 프롬프트에서 전달 확인(delivery checks)에 대한 품질 향상을 보여주지만, 시각적인 개선은 덜 일관적입니다. 다섯 쌍의 경우 임의의 프롬프트, 모델 또는 아트 스타일에 대해 신뢰할 수 있는 성공률을 제시할 수 없습니다. 각 쌍의 세 명의 심사위원은 동일한 두 개의 에셋을 검토했으며, 그들의 투표는 별도의 생성물이 아닙니다. 비교에는 플러그인의 스킬만 사용되었고 선택적 MCP 도구는 사용하지 않았으므로, 해당 도구들의 추가적인 이점을 측정하지 못합니다. 이전의 네 가지 작업 비교에서도 플러그인의 최종 실행이 선호되었지만, 더 어려운 통합 작업은 혼합된 결과를 보였습니다. 플러그인 수정 버전들은 향상점과 퇴보를 모두 보여주었습니다. 결과는 특히 모양(shape), 재질(materials), 애니메이션(animation) 및 내보낸 파일(exported files)을 중심으로 직접 검토하십시오.
위의 다섯 쌍은 Codex에서 실행되었습니다. 게시된 갤러리는 이제 Claude Code의 Sonnet 5.5 및 Opus 5.5를 사용한 나중 장면 비교를 포함하여 총 31쌍을 유지하고 있으며, 여기에는 Codex 모델들도 포함됩니다. 장면 보고서는 그들의 제어(controls), 점수(scores), 시각적 투표(visual votes) 및 누락된 검토 기록을 보관합니다. 그러한 장면 결과들은 혼합되어 있습니다. 위에 선택된 리딩룸 이미지는 일반적인 시각적 우위를 확립하지 못합니다. 각 쌍은 조건당 하나의 생성물을 가지고 있으므로, 갤러리는 일반적인 성공률이라기보다는 검사할 증거입니다.
이전의 Claude Code 랜턴 샘플들은 기준선(baseline)이 없었으며 여전히 이러한 쌍으로 된 장면 비교와 분리되어 있습니다. 각 결과를 테스트된 호스트, 모델, 작업 및 플러그인 수정 버전과 연결하여 유지하십시오.
버그를 발견했습니까? 사용 중인 Blender 버전, 요청한 내용, 그리고 발생한 내용을 포함하여 이슈를 여십시오. 렌더 또는 오류 로그가 도움이 됩니다.
플러그인을 사용하여 무언가를 만들었습니까? 프롬프트, 에이전트/모델, Blender 버전 및 렌더와 함께 예시를 공유하십시오. 문서에 소개되기를 원한다면 그렇게 말하고 가능하다면 빌드 스크립트를 포함하십시오. 출판할 권한이 있는 파일만 공유하십시오.
코드 변경 사항은 개발 가이드(development guide)와 저장소 지침을 참조하십시오. 생성된 모델과 벤치마크 출력물은 커밋에서 제외하십시오. 익숙하지 않은 Blender 스크립트를 실행하기 전에 검토하십시오. 보안 참고 사항(security notes)을 참조하십시오.
MIT. Poly Haven의 자산은 CC0 라이선스입니다.
이 프로젝트는 독립적으로 진행되며, Blender Foundation이나 Poly Haven과 관련되거나 보증되지 않습니다. 제3자 고지 사항을 참고하십시오.