HWP 양식의 지원사업 계획서를 바이브코딩으로 만드는 4가지 단계 (md → HTML → HWPX → HWP)

지피터스 김태현님이 며칠 전 아래 글을 공유해주셨습니다.

구글 닥스 복붙 작업이 사라졌다는 부분에서 진심으로 부러웠어요. 마침 저도 정부 R&D 협업 사업 협업계획서를 쓰고 있던 차였어서, 그 워크플로우를 그대로 따라해봤습니다.

본문 작성까지는 정확히 똑같이 됐어요. md 초안 → HTML 양식 재현 → PDF로 사내 검토 → 피드백 반영

문제는 ... 태현님의 완성본은 PDF 였지만, 저는 협력사 담당자에게는 수정 가능한 HWP 파일 자체를 보내야 하는 이슈였습니다. 받는 분도 내부 검토하고 코멘트를 달고 부분 수정을 해야 하니까요.

이 글은 그 마지막 한 단계 — "수정 가능한 HWP가 필요할 때" — 에 Codex Computer Use로 시도한 과정과, 사실 Computer Use 없이 Claude Code 안에서도 동일한 작업이 가능하다는 결론에 도달한 기록입니다.

ALT

한국어 앱 스크린샷

🎯 이런 분들께 도움돼요

• 정부 R&D 협업계획서를 HWP 양식으로 줘야 하는 스타트업

• 한컴 오피스에 손으로 타이핑하기 싫고 AI로 양식 채우기를 자동화하고 싶은 분

😫 문제 상황 (Before)

정부 R&D 협업 사업 협업계획서. 양식은 정부 운영기관 배포 HWP — 표 7개 + 별지, A4 8페이지.

태현님 글대로 HTML 한방 워크플로우를 적용했어요.

1. HWP 양식을 시각 분석

2. md로 본문 초안 작성

3. HTML로 양식 재현 (살구색 헤더, A4 페이지 셋업)

4. Chrome headless로 PDF 출력 → 사내 검토

5. 피드백 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를 만들었어요.

ALT

한국어 한국어 한국어 한국어 한국어 한국어 한국어 한국어

Step 2 — "HWP 로 다시 변환"

Codex CLI Computer Use 모드를 켰어요.

'[붙임1] 협업계획서 양식.hwp' 여기 한글 파일로 내용을 채워야 해.
각각의 내용은 md 파일에 있고, 임시로 html 형식으로 만들어둔 게 있어.
최종 목표: html 파일 내용을 그대로 hwp 양식에 채우기. 할 수 있겠니?

Codex가 9분 작업하고 돌아왔어요. 진짜 되긴 했는데... 해결 방식은 복붙이 아니었습니다.

Codex가 9분 동안 한 일

간단히 말하면, "HWP를 직접 뜯어고친 것"은 아니고 HWP 양식을 HWPX(XML)로 우회해서 편집한 뒤 다시 HWP로 저장했습니다.

흐름은 이랬어요.

1. .hwp → .hwpx 변환 — HWP는 한컴 독자 바이너리라 자동 편집이 어려운데, HWPX는 사실상 ZIP 안에 XML이라 만질 수 있어요. Codex가 Computer Use로 한컴 오피스 GUI를 띄워서 "다른 이름으로 저장"

2. HWPX 풀어서 XML 분석 — Contents/section0.xml 들여다보니 표 11개 잡힘

3. HTML 직접 변환 시도 → 실패 — 임시 HTML 내용을 그대로 HWP에 넣으니 6쪽이 11쪽으로 늘어났고 표 폭도 어긋남. HTML과 HWP의 페이지 모델이 다르거든요.

4. 방향 전환 — 여기서 Codex가 결정적인 판단을 했어요. HTML을 그대로 변환하지 않고, 원본 HWP 양식 표 구조는 손대지 않은 채 셀 안 텍스트만 갈아끼우는 방식으로 바꿈

5. Python으로 XML 셀 텍스트 교체 — 회사명, 체크박스, 본문, 비목 등

6. 다시 ZIP으로 묶어 HWPX → 한컴에서 렌더링 확인 → HWP 저장

최종 산출물: 협업계획서_작성본.hwp. 한컴에서 열어보니 양식 표, 페이지 번호, 색상, 여백이 원본과 동일하게 유지됐어요.

✅ 결과 (After)

수치보다 더 큰 변화는 "HWP 제출 제약이 있어도 HTML 워크플로우를 포기할 필요가 없었다"는 점이에요.

회고 — 결론은 "Claude Code 안에서도 할 수 있다"

작업 끝나고 한참 뒤에 다시 따져봤어요. Computer Use가 꼭 필요했던 단계는 두 군데뿐이었어요.

1. .hwp → .hwpx 변환

2. .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는 필수가 아니라는 점이에요.