본문으로 건너뛰기

승강기 기술 규격 번역 가이드: PWA로 4일 만에 완성

아레테_Arete

2026.05.28

Open optionsmarkdown

# [Claude Code] 승강기 기술 규격 번역 PWA, 4일 만에 완성하고 자동 배포까지

## 📝 한 줄 요약

Claude Code로 4일 만에 기술 규격 전문 번역 PWA를 만들고, PDF → 한국어 docx 번역 워크플로우를 자동화했습니다. 번역 품질은 전문 용어집과 표·그림 정밀 모드를 더해 크게 개선했습니다.

---

## 🎯 도전 과제

- 영문 승강기 기술 규격 문서가 40~50페이지 이상으로 길고 복잡함
- 구글 번역은 전문 용어를 자주 오역함
- 원본이 PDF여서 텍스트 변환, 표, 그림 처리까지 모두 신경 써야 함
- 내부 공유용으로는 빠르게 배포 가능한 웹앱이 필요함

---

## 🛠️ 해결 방법

### 1. 빠르게 MVP부터 시작

- Claude Code에게 먼저 텍스트 번역 에이전트를 만들어달라고 요청
- 결과를 확인한 뒤, PDF 업로드 → 번역 → docx 다운로드로 흐름 전환
- 서버에 PDF를 올리지 않고 브라우저 내 처리하는 원칙을 적용

### 2. 전문 용어집을 먼저 정리

- 승강기 용어 52개, 국제 표준 매핑 28개를 먼저 정리
- 용어집을 AI 번역에 탑재해 일반 번역보다 전문 용어 정확도를 높임

### 3. 모델 선택과 보안

- Google Gemini 2.5 Flash(무료)와 Claude Sonnet(유료)를 모두 선택 가능하게 구현
- API 키는 브라우저에 안전하게 저장하고, localStorage → IndexedDB 암호화로 처리

### 4. 표와 그림 품질 개선

- 긴 PDF를 청크 단위로 나눠 번역하는 방식으로 잘림 문제 해결
- PDF 페이지를 PNG로 렌더링해 LLM에 텍스트와 함께 전달
- 마크다운 표로 변환해 docx 표로 복원하고, 그림은 원본 이미지로 삽입

### 5. 배포와 공유

- Next.js 기반 PWA를 Vercel에 자동 배포
- Basic Auth 기반 로그인으로 외부 접근을 간단하게 제한
- `scripts/push.ps1` 한 줄로 빌드 → 커밋 → push 자동화

---

## ✅ 결과

- 40~50페이지 PDF 번역 소요 시간: 수작업 수 시간 → 몇 분
- 전문 용어 정확도: 구글 번역 오역 다수 → 용어집 탑재로 대폭 개선
- 표·그림 처리: 구조 소실과 누락 → 표 유지 + 원본 그림 삽입
- 동료 공유: 파일 전달 → Vercel 링크로 바로 접속

---

## 💡 주요 배운 점

- 에러 화면과 메시지를 그대로 AI에 보여주면 문제 해결 속도가 빨라짐
- 작은 것부터 먼저 작동하게 만들고, 이후에 정밀 모드를 붙이는 방식이 효과적임
- API 키와 배포 환경 변수는 미리 준비해두면 시행착오를 줄일 수 있음

---

## 🌍 확장 가능성

- 건설·기계 분야 기술 문서 번역
- 의료·제약 임상 문서 번역
- 다른 전문 분야 PDF 자동 번역 시스템

---

## 📁 생성 위치

- `D:\AI-Repo\학습실_Gpters\[Claude Code] 승강기 기술 규격 번역 PWA, 4일 만에 완성하고 자동 배포까지.md`
5

함께 이야기해요 5

로그인하고 댓글을 남겨 주세요

배
배꽃님2026.05.28

'에러 화면과 메시지를 그대로 AI에 보여주면 문제 해결 속도가 빨라짐 - 작은 것부터 먼저 작동하게 만들고, 이후에 정밀 모드를 붙이는 방식이 효과적임'

가끔 번역 할 일이 있는데 인사이트 얻었습니다.

류웅수_이안_IAN 프로필 이미지

[Claude Code] 승강기 기술 규격 번역 PWA, 4일 만에 완성하고 자동 배포까지. 이런 시행착오는 나중에 비슷한 상황에서 다시 떠올리게 될 것 같아요.

Kim MK 프로필 이미지
Kim MK2026.05.28

저도 간혹 제 전문분야의 외국어 문서를 번역요청하는데, 전문용어를 ai가 잘못번역해서 문맥이 어색해지거나 수치화 된 기준을 잘못 기록하여 크게 문제가 될 뻔한 일이 있고 나서는 전문 문서 번역은 조금 회피하게 되더라구요.

꼭 필요한 상황이라면 해당 챕터(혹은 문장)만 스크린샷이나 복사+붙여넣기방식로 번역의뢰하곤 했었는데요. arete3599님이 하신 방법처럼 전문 에이전트를 만들어놓으면 번역기록이 경험으로 쌓여서 분야와 문맥을 이해한 에이전트가 복리의 효과로 번역 품질이 더 나아져 신뢰향상이 금방 될 수 있겠다고 생각했습니다.

지금 계획하고 있는 것 부터 해보고, 번역 에이전트는 저도 한번 도전해 봐야겠습니다. 좋은 글 감사합니다.

아레테_Arete 프로필 이미지
아레테_Arete2026.05.29

전문분야일 수록 용어집 작성이 매우 중요하더라구요. 번역이 반복될 수록 자주 등장하는 용어를 새롭게 정의하여 용어집을 자동으로 업데이트를 해주는게 저도 정말 신기했습니다. 기술분야의 해외코드들은 많게는 수백 페이지라 전집한번 번역하면 거의 모든 요어가 정리될 수 있겧더라구요. 단, 그만큼 유로버전을 탑재해야해서 비용은 들겠지만 외주 주는 비용보단 절감이 많이 되듯 합니다. 댓글 주시고 관심 갖아주셔서 감사해요^^

아루나 프로필 이미지
아루나2026.06.01

전문용어집을 만들고 활용하시는게 인상깊네요! 생소한 분야에 대해 작업을 진행할때 해당분야에 전문지식이 없는것때문에 문제가 생기는데 그걸 전문용어집으로 해결하시는게 인상이 깊네요! 나아가 실제 전문서석을 번역시키거나 학습시키면 전문 용어뿐아니라 해당분야의 실제 전문지식과워크플로우 활용법도 ai가 습득해서 일을 더 잘할수 있겠네요.

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기