HWP 양식의 지원사업 계획서를 바이브코딩으로 만드는 4가지 단계 (md → HTML → HWPX → HWP)
2026.05.14
지피터스 김태현님이 며칠 전 아래 글을 공유해주셨습니다.
구글 닥스 복붙 작업이 사라졌다는 부분에서 진심으로 부러웠어요. 마침 저도 정부 R&D 협업 사업 협업계획서를 쓰고 있던 차였어서, 그 워크플로우를 그대로 따라해봤습니다.
본문 작성까지는 정확히 똑같이 됐어요. md 초안 → HTML 양식 재현 → PDF로 사내 검토 → 피드백 반영
문제는 ... 태현님의 완성본은 PDF 였지만, 저는 협력사 담당자에게는 수정 가능한 HWP 파일 자체를 보내야 하는 이슈였습니다. 받는 분도 내부 검토하고 코멘트를 달고 부분 수정을 해야 하니까요.
이 글은 그 마지막 한 단계 — "수정 가능한 HWP가 필요할 때" — 에 Codex Computer Use로 시도한 과정과, 사실 Computer Use 없이 Claude Code 안에서도 동일한 작업이 가능하다는 결론에 도달한 기록입니다.

🎯 이런 분들께 도움돼요
정부 R&D 협업계획서를 HWP 양식으로 줘야 하는 스타트업
한컴 오피스에 손으로 타이핑하기 싫고 AI로 양식 채우기를 자동화하고 싶은 분
😫 문제 상황 (Before)
정부 R&D 협업 사업 협업계획서. 양식은 정부 운영기관 배포 HWP — 표 7개 + 별지, A4 8페이지.
태현님 글대로 HTML 한방 워크플로우를 적용했어요.
HWP 양식을 시각 분석
md로 본문 초안 작성
HTML로 양식 재현 (살구색 헤더, A4 페이지 셋업)
Chrome headless로 PDF 출력 → 사내 검토
피드백 13건 반영 → PDF 재생성
여기까진 깔끔했어요. md/HTML/PDF가 동시에 살아 있어서 텍스트 수정 → PDF 재출력이 30초 만에 끝났어요.
그런데 협력사 담당자에게 보낼 때 깨달았어요. "PDF만 보내면 받는 분이 한컴 오피스에서 어떻게 검토·수정하지?" 협력사가 직접 코멘트 달고 수정해야 하니 HWP 파일 자체가 필요했어요.
선택지를 정리해봤어요.
A. 한컴 오피스에 직접 타이핑 — 양식 깨질 위험, 13가지 피드백 손으로 옮기는 데 2~3시간
B. PDF를 보내고 협력사가 수정 필요한 부분을 메일로 쓰게 하기 — 정확히 어떤 부분을 어떻게 수정하고 싶은지 모호해질 수 있음. 수정 범위가 큰 경우 상호 피곤해짐
C. Codex Computer Use에 맡기기 — 컴퓨터 유즈로 하나씩 복붙하는걸 내 대신 시키면 어떨까?
C로 갔어요.
🛠️ 사용한 도구
본문 작성: Claude Code (Opus 4.7) — md/HTML/PDF 초안 (태현님 글 워크플로우)
HWP 변환: Codex CLI Computer Use — 한컴 오피스 GUI 자동화
포맷 변환: Hancom Office (HWP ↔ HWPX)
셀 텍스트 교체: Python (HWPX 내부 XML 편집)
🔧 작업 과정
Step 1 — HTML 한방 워크플로우
태현님 글의 1~3단계를 그대로 따라했어요.
HWP 원본 양식 그대로 HTML로 재현해줘 (A4, 살구색 헤더 #FCE4D6,
제목 박스, §5는 점선 행 구분, 페이지 번호 - N - 형식).
양식 분석한 결과로 md 초안도 같이 만들어줘.
Claude가 표 7개 분석해서 HTML 30KB + md 17KB + PDF 460KB를 만들었어요.

