클로드 코드 한 줄로 3D 물리 시뮬레이션을 생성하는 Machine Skill

앤트로픽의 개발용 에이전트 클로드 코드(Claude Code) 환경에서 자연어 설명 한 줄로 3D 인터랙티브 기계 시뮬레이션을 단일 HTML 파일로 빌드하는 오픈소스 스킬 Machine Skill(AirsupHQ/machine-skill)이 공개되어 개발자와 엔지니어들의 주목을 받고 있습니다.

이미지 출처: https://github.com/AirsupHQ/machine-skill

MIT 라이선스로 배포되는 이 도구는 별도의 복잡한 CAD 소프트웨어나 빌드 파이프라인 없이, Three.js 0.170 기반의 경량 단일 HTML 산출물로 실제 기계 제원과 간이 물리 계산이 적용된 3D 모델을 생성합니다. 2026년 10월 첫 공개된 이후 정밀 기계 부품 조립과 시각화 검증 도구로서 오픈소스 커뮤니티의 관심을 모았습니다.

단일 HTML 파일과 Three.js 기반 무빌드 3D 시뮬레이션

Machine Skill의 가장 두드러진 기술적 특징은 웹 표준 기술만으로 구동되는 독립형 아키텍처입니다.

클로드 코드 세션에서 기계의 형태와 동작 방식을 지정하면 에이전트가 실제 물리 제원과 부품 목록을 구성한 뒤 Three.js 기반의 자체 완결형 HTML 파일을 생성합니다. 별도의 번들러나 웹팩 등 빌드 단계가 일절 필요하지 않으며, 로컬 디스크에서 브라우저로 직접 열어 즉시 인터랙션을 수행할 수 있습니다.

• 인터랙티브 뷰 모드: 전체 부품을 분해해 표시하는 폭발도(Explode), 금속 단면을 채워 보여주는 컷어웨이(Cutaway), 내부 부품 투과를 확인하는 X-ray, 슬로우 모션 및 라이브 라벨 기능을 제공합니다.
• 물리 파손 계산('break it'): 터보팬의 팬 블레이드가 이탈할 때 케이스가 견뎌야 하는 불균형 하중을 연산하거나, 재생 냉각이 차단된 로켓 노즐의 구리 스로트가 녹아내리는 등의 파손 한계를 시뮬레이션 버튼으로 재현합니다.
• 결과물 공유를 위한 녹화 파이프라인: 내장된 scripts/record.mjs 스크립트를 통해 헤드리스 브라우저 상에서 결정론적 클록(?film=1)으로 프레임을 렌더링하고, ffmpeg를 이용해 숏폼 및 소셜 공유용 MP4 비디오로 내보낼 수 있습니다.

브레이턴 사이클 계산과 실제 적용 사례

공식 리포지토리에서 제공하는 대표 데모인 광동체 여객기용 터보팬 엔진 예시는 3,597개의 부품(대부분 회전 블레이드)으로 구성됩니다.

단순한 3D 메시 배치를 넘어, 내부 브레이턴 사이클(Brayton cycle) 간이 해석기를 내장해 스로틀 조작에 따라 이륙 시 약 340 kN의 추력(이 중 83%는 바이패스 에어에서 발생)과 각 터빈 스테이지의 온도 상승을 실시간으로 수치 연산합니다. 이 외에도 메탈록스 로켓 엔진, 정유소용 API 610 프로세스 펌프(캐비테이션 재현), API 617 배럴 압축기(서지 현상 해석) 등의 예제가 포함되어 있습니다.

다만 제공되는 물리 엔진은 전산유체역학(CFD)이나 유한요소해석(FEA) 같은 상용 수준의 정밀 수치해석기가 아니며, 기계공학적 수식을 단순화한 간이 물리 모델(small solver)이라는 점을 유의해야 합니다.

설치 요구사항 및 사용 방법

Machine Skill은 Node 22.20 이상 환경에서 Agent Skills 표준 규격으로 동작하며, 클로드 코드에 전역 스킬로 등록해 사용할 수 있습니다.

# 1. 클로드 코드 전역 스킬 등록
npx skills add AirsupHQ/machine-skill -g -a claude-code

# 2. 브라우저 자동화 및 캡처를 위한 Playwright 설치
cd ~/.claude/skills/machine && npm i && npx playwright install chromium

설치 후 클로드 코드 세션에서 /machine 명령어를 입력하고 기계 명칭과 동작 요구사항을 입력하면 됩니다.

/machine a turbofan jet engine, the kind that pushes a widebody off the runway

명령을 실행하면 에이전트가 사양 조사와 부품 모델링을 거쳐 HTML 시뮬레이션 파일을 작성합니다. 생성된 시뮬레이션을 비디오 파일로 렌더링하려면 Node, Playwright 및 ffmpeg가 설치된 환경에서 레코딩 스크립트를 실행하면 됩니다.

출처

• GitHub 리포지토리: AirsupHQ/machine-skill
• 원문 포스트: @plusxbt X 업데이트