OpenSCAD 웹 — 설치 없는 오픈스캐드 온라인 에디터
OpenSCAD(오픈스캐드)는 마우스로 도형을 끄는 대신 코드로 3D 부품을 설계하는 CAD 프로그램입니다. 치수를 변수로 두고 숫자만 바꿔 여러 크기를 만들 수 있어서 3D 프린팅용 브래킷, 케이스, 거치대 같은 기능 부품에 특히 잘 맞습니다. openscad-web는 이 OpenSCAD를 웹 브라우저에서 바로 쓰게 해 줍니다. 공식 openscad-playground 프로젝트가 WebAssembly로 빌드한 OpenSCAD 2025.03.25(Manifold 백엔드)를 그대로 사용하므로, 데스크톱 OpenSCAD에서 쓰던 코드가 그대로 동작합니다.
무엇을 할 수 있나요
- 코드 편집기: VS Code와 같은 Monaco 편집기에 OpenSCAD 자동 완성, 오류 표시, 3D 축 색과 맞춘
[x, y, z]벡터 색이 들어 있습니다. - 3D 미리보기: 코드를 고치면 브라우저 안의 Web Worker에서 다시 컴파일해 three.js 3D 뷰에 보여 줍니다. 회전·확대하고 표준 시점 버튼으로 방향을 확인합니다.
- Customizer: 파일 위쪽 변수에 OpenSCAD Customizer 주석을 달면 슬라이더와 입력칸이 생깁니다.
- 라이브러리: BOSL2, MCAD, NopSCADlib가 포함되어 있습니다.
- 내보내기: STL(바이너리), 3MF, OFF, .scad 소스. 설계 단위에 맞춰 밀리미터로 변환합니다.
- Bambu Studio 바로 열기: 3MF를 만들어 Bambu Studio로 넘겨 줍니다.
- 설계 관리: 자동 저장, 이름 바꾸기, 복제(포크), 삭제, .scad 파일 가져오기, 설계마다 참고 이미지 최대 4장.
- AI 연결: 원격 MCP 서버라서 Claude 앱, ChatGPT, Claude Code가 내 계정에서 설계를 만들고 고칠 수 있습니다.
튜토리얼: 5분 만에 첫 모델 만들기
1. 로그인
위의 “에디터 열기”를 누르고 Google 계정으로 로그인합니다. 설계가 하나도 없으면 새 설계가 자동으로 만들어집니다.
2. 코드 붙여넣기
아래 코드는 연필꽂이입니다. 편집기 내용을 지우고 붙여넣으세요. 변수 세 개와 difference() 하나로 이루어진 짧은 예제입니다.
// Pencil cup — 연필꽂이
diameter = 70; // [40:120]
height = 90; // [40:150]
wall = 2; // [1:0.5:5]
$fn = 96;
difference() {
cylinder(d = diameter, h = height);
translate([0, 0, wall]) cylinder(d = diameter - 2*wall, h = height);
}
3. 미리보기 확인
자동 미리보기가 켜져 있으면 붙여넣는 순간 3D 뷰에 원통이 나타납니다(설정에서 끌 수 있습니다). 아래 상태 표시줄에 크기, 부피, 삼각형 수가 나오고, 메시가 닫혀 있지 않으면 NOT MANIFOLD 경고가 뜹니다.
4. Customizer로 크기 바꾸기
변수 뒤의 // [40:120] 같은 주석 덕분에 3D 뷰 옆에 슬라이더가 생깁니다. 지름이나 높이를 끌어 보세요. 값은 설계와 함께 저장되고 내보낼 때도 적용됩니다.
5. 내보내기
Export… 메뉴에서 STL이나 3MF를 고르면 먼저 저장한 뒤 서버에서 같은 OpenSCAD 버전으로 컴파일해 파일을 내려받습니다. 파일 이름은 설계 이름을 따릅니다. 단위가 cm인 설계는 10배, m인 설계는 1000배 해서 밀리미터로 맞춥니다. 3D 뷰의 단위 배지를 누르면 설계 단위를 바꿀 수 있습니다.
Bambu Studio로 바로 보내기
Export… → Open in Bambu Studio를 누르면 새 탭에 작은 안내 페이지가 열립니다. “Open Bambu Studio” 버튼을 누르고 브라우저의 앱 열기 확인을 허용하면 Bambu Studio가 3MF를 가져옵니다. 이 링크는 무작위 토큰이 들어간 비공개 링크이고 15분 뒤에 만료됩니다. 앱이 열리지 않으면 같은 페이지의 3MF 다운로드 링크를 쓰면 됩니다. 자세한 설명은 영문 Bambu Studio 안내에 있습니다.
AI에게 설계 맡기기 (MCP)
Claude 앱에서는 설정 → 커넥터 → 사용자 지정 커넥터 추가에 https://openscad.bongkow.com/mcp 를 붙여넣고 연결합니다. 브라우저에서 Google로 로그인하고 “Allow”를 누르면 끝입니다. ChatGPT는 개발자 모드에서 OAuth 인증 커넥터로 만들고, Claude Code는 아래 명령을 씁니다.
claude mcp add --transport http openscad-web https://openscad.bongkow.com/mcp
연결된 AI는 코드를 컴파일해 크기·부피·매니폴드 여부와 렌더 이미지를 확인하면서 설계를 고칩니다. 저장할 때마다 열린 에디터 탭에 바로 반영되므로 진행 상황을 눈으로 볼 수 있고, 에디터의 Agent 패널에서 연결을 언제든 끊을 수 있습니다. 자세한 내용은 영문 MCP 안내를 보세요.
알아 둘 점
- 에디터를 쓰려면 Google 로그인이 필요합니다. 설계는 내 계정에만 저장되고 공개되지 않습니다.
- 기존 STL 파일을 열거나 수정하는 기능은 없습니다. 코드로 모델을 만들고 STL로 내보내는 도구입니다.
- 에디터 안의 Docs 버튼(F1)에 한국어 사용 설명서가 있습니다.
자주 묻는 질문
OpenSCAD를 설치해야 하나요?
아니요. OpenSCAD 2025.03.25 엔진이 WebAssembly로 브라우저 안에서 실행됩니다. JavaScript와 WebAssembly를 지원하는 브라우저와 Google 계정만 있으면 됩니다.
설계 파일은 어디에 저장되나요?
Google로 로그인한 내 계정에 서버 저장됩니다. 입력을 멈추면 약 1초 뒤 자동 저장되고, 다른 컴퓨터에서 로그인해도 같은 설계가 열립니다.
STL이나 3MF로 내보낼 수 있나요?
네. Export 메뉴에서 STL, 3MF, OFF 또는 .scad 소스를 내려받습니다. 메시는 설계 단위(mm·cm·m)에 맞춰 밀리미터로 변환됩니다.
Bambu Studio로 바로 열 수 있나요?
네. Export → Open in Bambu Studio를 누르면 15분 동안 유효한 비공개 3MF 링크와 Bambu Studio 실행 버튼이 있는 페이지가 열립니다.
기존 STL 파일을 열어 볼 수 있나요?
아니요. openscad-web는 OpenSCAD 코드로 모델을 만드는 도구이며, 이미 있는 STL 파일을 여는 기능은 없습니다. .scad 파일은 가져올 수 있습니다.
AI가 대신 설계할 수 있나요?
네. Claude 앱, ChatGPT, Claude Code에 https://openscad.bongkow.com/mcp 를 MCP 커넥터로 추가하고 Google 로그인 후 허용하면, AI가 내 계정에서 코드를 쓰고 브라우저에 실시간으로 반영됩니다.