CAD 프로그램의 Python 에서 Rust 로의 전환 준비와 무감독 개발 체계 구축

1. v1.0.0.5 후속 작업

1.1 AI 패널 로그인 화면

AI 패널은 오른쪽 사이드 패널에서 Claude 와 Gemini 에 문장으로 작도를 지시하는 기능이다. 1편 게시 시점에는 패널을 열면 바로 대화 화면이 나타났다.

사용자는 로그인을 먼저 하는 순서가 맞다고 지적하였다. 이에 첫 화면을 Claude 와 Gemini 의 로그인 카드로 바꾸고, 로그인한 AI 만 대화 목록에 넣었다.

어느 AI 에도 로그인하지 않으면 「대화 시작」과 「보내기」가 동작하지 않는다. Claude 가 로그인 오류를 돌려주면 패널은 로그인 화면으로 돌아간다. 특성 팔레트와 AI 패널은 오른쪽에서 탭으로 전환되도록 묶었다.

1.2 Claude 로그인 창

Claude 로그인은 사용자 PC 에 설치된 Claude 공식 프로그램(Claude Code)이 수행한다. 처음에는 공식 프로그램의 로그인 명령을 명령 창으로 띄웠고, 사용자는 일반 사용자가 명령 창을 어려워한다고 지적하였다.

이에 공식 프로그램을 창 없이 실행하고 진행 상황을 iCAD 대화상자로 보이게 하였다. 그림 3은 이 로그인 창을 나타낸다.

창은 로그인 사이트 링크 단추와 주소 복사 단추, 브라우저가 인증 코드를 보여 주는 경우의 코드 입력 칸, 취소 단추를 갖는다. 2초마다 로그인 상태를 확인하고, 승인이 끝나면 창이 저절로 닫힌다.

iCAD 는 비밀번호와 토큰을 받지 않는다. 코드 입력 칸의 값은 저장하지 않고 공식 프로그램의 입력으로만 넘긴다. 클라우드 시험에서 주소 읽기, 틀린 코드 알림, 승인 후 자동 닫힘 세 항목을 확인하였다.

1.3 가상 치수

가상 치수는 본편 핵심기능 2(Inferred Dimensions)이다. 방금 그린 객체와 선택한 객체 옆에 흐린 점선 치수를 표시한다.

치수 값을 두 번 누르면 입력 상자가 열린다. 새 값을 넣으면 객체 크기가 그 값으로 바뀌고, 그 위치에 객체와 연결된 실제 치수가 생긴다. 그림 4는 가로 80 인 직사각형을 100 으로 바꾸는 과정을 나타낸다.

표 1은 객체 종류별로 크기를 바꿀 때 고정하는 기준을 나타낸다. 값을 그대로 두고 Enter 를 누르면 크기는 유지되고 치수만 생긴다.

입력 상자는 12.5, .5, 1.25E+01 같은 실수와 100/3, 10.5+0.25 같은 사칙 연산을 받는다. 실수 입력 시험 18건과 동작 시험 16건을 통과하였다.

객체 5만 개 도면에서 가상 치수를 그리는 시간은 0.23 ms 로 측정되었다. 화면 응답 속도에는 영향이 없는 것으로 판단된다.

1.4 AI 패널 단추와 단축키

AI 패널은 보기 탭의 작은 항목으로만 열 수 있었다. 이에 홈 탭과 디자인 탭 끝에 큰 [AI 패널] 단추를 추가하고, 단축키 Ctrl+5 를 지정하였다.

Ctrl+5 는 AutoCAD 가 팔레트 열기에 쓰는 Ctrl+1~9 가운데 비어 있는 번호이다. 명령 AIPANEL 과 별칭 AI, AIP 로도 열고 닫는다. 진입 시험 9건을 통과하였다.

1.5 본편 핵심기능 수정

핵심기능 6의 이름을 「완전 무료」에서 「유지비용 감소(Lower Running Cost)」로 바꾸었다. 프로그램 사용권은 0원이지만 AI 기능을 쓰면 사용자의 AI 구독 비용이 생기기 때문이다.

2. Rust 전환 결정

2.1 Python 판의 한계

1편의 반응속도 개선 뒤에도 객체 5만 개 도면에서 느린 동작이 남았다. 첫 화면 표시 1.6 s, 되돌리기 0.48 s, 자르기 미리보기 182 ms, DXF 읽기 6.3 s 이다.

또한 설치 파일은 Python 실행 환경과 Qt 를 함께 묶어 86 MB 가 되었다. PC 시험에서 나온 결함 일부는 실행 중에만 드러나는 형식 오류였다.

2.2 언어 비교

표 2는 iCAD 에 적용할 때의 Python 과 Rust 를 비교한 결과이다.

2.3 3D 형상 커널 연결

3D 형상 계산은 C++ 라이브러리 OCCT 를 Rust 에서 부르는 방식으로 정하였다. iCAD 가 쓰는 OCCT 기능은 약 25개 영역이므로, 필요한 기능만 모은 얇은 C++ 중간층을 만든다.

OCCT 의 C++ 예외는 중간층에서 모두 받아 오류 값으로 바꾼다. 더 큰 비용은 3D 화면 표시와 면·모서리 선택이다. Python 판은 OCCT 의 화면 기능을 그대로 썼으나 Rust 판은 이 부분을 직접 구현해야 한다.

2.4 결정

사용자는 개발 편의보다 사용자 편의가 중요하다고 판단하여 Rust 전환을 결정하였다(2026.10.31.). 판 번호는 v2.0.0.0 이며, Python 판은 v1.0.0.5 에서 개발을 멈추었다.