Step 2 — "HWP 로 다시 변환"
Codex CLI Computer Use 모드를 켰어요.
'[붙임1] 협업계획서 양식.hwp' 여기 한글 파일로 내용을 채워야 해.
각각의 내용은 md 파일에 있고, 임시로 html 형식으로 만들어둔 게 있어.
최종 목표: html 파일 내용을 그대로 hwp 양식에 채우기. 할 수 있겠니?
Codex가 9분 작업하고 돌아왔어요. 진짜 되긴 했는데... 해결 방식은 복붙이 아니었습니다.
Codex가 9분 동안 한 일
간단히 말하면, "HWP를 직접 뜯어고친 것"은 아니고 HWP 양식을 HWPX(XML)로 우회해서 편집한 뒤 다시 HWP로 저장했습니다.
흐름은 이랬어요.
.hwp→.hwpx변환 — HWP는 한컴 독자 바이너리라 자동 편집이 어려운데, HWPX는 사실상 ZIP 안에 XML이라 만질 수 있어요. Codex가 Computer Use로 한컴 오피스 GUI를 띄워서 "다른 이름으로 저장"HWPX 풀어서 XML 분석 —
Contents/section0.xml들여다보니 표 11개 잡힘HTML 직접 변환 시도 → 실패 — 임시 HTML 내용을 그대로 HWP에 넣으니 6쪽이 11쪽으로 늘어났고 표 폭도 어긋남. HTML과 HWP의 페이지 모델이 다르거든요.
방향 전환 — 여기서 Codex가 결정적인 판단을 했어요. HTML을 그대로 변환하지 않고, 원본 HWP 양식 표 구조는 손대지 않은 채 셀 안 텍스트만 갈아끼우는 방식으로 바꿈
Python으로 XML 셀 텍스트 교체 — 회사명, 체크박스, 본문, 비목 등
다시 ZIP으로 묶어 HWPX → 한컴에서 렌더링 확인 → HWP 저장
최종 산출물: 협업계획서_작성본.hwp. 한컴에서 열어보니 양식 표, 페이지 번호, 색상, 여백이 원본과 동일하게 유지됐어요.
✅ 결과 (After)
항목 | Before (태현님 워크플로우) | After (HWP 제출용으로 한 단계 추가) |
|---|---|---|
본문 작성 | HTML 한방 | HTML 한방 (그대로) |
제출 포맷 | HWP (수정 가능) + PDF (검토용) | |
HTML → HWP 변환 | (필요 없음) | Codex Computer Use - 근데 사실 클로드코드 안에서도 할 수 있는 것이었음 |
협력사 검토 | PDF는 코멘트만 가능 | HWP는 직접 수정 가능 |
수치보다 더 큰 변화는 "HWP 제출 제약이 있어도 HTML 워크플로우를 포기할 필요가 없었다"는 점이에요.
회고 — 결론은 "Claude Code 안에서도 할 수 있다"
작업 끝나고 한참 뒤에 다시 따져봤어요. Computer Use가 꼭 필요했던 단계는 두 군데뿐이었어요.
.hwp→.hwpx변환.hwpx→.hwp환원
나머지는 다 Python으로 가능해요. 그리고 이 두 단계도 사실 macOS osascript(AppleScript)로 셸에서 한컴 오피스를 제어할 수 있어요.
tell application "Hangul"
open POSIX file "/path/원본.hwp"
save document 1 in POSIX file "/path/원본.hwpx"
close document 1
end tell
osascript는 그냥 셸 명령이에요. Claude Code 안에서 Bash 도구로 호출하면 끝. 즉, 다음부터는 굳이 Codex Computer Use를 켜지 않아도, Claude Code 안에서 본문 작성 + HWP 양식 채우기까지 일원화가 됩니다. 이번엔 Computer Use가 가장 직관적이라 썼지만, 결론은 Computer Use는 필수가 아니라는 점이에요.
우리 회사에도 이런 자동화를 도입하고 싶다면
회사 업무에 맞춘 AI 교육을 함께 설계해요.




너무 좋은 방법이네요!
그런데, 어떻게 "HWP는 한컴 독자 바이너리라 자동 편집이 어려운데, HWPX는 사실상 ZIP 안에 XML이라 만질 수 있어요." 이 부분을 알수 있었나요?
그리고, 수정한 뒤에 페이지가 넘어간다거나 하는 Pagination 문제를 어떻게 해결했는지도 궁금합니다.
HWP는 한컴 독자 바이너리라 자동 편집이 어려운데, HWPX는 사실상 ZIP 안에 XML이라 만질 수 있어요. -> 이것은 저는 몰랐고 코덱스가 알려줬습니다.
hwp 파일로 만들었을 때 표가 길어져서 잘려보이거나 이런건 제가 결국 수동으로 잘라내고 했는데요, 이번에는 전체 파일이 6장 정도의 간결한 문서라 2-3번 정도만 건드려주면 되긴 했었습니다만 긴 문서는 후속 자동화 처리까지 시켜놓으면 좋을 것 같긴 하네요.