text-to-cad는 말로 설명한 물건을 컴퓨터 속 3D 설계 모형으로 만드는 일을 AI 코딩 도우미에게 맡길 수 있게 해 주는 오픈소스 도구입니다. 예를 들어 “구멍 두 개가 있는 작은 받침대를 만들어 줘”라고 요청하고 나온 모양을 돌려 보며 크기를 고칠 수 있습니다. 다만 문장만 입력하면 실제 물건이 즉시 완성되는 웹사이트나 3D 프린터는 아닙니다.
한눈에 보기: 사람은 만들 물건을 설명하고 AI 에이전트는 설계용 코드를 작성합니다. text-to-cad가 그 작업에 필요한 도구와 화면을 연결해 3D 모형을 만들고 보여 줍니다. 마지막 크기와 모양은 사람이 확인해야 합니다.
3D 설계를 말로 시작하면 무엇이 편할까요?
책상용 케이블 정리 부품을 구상할 때 처음부터 CAD 화면에서 선과 구멍을 정확히 그리기는 어렵습니다. 설계자에게 원하는 치수와 모양을 설명하고 초안을 받아 검토하듯, text-to-cad는 문장으로 요구사항을 전해 3D 설계 초안을 만드는 데 도움이 됩니다.
치수를 바꿔 가며 모양을 비교하려는 사람에게 이런 출발점이 유용합니다. 다만 설계자의 첫 도면을 그대로 제작에 쓰지 않듯, AI가 만든 모형도 사람이 크기·두께·구멍 위치를 확인해야 합니다. 실제 제작 가능성은 재료와 출력 방식까지 따져 별도로 판단해야 합니다.
말로 그리는 3D 설계가 무엇일까요?
CAD 화면에서 선과 구멍을 직접 배치하는 대신, 원하는 형상과 치수를 문장으로 설명하고 결과 모형을 보며 고치는 방식입니다. text-to-cad는 AI 코딩 에이전트가 작성한 설계 코드를 CAD 도구에 연결합니다. 사람의 설명만으로 모든 설계 조건을 독립적으로 판단하는 서비스는 아닙니다.
여기서 CAD는 컴퓨터로 물건의 모양과 치수를 정하는 설계를 뜻합니다. 3D 그림은 입체로 보이기만 할 수도 있지만, CAD 모형에는 길이·두께·구멍 크기처럼 실제로 확인하고 바꿀 수 있는 정보가 담깁니다. AI 에이전트는 대답만 하는 채팅창이 아니라, 허용된 범위에서 파일을 만들고 설계 코드를 실행하는 도우미입니다.
이 프로젝트는 GitHub의 earthtojake 계정이 공개했습니다. 저장소에는 MIT 라이선스가 표시되어 있으며 제품 소개와 설치 방법은 공식 사이트에서도 확인할 수 있습니다.
문장이 어떻게 3D 모형이 되나요?
작동 방식을 살펴볼 가상의 요청을 하나 들어 보겠습니다. “가로 6cm, 세로 4cm인 판에 작은 구멍 두 개를 뚫어 줘.” 사람이 치수와 모양을 알려 주면 다음과 같은 순서로 작업할 수 있습니다. 이 예시는 기능 설명용이며, 이 글에서 실제로 만든 결과물은 아닙니다.
- 사람이 설명합니다. 필요한 모양과 크기, 구멍 위치를 말합니다. 빠진 정보가 있으면 더 구체적으로 정합니다.
- AI 에이전트가 설계 코드를 씁니다. 컴퓨터가 이해할 수 있도록 판과 구멍의 크기·위치를 적습니다.
- CAD 도구가 모형을 만듭니다. 코드를 실행해 입체 모형을 만들고 화면에 보여 줍니다.
- 사람이 확인하고 고칩니다. 모형을 돌려 보고 치수를 재며 원하는 모양과 다르면 다시 요청합니다.
조금 더 정확히 말하면, 공식 문서는 에이전트가 build123d를 사용하는 Python 설계 코드를 작성한다고 설명합니다. CAD 실행 환경이 그 코드를 실행해 작업용 모형을 만들고 CAD 뷰어가 결과를 보여 줍니다. 이전 버전의 이름은 cadgen이었으며 현재 공식 문서는 cad 계열 이름을 사용합니다. 필요할 때 STEP·STL·3MF·GLB 같은 파일로 내보낼 수 있습니다. 처음에는 파일 형식마다 모형을 저장하고 다른 프로그램으로 옮길 때 쓰임이 다르다는 점만 알아두면 됩니다.
어떤 물건을 만드는 데 쓸 수 있나요?
공식 자료는 부품의 모양을 설계하고 고치기, 크기를 재기, 3D 파일 내보내기, 제작 전 점검과 치수가 적힌 도면 만들기 등을 소개합니다. 예를 들어 책상 위 작은 물건을 고정할 받침대를 생각해 볼 수 있습니다. 어디에 구멍이 있어야 하는지 말하고 나온 모형의 두께를 확인해 수정하는 식입니다. 이 받침대는 설명을 위한 가상 사례이며 완성도나 제작 가능성을 직접 시험한 사례는 아닙니다.
만든 파일의 용도도 다릅니다. STEP은 다른 설계 프로그램에서 다루기 좋고 STL·3MF는 3D 프린팅 준비에 자주 쓰입니다. GLB는 입체 모형을 화면에서 보여 주는 데 유용합니다. 도구가 여러 형식을 지원한다는 사실과, 모든 모형이 어느 기계에서나 곧바로 잘 만들어진다는 주장은 다릅니다.
그럼 3D 프린터가 바로 움직이나요?
아니요. 화면에 보이는 3D 모형은 실제 물건을 만들기 위한 설계 자료입니다. 3D 프린터로 출력하려면 두께가 충분한지, 크기가 맞는지, 프린터에서 어떤 재료와 설정을 쓸지 더 확인해야 합니다. text-to-cad에는 제작 가능성을 살피는 도구도 있지만 점검 결과를 사람이 읽고 판단하는 과정까지 없어지는 것은 아닙니다.
도면을 완성했다고 실제 부품이 만들어지는 것은 아닙니다. 설계한 모형을 저장하는 단계와 재료를 골라 인쇄하거나 가공하는 단계는 구분해야 합니다.
시작하려면 무엇이 필요한가요?
text-to-cad는 AI 코딩 앱에 설치하는 플러그인입니다. 공식 안내에는 Codex·Claude Code·Cursor 등 지원 앱별 방법이 나옵니다. 평범한 채팅창에 이름을 말하기만 해서는 내 컴퓨터에 설치되지 않습니다. 처음 실행할 때 CAD 실행 환경을 내려받으므로 인터넷 연결과 설치 시간이 필요합니다.
- 지원하는 AI 코딩 앱을 준비합니다. 앱이 플러그인을 설치하고 파일·명령을 다룰 수 있어야 합니다.
- 공식 설치 안내에서 방법을 고릅니다. 공식 사이트의 운영체제별 빠른 설치 명령은 컴퓨터에 있는 지원 에이전트 앱들을 함께 설정합니다. 한 앱에만 설치하려면 공식 저장소의 앱별 수동 설치 안내를 이용하세요.
- 앱을 다시 시작하고 작은 모형부터 시험합니다. 처음에는 단순한 판이나 상자처럼 모양을 설명하기 쉬운 물건을 요청하고 표시된 크기를 확인합니다.
버튼은 설치 파일을 직접 실행하지 않고 공식 사이트로 이동합니다. 앱별 수동 설치 안내도 별도로 볼 수 있습니다. GitHub 소스 코드 ZIP은 바로 실행하는 일반 설치 파일이 아닙니다.
직접 명령을 실행하기 어렵다면 파일과 명령을 다룰 수 있는 에이전트에게 공식 안내를 읽고 설치하도록 요청할 수도 있습니다. 아래 문장은 실제로 컴퓨터의 파일·터미널을 다룰 수 있는 AI 코딩 앱에서 사용하는 예시입니다. 일반 채팅창만으로는 설치되지 않습니다.
AI 코딩 에이전트 요청 예시: “공식 저장소 https://github.com/earthtojake/text-to-cad 의 설치 안내를 읽고, 지금 쓰는 AI 코딩 앱에 맞는 최신 공개 버전을 설치해 줘. 실행할 명령과 필요한 권한을 먼저 보여 줘. 사용 통계 전송은 꺼 주고, 설치 후 작은 3D 판을 만들어 크기와 단위를 함께 확인해 줘.”
공식 README에 따르면 기본 설정은 익명 사용 통계와 오류 보고를 전송하며 파일·경로·프롬프트는 포함하지 않는다고 설명합니다. 전송을 원하지 않으면 설치를 돕는 에이전트에게 telemetry 끄기를 요청하거나 cad telemetry off 명령을 사용할 수 있습니다. 설치 뒤 첫 실행에는 CAD 실행 환경을 내려받을 수 있습니다.
사용 전에 알아둘 점은 무엇인가요?
- 결과는 꼭 살펴보세요. AI가 적은 치수나 구멍 위치가 요청과 다를 수 있습니다. 중요한 부품은 실제 제작 전에 크기와 안전성을 사람이 확인해야 합니다.
- 개인정보 설정을 확인하세요. 공식 개인정보 안내는 모형과 파일이 로컬에서 처리된다고 설명하지만, 기본 설정에서는 사용 통계와 오류 보고를 보낼 수 있다고 밝힙니다. 이를 끄는 방법도 안내합니다. 함께 쓰는 AI 코딩 앱의 개인정보 처리 방식은 별도로 확인해야 합니다.
- 이용 대상: 프로젝트의 개인정보 안내는 13세 미만을 대상으로 하지 않는다고 밝힙니다. 계정이나 연결 서비스를 이용할 때 각 서비스의 조건도 확인하세요.
프로젝트 코드는 MIT 라이선스로 공개되어 있습니다. 다만 다른 AI 코딩 앱이나 실제 3D 프린팅·외부 제작 서비스의 이용 조건은 이 프로젝트와 별개로 확인해야 합니다.
누구에게 어울릴까요?
text-to-cad는 “내가 생각한 작은 물건의 크기와 모양을 컴퓨터에서 먼저 살펴보고 싶다”는 사람에게 흥미로운 도구입니다. 특히 AI 코딩 앱을 이미 쓰는 사람에게 연결하기 쉽습니다. 반면 설치 없이 브라우저에서 그림 한 장만 만들고 싶거나, 설명 한 줄로 정확한 인쇄물을 바로 얻고 싶다면 기대와 다를 수 있습니다.
먼저 공식 저장소의 기능과 설치 조건을 확인하고 작은 가상 예시로 모형을 만들어 크기·구멍·두께를 살펴보세요. 이 글은 공식 자료를 바탕으로 작성했으며 도구 이름과 설치 안내는 2026년 11월 10일 다시 확인했습니다. 프로그램을 직접 설치해 정확도나 출력 품질을 시험한 후기는 아닙니다.
라이선스 및 상업적 이용 안내
text-to-cad의 프로젝트 코드는 MIT 라이선스입니다. 조건을 지키면 회사의 설계 초안 작업에 쓰거나 코드를 수정할 수 있으며, 소프트웨어를 재배포할 때에는 원래 저작권 표시와 라이선스 문구를 포함해야 합니다.
만든 3D 파일이나 실제 출력물의 권리가 이 코드 라이선스 때문에 자동으로 정해지는 것은 아닙니다. 입력한 도면·제품 디자인에 타인의 권리가 있는지, 연결한 AI 코딩 앱·외부 제작 서비스가 어떤 조건을 두는지 따로 확인하세요. 판매용 부품이라면 사용 권리와 함께 치수·강도·안전성도 실제 용도에 맞게 검토해야 합니다. 공식 라이선스 확인일: 2026년 10월 27일.
본 게시글은 AI의 도움을 받아 작성되었으며 공식 자료를 참고하여 내용을 구성했습니다. 대표 이미지는 AI로 만든 개념 일러스트이고 본문 도식은 설명을 위해 별도로 제작했습니다.
