치과의사의 프롬프트 한 번, Claude Code가 1시간 45분 만에 DentalAX를 완성한 비결
코드 한 줄 모르는 비개발자가 프롬프트 단 한 번을 입력한 뒤 자리를 비웠는데, 1시간 45분 만에 38,400줄 규모의 실무 웹 서비스가 완성될 수 있을까요?
이 아티클의 핵심 내용 요약과 글로벌 검색·AI 엔진을 위한 테이크어웨이입니다.
✦ KR 주제: Claude Code와 Opus 5.5를 활용한 실무 AX 구현
✦ KR 핵심 요약: 비개발자 치과의사가 Claude Code(Claude Opus 5.5, effort high)에 단일 프롬프트를 입력하여 사람 개입 없이 1시간 45분 만에 38,400줄 규모의 치과 원내 업무 시스템 DentalAX를 완성했습니다. 외부 MCP 없이 상시 사고(thinking) 메커니즘과 자율 테스트 검증 루프만으로 프로덕션 수준의 도메인 소프트웨어를 빌드할 수 있음을 입증했습니다.
🌐 Global Takeaway: A non-developer dentist successfully built DentalAX, a comprehensive 38,400-line clinical management web app, in 105 minutes using a single prompt in Claude Code powered by Claude Opus 5.5 with effort set to high. The project demonstrated zero human intervention, relying on continuous internal reasoning and automated end-to-end testing without external MCP plugins.
아래 그림은 DentalAX가 한 번의 프롬프트로 기획부터 배포 파일까지 완성된 자율 개발 단계와 기존 프롬프트 기반 코딩과의 차이를 보여줍니다.
- 함수 단위 질의응답
- 사람이 버그 수정 반복
- 도구·MCP 의존성 높음
- 세션 단절 시 맥락 손실
- 저장소 전체 자율 제어
- 스스로 에러 감지 후 수정
- 기본 내장 터미널만 활용
- 단일 세션 무인 완결
1. 1시간 45분 동안 인간의 개입이 완전히 사라진 현장
2026년 10월 16일, 소프트웨어 개발 생태계에 매우 인상적인 오픈소스 프로젝트가 공개되었습니다. 프로그래밍 지식이 전혀 없는 현직 치과의사가 오픈소스 AI CLI 도구인 Claude Code에 단 한 번의 프롬프트를 입력하여 원내 업무 자동화 웹 애플리케이션 'DentalAX'를 완전히 빌드해 낸 사례입니다. 개발 과정에서 작성자가 브라우저 콘솔을 열거나 코드를 직접 디버깅한 횟수는 0회였습니다. 외부 생태계의 복잡한 플러그인, 커스텀 스킬, 혹은 모델 콘텍스트 프로토콜(MCP)도 일절 사용되지 않았습니다.
단순한 프로토타입이나 단일 HTML 파일 수준이 아닙니다. 완성된 시스템은 데스크 업무 인수인계, 유효기간 기반 재고 선입선출 발주 시스템, 법정 의무 교육 관리, 직원 근무표 및 연차 승인, 공문서 A4 자동 조판, 그리고 멸균기 점검 기록부까지 포함하는 통합 관리 소프트웨어였습니다. 터미널 명령 한 번으로 구동된 Claude Opus 5.5 에이전트는 기획 분석부터 디렉터리 구성, 코드 작성, 자동 테스트 작성, 브라우저 E2E 검증, 설치용 배치 파일 생성까지 홀로 마쳤습니다.
1-1. 공개된 DentalAX 저장소 사양과 검증 지표
GitHub 저장소 GangJaeYu/DentalAX를 통해 공개된 실제 개발 산출물의 스펙은 현업 풀스택 개발자의 수작업 빌드와 비교해도 손색이 없는 완성도를 보입니다. 1시간 45분(105분)이라는 제한된 시간 동안 에이전트가 쏟아낸 결과물은 정량적 수치로 증명됩니다.
| 검증 항목 | 세부 수치 및 명세 | 비고 |
|---|---|---|
| 총 개발 소요 시간 | 약 1시간 45분 (105분) | 프롬프트 입력 후 완전 무인 실행 |
| 사람 개입 횟수 | 0회 | 디버깅 및 에러 수정 지시 없음 |
| 생성된 코드 라인 수 | 약 38,400줄 | 상세한 한국어 주석 포함 |
| 작성된 자동 단위 테스트 | 175개 | 전체 테스트 통과 완료 |
| 브라우저 E2E 시나리오 | 28단계 검증 | 실제 사용자 렌더링 확인 |
| 외부 플러그인 / MCP | 0개 사용 | CLI 기본 내장 도구만 활용 |
"아이디어를 평소 말투로 적은 뒤, AI에게 '더 정확하고 세련되게 다듬어 달라'고 요청해 규칙·개인정보 원칙·기능·보안·디자인·검증 기준을 구체화했습니다. 그 후 새 세션에 확장 프롬프트를 붙여 넣자 AI가 혼자 계획부터 브라우저 검증까지 마쳤습니다." — GangJaeYu/DentalAX 공식 저장소 개발 기록
2. Claude Opus 5.5의 아키텍처적 특성과 Effort 설정
어떻게 프롬프트 한 번으로 중간 질문이나 컨텍스트 붕괴 없이 3만 8천 줄이 넘는 코드가 완성될 수 있었을까요? 그 중심에는 2026년 9월 출시된 Anthropic의 플래그십 파운데이션 모델 Claude Opus 5.5와 새롭게 개편된 추론 제어 파라미터가 자리 잡고 있습니다. Claude Opus 5.5의 가장 핵심적인 아키텍처 변경점은 바로 '사고(Thinking) 모드의 상시 활성화'입니다. 이전 세대 모델들이 사용자의 지시에 따라 생각 프로세스를 켜거나 끄고, 생각에 할당할 토큰 수를 수동으로 제한했던 것과 달리 Opus 5.5는 모델 내부의 깊은 사고 루프를 강제로 끌 수 없도록 설계되었습니다.
대신 Anthropic은 개발자에게 effort라는 단일 파라미터만을 제공합니다. 이 파라미터는 low, medium, high, xhigh, max의 5단계로 구성되며, 모델이 문제를 해결하기 위해 내부적으로 탐색할 사고의 깊이와 도구 호출 빈도를 종합적으로 제어합니다. Claude Opus 5.5의 기본값은 medium으로 설정되어 이전 세대(Opus 5)의 high 수준에 필적하는 코딩 성능을 내지만, 이번 DentalAX 프로젝트에서는 사고 깊이를 high로 강제 지정했습니다.
2-1. effort: high가 에이전트 무인 작업에 미친 영향
공식 기술 문서에 따르면 effort: high 상태의 Claude Opus 5.5는 실행 전 가상 시뮬레이션을 훨씬 길게 수행합니다. 코드 파일을 무작정 생성하기 전에 파일 간의 종속성 트리를 설계하고, 발생 가능한 런타임 예외를 예측하여 아키텍처를 먼저 구조화합니다. 또한 문제가 발생했을 때 사용자에게 "에러가 발생했으니 어떻게 할까요?"라고 되묻는 대신, 자체 서브에이전트 루프 안에서 대안을 스스로 도출하여 실행합니다.
또한 토큰 생성 속도가 전작 대비 30% 이상 빨라졌으며 동일한 엔지니어링 태스크를 완수하는 데 필요한 총 토큰 소모량이 최적화되었습니다. API 단가 측면에서도 100만 토큰당 입력 $4, 출력 $20 수준으로 Fable 5.1(입력 $10, 출력 $50) 대비 기본 비용이 60%가량 낮아 대규모 무인 에이전트 작업을 수행할 때 발생하는 비용 장벽을 크게 허물었습니다. 이러한 연산 효율성이 105분이라는 짧은 시간 내에 대규모 코드베이스를 구축할 수 있었던 기술적 밑바탕이 되었습니다.
3. 2단계 프롬프트 확장 기법: 자연어 의도에서 엔지니어링 명세로
비개발자인 작성자가 취한 핵심 전략은 '2단계 프롬프트 확장 기법(Two-stage Prompt Amplification)'이었습니다. 비개발자가 처음부터 완벽한 소프트웨어 요구사항 정의서(SRS)나 데이터베이스 스키마를 작성하는 것은 불가능에 가깝습니다. 작성자는 현업에서 원장으로서 매일 느끼던 페인 포인트를 평소 말투 그대로 거칠게 나열했습니다. 이를 '원(Raw) 프롬프트'라 명명했습니다.
이후 작성자는 대화형 AI 인터페이스를 활용하여 해당 원 프롬프트를 에이전트가 완벽히 해석할 수 있는 엄밀한 '확장(Extended) 프롬프트'로 변환했습니다. 이 확장 과정에서 엔지니어링에 필수적인 6가지 기둥이 자동으로 수립되었습니다.
- 도메인 데이터 보안 원칙: 환자의 실명, 주민등록번호, 진료 매출 데이터 등 민감정보는 데이터베이스에 절대 저장하지 않고 철저히 배제한다는 규칙 수립
- 모듈별 기능 명세: 데스크 공지, 재고 선입선출, 공문서 자동 조판 등 필수 요구사항의 기능별 세분화
- 오류 자기 치유 가이드라인: 빌드 및 런타임 오류 발생 시 중단 없이 에러 로그를 분석하여 자체 수정을 시도할 것
- UI/UX 디자인 규격: 병원 환경에 최적화된 직관적이고 깔끔한 대시보드 인터페이스 규칙 정의
- 자동 검증 프로토콜: 단위 테스트와 브라우저 E2E 테스트를 작성하고 모든 테스트를 통과할 때까지 멈추지 말 것
- 비개발자 친화적 패키징: Node.js 환경에서 더블클릭만으로 실행되는 Windows 배치 파일 생성 명령
정제된 확장 프롬프트를 Claude Code 세션에 단 한 번 주입하자, 모델은 지침에 포함된 검증 기준에 맞춰 스스로 작업을 쪼개고 실행해 나갔습니다. 사용자의 추가 피드백이 끼어들 여지를 처음부터 최소화한 완성도 높은 프롬프트 설계가 무인 구동의 방아쇠 역할을 한 셈입니다.
4. DentalAX의 도메인 아키텍처와 구현된 기능 스택
DentalAX는 단순한 할 일 목록 앱이 아닙니다. 치과라는 특수 의료 환경의 오프라인 워크플로를 소프트웨어로 완벽히 디지털 전환(AX)한 풀스택 시스템입니다. 외부 클라우드 의존도를 최소화하고 로컬 환경에서 안전하게 동작하도록 3계층 아키텍처로 구현되었습니다.
4-1. 영역별 세부 비즈니스 로직
DentalAX 내부에 구축된 기능들은 실제 병원 경영에 직결되는 복잡한 유스케이스들을 정밀하게 다룹니다. 일반적인 CRUD를 넘어 도메인 특화 규칙들이 코드 레벨에서 녹아들어 있습니다.
- 데스크 및 커뮤니케이션 모듈: 공지사항 및 인수인계 읽음 확인 추적, 오픈·마감 업무 체크리스트, 환자 응대 전화 스크립트 작성 보조, 네이버 지도 및 포털 리뷰 답글 초안 생성기능을 갖추었습니다. 특히 의료법 위반을 방지하기 위해 '의료광고 주의 표현 실시간 검사기'가 탑재되었습니다.
- 스마트 재고 및 발주 시스템: 치과 재료의 특성을 반영해 유효기간이 가장 짧게 남은 로트(Lot)부터 먼저 소진하는 선입선출(FIFO) 입출고 로직을 구현했습니다. 잔여 수량 및 유효기간 임박 알림을 제공하며 거래처별 발주서를 자동으로 A4 규격에 맞춰 조판 및 인쇄할 수 있습니다. 거래명세서 CSV를 업로드하면 입고 품목을 자동 인식합니다.
- 행정, 서식 및 인쇄 자동화: 치과 운영에 필요한 공문, 안내문, 원내 규정, 업무 매뉴얼을 표준 A4 양식에 맞추어 마크다운 기반으로 작성 및 출력합니다. 원내 회의록 요약 기능과 각종 법정 서식 보관함을 지원합니다.
- 인사 및 법정 의무 관리: 직원 근무 스케줄 표 작성, 연차 신청 및 잔여 일수 실시간 계산, 의료기관 종사자 법정 의무 교육 이수 여부 추적, 신규 입사자 온보딩 체크리스트 기능을 제공합니다.
- 시설, 장비 및 법정 점검: 고압증기 멸균기 작동 기록(환자 식별 정보 배제), 원내 주요 의료 장비 점검 주기 관리 및 법정 정기 검사 일정 캘린더를 운영합니다.
- 원내 지출 및 AI 도우미: 환자 매출 데이터를 제외한 순수 운영 지출 항목을 기록하고 자동 분류를 추천합니다. 원내 매뉴얼 파일을 기반으로 질의응답을 제공하는 근거 기반(Grounding) AI 챗봇이 내장되어 있습니다.
AI 엔진은 Claude뿐만 아니라 OpenAI, Google Gemini API와 교체 연동이 가능하며, API 키가 없는 환경에서도 내부 시스템을 온전히 점검할 수 있도록 완성도 높은 목업(Mockup) 기반 '데모 모드'를 내장하고 있습니다.
5. 로컬 설치 및 무인 실행 환경 재현 가이드
DentalAX 프로젝트의 진정한 가치는 결과물뿐 아니라 그 재현 가능성에 있습니다. 공식 저장소는 윈도우 환경의 치과 데스크 PC나 개인 노트북에서 비개발자도 즉시 시스템을 구동해 볼 수 있도록 완벽한 배치 스크립트를 제공합니다. 프로젝트를 로컬 머신에서 실행하는 절차는 매우 직관적입니다.
먼저 공식 웹사이트에서 Node.js LTS 버전을 내려받아 설치한 뒤, DentalAX 저장소를 복제하거나 ZIP 압축을 해제합니다. 이후 터미널이나 탐색기에서 패키지 초기화를 진행합니다.
git clone https://github.com/GangJaeYu/DentalAX.git
cd DentalAX
npm install
윈도우 사용자의 경우 명령어를 직접 칠 필요 없이 저장소 루트에 위치한 install.bat 파일을 더블클릭하는 것만으로 의존성 라이브러리가 자동으로 설정됩니다. 설치가 완료된 후에는 실행 배치 파일을 구동합니다.
npm start
또는 start.bat을 더블클릭하면 로컬 백엔드 서버가 시작되면서 기본 브라우저가 자동으로 열립니다. 첫 접속 시 나타나는 "처음 설정" 화면에서 원장용 관리자 마스터 계정을 생성하면 즉시 모든 모듈이 활성화됩니다. 동일한 원내 로컬 네트워크(와이파이)에 연결된 진료실 체어 사이드 태블릿이나 데스크탑 브라우저에서도 콘솔 창에 출력되는 로컬 IP 주소를 입력하여 다자간 접속이 가능합니다.
6. 에이전트 자율 개발의 한계와 실무 도입 시의 보안 가이드
DentalAX의 성공은 놀라운 이정표이지만, 이를 맹신하고 프로덕션 환경에 무비판적으로 배포하는 것은 경계해야 합니다. 자율 에이전트가 구축한 시스템을 현업에 도입하기 전에 점검해야 할 기술적·법적 주의사항이 존재합니다.
첫째는 의료 데이터 격리 원칙의 영속성 검증입니다. DentalAX는 초기 기획부터 환자 진료 기록이나 개인 식별 정보(PII)를 다루지 않도록 설계되었습니다. 만약 원내 실무자가 편의를 위해 환자의 성명, 차트 번호, 진료 내역을 메모나 지출 항목에 기재하기 시작하면 의료법 및 개인정보보호법에 따른 암호화 조치, 접근 통제 감사 로그, 접속 기록 보관 의무 등 막중한 법적 규제 대상이 됩니다. 시스템 프롬프트 수준의 통제 외에도 백엔드 데이터베이스 수준에서 PII 패턴을 정규식으로 마스킹하는 하드웨어적 필터링 계층이 반드시 추가되어야 합니다.
둘째는 자율 치유된 코드의 엣지 케이스 점검입니다. 175개의 테스트와 28단계 E2E 검증을 통과했다고 해서 모든 예외가 해결된 것은 아닙니다. LLM은 자신이 작성한 코드의 테스트를 스스로 작성할 때, 본인이 예상한 입력 범위 내에서만 테스트 케이스를 구성하는 인지적 편향을 보일 수 있습니다. 예컨대 네트워크 지연으로 인한 동시성 발주 충돌, 정전으로 인한 SQLite 데이터베이스 손상 복구, 브라우저 로컬 스토리지 한계 등 인프라 레벨의 극한 상황에 대한 인간 엔지니어의 코드 오딧(Code Audit)은 필수적입니다.
7. 결론: 도메인 지식과 에이전트 인프라의 결합이 여는 미래
DentalAX 사례가 우리에게 던지는 가장 거대한 시사점은 '개발 진벽의 소멸'입니다. 지금까지 치과 의사가 원내 맞춤형 소프트웨어를 구축하려면 SI 외주 개발사에 수천만 원의 비용을 지불하고 수개월간 요구사항을 조율해야 했습니다. 이 과정에서 병원 현장의 미세한 도메인 맥락(예: 멸균기 점검 주기, 치과 재료 유효기간 우선 소진, 의료광고 심의 규정)이 개발자에게 제대로 전달되지 않아 프로젝트가 실패하는 경우가 허다했습니다.
하지만 Claude Opus 5.5와 Claude Code의 결합은 현업 전문가가 직접 개발의 총괄 아키텍트가 되는 길을 열었습니다. 의사는 코드를 배우는 대신 자신의 도메인 지식을 정밀한 프롬프트로 가공하는 데 집중했고, 코딩과 빌드, 테스트는 AI 에이전트가 1시간 45분 만에 끝마쳤습니다. 도메인 지식을 가장 깊이 이해하고 있는 실무자가 AI 하네스를 제어할 때 어떤 파괴적 생산성이 나오는지 DentalAX는 가장 구체적이고 생생한 실증 사례로 증명하고 있습니다.
자주 묻는 질문
Q. DentalAX 개발에 정말 사람의 코드 수정이 한 번도 없었나요?
A. 공식 GitHub 저장소의 개발 일지에 따르면, 확장 프롬프트를 Claude Code에 주입한 이후 1시간 45분 동안 인간의 코드 개입, 수정, 디버깅은 0회였습니다. 175개의 테스트 통과와 28단계 브라우저 E2E 검증까지 에이전트가 스스로 완결했습니다.
Q. Claude Opus 5.5의 effort: high 설정은 무엇을 의미하나요?
A. Opus 5.5는 내부 추론(Thinking)이 상시 켜져 있는 모델로, effort 설정을 high로 지정하면 복잡한 작업에서 사전 계획 수립과 도구 호출, 에러 발생 시 자율 대안 탐색을 가장 깊은 수준으로 수행합니다.
Q. 병원에서 사용 시 환자 개인정보 유출 위험은 없나요?
A. DentalAX는 기획 단계부터 환자 진료 기록이나 개인 식별 정보(PII)를 일절 다루지 않는 순수 원내 운영·행정 관리 도구로 설계되었습니다. 또한 로컬 환경에서 구동되므로 민감 데이터가 외부 서버로 전송되지 않습니다.
Q. 비개발자도 로컬 컴퓨터에서 바로 실행해 볼 수 있나요?
A. Node.js를 설치한 후 저장소에 포함된 install.bat과 start.bat 배치 파일을 더블클릭하는 것만으로 브라우저가 자동 실행되어 즉시 시스템을 사용할 수 있습니다.
원본
https://github.com/GangJaeYu/DentalAX
https://platform.claude.com/docs/ko/build-with-claude/prompt-engineering/prompting-claude-opus-5-5
https://aicreatorlab.com/blog/claude-opus-5-5-effort-prompting



댓글 0개