CadQuery란? 파이썬으로 시작하는 오픈소스 3D CAD 모델링

최근 CadQuery가 다시 주목받는 이유는 간단합니다. 3D CAD를 마우스 대신 코드로 다루려는 흐름이 커지고 있고, 그 중심에 "파이썬으로 만드는 파라메트릭 모델링" 도구인 CadQuery가 있기 때문입니다¹.

한마디로 CadQuery는 오픈소스 Python 라이브러리로, 3D CAD 모델을 코드로 만들 수 있게 해줍니다. 복잡한 형상을 자동화하고, 치수를 바꾸며, 반복 설계를 빠르게 처리하고 싶은 사람에게 특히 잘 맞습니다.

CadQuery의 핵심: 클릭보다 코드가 강한 이유

일반적인 CAD 프로그램은 화면에서 선을 그리고 돌출하는 방식에 익숙합니다. 반면 CadQuery는 "모델을 어떻게 만들지"를 파이썬 스크립트로 적습니다. 처음엔 낯설지만, 한 번 익숙해지면 장점이 확실합니다.

가장 큰 매력은 파라메트릭 설계입니다. 예를 들어 가로, 세로, 높이 값만 바꿔도 같은 구조의 다른 부품을 순식간에 만들 수 있습니다. 같은 설계를 여러 크기로 반복해야 하거나, 제품군을 한꺼번에 관리해야 할 때 엄청난 힘을 발휘하죠¹².

또 CadQuery는 GUI 없이도 잘 작동하도록 설계된 점이 인상적입니다. 그래서 서버 자동화, 과학 계산, 엔지니어링 스크립트와 잘 어울립니다². "CAD를 사람 손이 아니라 코드 파이프라인에 넣고 싶다"는 팀에게 특히 유리합니다.

CadQuery 설치와 작업 환경, 생각보다 가볍다

시작 자체는 어렵지 않습니다. 기본적인 설치는 pip install cadquery처럼 비교적 단순한 편입니다³.

시각화가 필요할 때도 선택지가 있습니다. VS Code에서는 OCP CAD Viewer 확장을 이용해 CadQuery 객체를 바로 볼 수 있고, 빠른 시작 기능으로 관련 라이브러리를 한 번에 준비할 수도 있습니다⁴. 즉, "코드 작성은 VS Code에서, 형상 확인도 VS Code에서"라는 흐름이 가능합니다.

이 조합은 초보자에게도 꽤 친절합니다. 예전에는 코드 기반 CAD가 "보이지 않아서 답답한 도구"처럼 느껴졌다면, 이제는 코드를 실행하고 바로 형상을 확인하는 개발자 친화적 환경이 많이 좋아졌습니다.

CadQuery가 잘 맞는 분야: 자동화, 반복 설계, AI 연동

CadQuery의 진짜 매력은 단순 모델링보다 "자동화 가능한 CAD"에 있습니다. 예를 들어 브래킷, 하우징, 지그, 3D 프린팅용 부품처럼 규칙이 분명한 형상은 코드화하기 좋습니다. 구멍 위치나 두께를 변수로 두면, 설계 변경도 훨씬 덜 아프죠.

이런 구조 덕분에 AI와의 궁합도 좋습니다. 최근 연구에서는 자연어 설명을 바탕으로 CadQuery 코드를 생성한 뒤, 실행 오류와 실제 형상 치수를 반복 검증해 정확도를 높이는 방식까지 제안됐습니다⁵. 쉽게 말해 "말로 설명한 부품"을 "검증 가능한 CAD 코드"로 바꾸는 실험이 본격화되고 있다는 뜻입니다.

즉, CadQuery는 단순한 모델링 라이브러리를 넘어, 앞으로의 AI 설계 자동화 시대에 꽤 중요한 연결고리가 될 가능성이 큽니다.

CadQuery와 다른 오픈소스 CAD의 차이

비슷한 결의 도구를 떠올리면 FreeCAD나 OpenSCAD가 자주 비교 대상이 됩니다. FreeCAD는 범용 데스크톱 CAD에 가깝고, GUI와 파라메트릭 모델링을 함께 제공합니다⁶. 반면 CadQuery는 더 프로그래밍 친화적입니다. "설계를 코드 자산처럼 관리하겠다"는 관점이 훨씬 강합니다.

그래서 감각적으로 형태를 만지는 작업보다는, 치수 규칙이 중요하고 재현성이 필요한 작업에서 강합니다. 개발자, 메이커, 연구자, 자동화 엔지니어에게 특히 사랑받는 이유도 여기에 있습니다.

시사점

CadQuery는 "3D CAD를 파이썬으로 다룬다"는 점 하나만으로도 충분히 매력적입니다. 하지만 진짜 가치는 반복 가능한 설계, 자동 생성, 버전 관리, 그리고 AI 연동 가능성에 있습니다.

만약 CAD를 더 유연하게 다루고 싶다면, CadQuery는 꽤 좋은 출발점입니다. 처음엔 마우스 대신 코드를 써야 해서 어색하지만, 어느 순간 "이걸 왜 이제 알았지?"라는 생각이 들 가능성이 높습니다.

참고

¹CadQuery is an open-source Python library for building 3D CAD models

²CadQuery/cadquery - Bookmarks

³Open Source Python Library dla formatów plików 3D CAD

⁴GitHub - bernhard-42/vscode-ocp-cad-viewer: A viewer for OCP based Code-CAD (CadQuery, build123d) integrated into VS Code · GitHub

⁵CADSmith: Multi-Agent CAD Generation with Programmatic Geometric Validation

⁶GitHub - FreeCAD/FreeCAD: Official source code of FreeCAD, a free and opensource multiplatform 3D parametric modeler. · GitHub