3. 이전 전략

3.1 계층 구조

Rust 판은 기능을 8개 묶음(crate)으로 나누고, 아래층에만 의존하도록 하였다. 의존 방향은 빌드 도구(xtask)가 자동으로 검사한다. 표 3은 계층과 원본 위치를 나타낸다.

도면 자료의 JSON 형식은 Python 판의 drawing.json 과 같게 하였다. 이에 따라 기존 .gcad 파일을 Rust 판에서 그대로 연다.

3.2 정답 프로그램 비교

Python 판 원본 사본을 저장소에 읽기 전용으로 두고, 정답 추출 스크립트가 같은 입력에 대한 Python 판 결과를 파일로 만든다. Rust 판은 같은 입력의 결과를 이 파일과 비교한다.

허용 오차는 좌표와 길이 1e-9, 각도 1e-7 이다. 일치 건수는 기록 파일(FLOOR)에 남기며, 이 값은 늘릴 수만 있고 낮출 수 없다. 첫 정답 자료는 기하 함수 3,200건이다.

3.3 작업 목록과 지시서

이전 작업은 M0 준비부터 M7 화면 툴킷 결정까지 8단계, 25개 작업으로 정리하였다. 작업마다 Python 원본 위치, 옮길 묶음, 선행 작업, 완료 판정 명령을 적었다.

저장소 맨 위의 지시서(AGENTS.md)는 읽는 순서, 다음 작업 고르는 법, 완료 조건, 막혔을 때의 처리, 금지 사항을 담는다. 새 작업 세션은 대화 기록 없이 이 지시서와 작업 한 줄만 읽고 시작한다.

3.4 무감독 실행기

사용자 PC 의 Windows 작업 스케줄러가 매일 01:10 에 실행기를 시작한다. 실행기는 선행 작업이 끝난 첫 작업을 골라 Claude Code 세션 하나에 맡긴다.

세션이 끝나면 비용을 장부에 적고 git 에 커밋한다. 같은 작업이 2회 실패하면 사람 확인 필요로 표시하고 다음 작업으로 넘어간다. 작업 폴더에 STOP 파일이 있으면 멈춘다.

3.5 API 크레딧 사용 방식

사용자는 Claude API 크레딧 199.60 달러를 이 이전에 먼저 쓰고, 소진 뒤에는 구독 계정으로 이어 가기로 하였다. 표 4는 작업 종류별 모델 배정을 나타낸다.

비용 상한은 세 겹으로 두었다. 작업마다 세션 비용 상한을 걸고, 실행기는 하루 30 달러와 누적 195 달러에서 멈춘다. Console 의 작업 공간에는 월 200 달러 한도를 지정하였다.

누적 195 달러에 닿으면 같은 실행기가 구독 계정 로그인으로 바꾸어 하루 6개 작업을 이어 간다. 장부의 mode 열에 api 와 sub 를 나누어 기록한다.

3.6 감독 단계

사용자는 Sonnet 이 작성한 코드의 품질을 우려하였다. 이에 감독을 세 단계로 구성하였다.

첫째, 작업마다 시험, 컴파일러 경고, 계층 검사, 정답 비교를 모두 통과해야 완료로 기록된다. 둘째, 성공한 작업 5개마다 Fable 5.1 세션이 변경분을 Python 원본과 대조하여 검토한다.

검토 세션은 작은 문제를 직접 고치고, 큰 문제는 수정 작업으로 등록하거나 해당 작업을 미완료로 되돌린다. 셋째, 매주 수요일 09:00 에 장부와 검토 기록, 임의의 커밋 2개를 사람이 보는 세션에서 점검한다.

4. PC 개발 환경과 첫 무감독 작업

4.1 개발 환경 준비

표 5는 사용자 PC 에 개발 환경을 준비하며 발생한 문제와 조치를 나타낸다.

4.2 첫 무감독 작업 M1-01

첫 작업은 Rust 기하 함수 14개를 Python 판 정답 3,200건과 비교하는 시험의 작성이다. 표 6은 실행 기록을 나타낸다.

Rust 기하 함수는 수정 없이 정답과 모두 일치하였다. 작업당 비용은 계획 때 추정한 1.5~2.5 달러의 약 1/10 이었다. 이에 하룻밤 작업 수를 12개에서 30개로 늘렸다.

5. 결과 및 남은 일

본 편에서는 v1.0.0.5 의 AI 패널과 가상 치수를 마무리하고, iCAD 를 Rust 로 옮기기 위한 계층 구조, 정답 비교, 작업 목록, 무감독 실행기, 비용 상한, 감독 단계를 준비하였다.

Rust 판은 아직 실행 파일이 없다. 따라서 Rust 판의 첫 설치 파일을 만들 때까지 iCAD 다운로드는 일시 중지한다. Python 판 v1.0.0.5 설치 파일도 배포하지 않는다.

다음 작업은 M1-02(호 그리기 11가지)부터 M2 도면 자료 구조까지이다. 화면 툴킷은 한글 입력 시험판을 PC 에서 확인한 뒤 결정한다. 가상 치수와 Claude 로그인 창의 PC 실측도 남아 있다.

참고문헌

1. Anthropic, “Pricing,” Claude Platform Docs, 2026. https://platform.claude.com/docs/en/about-claude/pricing
2. Anthropic, “Claude Fable 5.1,” Claude Platform Docs, 2026. https://platform.claude.com/docs/en/models/fable-5-1/overview
3. Anthropic, “Legal and compliance,” Claude Code Docs, 2026. https://code.claude.com/docs/en/legal-and-compliance