PDF·워드를 한글(hwpx) 문서로 바꾸는 법 – Claude hwpx 스킬 설치 4단계와 직접 시험 결과

PDF나 워드(DOCX)로 받은 자료를 회사 양식에 맞춰 한글 문서로 다시 만드는 일은 생각보다 자주 생깁니다. 거래처가 보낸 공문은 PDF로 오고, 내부 보고는 한글(.hwp, .hwpx)로 올려야 하는 경우가 많기 때문입니다. 내용을 복사해 붙여 넣으면 표는 깨지고, 결재란과 번호 체계는 처음부터 다시 그려야 합니다.
이 글에서는 AI 도구 Claude(클로드)에 hwpx 스킬을 올려 PDF·워드 문서를 한글(.hwpx) 문서로 만드는 방법을 정리합니다. 설치 순서는 Claude 공식 도움말과 스킬 개발자의 저장소를 기준으로 설명하고, 실제로 어느 정도까지 되는지는 같은 스킬 엔진으로 직접 시험한 결과로 보여 드립니다. 잘 된 부분만이 아니라 안 된 부분도 함께 적었습니다.

※ 2026년 10월 17일 기준 내용입니다. 서비스 메뉴와 스킬 버전은 바뀔 수 있습니다.

목차

1. 먼저 알아 둘 것: .hwpx와 hwpx 스킬
2. 준비물과 사용 조건
3. Claude에 hwpx 스킬을 올리는 4단계
4. 요청 문장은 이렇게 쓰는 것이 좋습니다
5. 직접 시험한 결과: 자동 변환과 AI 재구성 비교
6. 99쪽 실제 문서로 해 본 요약서 만들기
7. 변환 결과를 쓰기 전에 확인할 5가지
8. 자주 묻는 질문
9. 정리

1. 먼저 알아 둘 것: .hwpx와 hwpx 스킬

.hwpx는 어떤 형식인가요?

.hwpx는 한글 문서의 개방형 형식입니다. 한컴 안내에 따르면 개방형 문서 형식(OWPML)은 한글 2010 버전부터 .hwpx 확장자로 지원하고 있습니다. 2021년 4월에는 한컴이 정기 패치를 통해 한글의 기본 저장 형식을 HWP에서 HWPX로 바꿨다고 여러 언론이 보도했습니다. XML 기반이라 프로그램이 내용을 읽고 쓰기 쉬운 것이 특징입니다.
그래서 AI가 한글 문서를 다룰 때도 예전 바이너리 형식(.hwp)보다 .hwpx가 다루기 수월합니다. 이 글에서 결과물을 .hwpx로 받는 이유도 여기에 있습니다.

hwpx 스킬은 무엇인가요?

Claude의 스킬(Skills)은 특정 작업을 하는 방법과 도구를 묶어 Claude에 추가하는 기능입니다. hwpx 스킬은 개인 개발자(@airmang)가 공개한 오픈소스 프로젝트 hwpx-plugins 안에 들어 있는 스킬로, 한글 문서를 읽고 고치고 새로 만들 수 있게 해 줍니다. 몇 가지는 미리 알아 두시는 것이 좋습니다.

• 한컴 공식 도구가 아닙니다. 개인 개발자의 오픈소스(Apache-2.0 라이선스)입니다.
• 저장소 이름은 hwpx-plugins, 실제로 설치되는 스킬 이름은 hwpx입니다. 개발자도 둘을 헷갈리지 말라고 안내합니다.
• .hwpx와 HWP 5.0(.hwp)을 다루며, 암호가 걸린 문서·배포용 문서·DRM 문서는 처리할 수 없다고 알려 줍니다.
• 핵심 엔진은 아직 알파(Alpha) 단계로 표시되어 있습니다. 업무에 쓸 때는 결과를 반드시 직접 확인해야 합니다.

2. 준비물과 사용 조건

Claude 플랜	Free, Pro, Max, Team, Enterprise 모두 스킬 사용 가능
필수 설정	코드 실행(Code execution and file creation)이 켜져 있어야 함
스킬 파일	GitHub의 airmang/hwpx-plugins 저장소에서 hwpx 폴더를 ZIP으로 묶은 파일
파일 크기	Claude 파일 업로드·다운로드는 파일당 최대 30MB
결과 확인 도구	한글 2010 이상, 또는 오픈소스 편집기 HOP(macOS·Windows·Linux)

Team 플랜은 조직 단위로 코드 실행이 기본으로 켜져 있고 소유자가 끌 수 있습니다. Enterprise는 소유자가 조직 설정에서 코드 실행과 스킬을 켜야 합니다. 회사 계정이라면 관리자에게 먼저 확인하는 것이 빠릅니다.

3. Claude에 hwpx 스킬을 올리는 4단계

아래 메뉴 이름은 Claude 영어 공식 도움말의 표기입니다. 한국어 화면에서는 이름이 다르게 보일 수 있습니다.

1단계. 코드 실행 켜기

Settings › Capabilities에서 Code execution and file creation을 켭니다. Free·Pro·Max 플랜은 기본으로 켜져 있지만, 예전에 꺼 두었다면 스킬이 동작하지 않으니 한 번 확인해 주세요.

2단계. 스킬 폴더를 ZIP으로 묶기

GitHub에서 airmang/hwpx-plugins 저장소를 열고 Code › Download ZIP으로 내려받습니다. 압축을 풀면 여러 폴더가 나오는데, 필요한 것은 plugins/claude/hwpx-plugin/skills/hwpx 폴더 하나입니다. 이 hwpx 폴더를 통째로 다시 ZIP으로 압축합니다.

공식 도움말은 ZIP 안에 폴더가 들어 있어야 하고, 폴더 이름이 스킬 이름과 같아야 하며, 스킬 설명 파일이 있어야 한다고 안내합니다. 저장소 전체를 그대로 올리는 것이 아니라 hwpx 폴더만 묶는 것이 핵심입니다. 참고로 저희가 직접 묶었을 때 크기는 약 2.1MB, 파일은 493개였습니다(2026년 10월 17일 기준).

3단계. Claude에 업로드하기

Customize › Skills로 들어가 + 버튼을 누르고 Create skill › Upload a skill을 선택한 뒤 ZIP 파일을 올립니다. 올린 스킬은 기본적으로 본인에게만 보입니다. Team·Enterprise 플랜에서는 관리자가 공유 기능을 켜면 팀원과 함께 쓸 수 있습니다.
공식 도움말은 믿을 수 있는 출처의 스킬만 설치하고, 출처가 확실하지 않으면 켜기 전에 코드를 검토하라고 안내합니다. 오픈소스 스킬이라도 한 번은 저장소 설명을 읽어 보시는 것을 권합니다.

4단계. 파일을 첨부하고 요청하기

새 대화에서 PDF나 워드 파일을 첨부하고 한글 문서로 만들어 달라고 요청합니다. 스킬은 결과물을 미리보기 이미지로 그려 스스로 검사한 뒤 .hwpx 파일을 돌려줍니다. 요청 문장은 다음 장에서 조금 더 자세히 설명합니다.

4. 요청 문장은 이렇게 쓰는 것이 좋습니다

"한글로 바꿔 줘"라고만 쓰는 것보다, 살려야 할 구조를 구체적으로 적는 것이 결과가 훨씬 좋았습니다. 아래 시험 결과에서 보듯이 자동 변환만으로는 표와 결재란이 쉽게 깨지기 때문입니다.

첨부한 PDF 공문을 한글(.hwpx) 문서로 만들어 줘. 맨 위 결재란(담당·팀장·본부장)과 일정표는 표로, 번호는 1. 가. 체계 그대로, 2쪽에서 쪽을 나눠 줘. 이름과 연락처는 빼 줘.

요청할 때 넣으면 좋은 항목은 다음과 같습니다.

• 표로 만들어야 하는 부분(결재란, 일정표, 비교표)
• 번호 체계(1. 가. 1) 또는 □ ㅇ - 기호)
• 쪽을 나눌 위치와 머리글·바닥글(쪽 번호)
• 넣어야 할 그림이나 그래프
• 빼야 할 개인정보

5. 직접 시험한 결과: 자동 변환과 AI 재구성 비교

시험 조건

먼저 시험 방법을 정확히 밝혀 둡니다. 2026년 10월 17일, 맥북(Apple Silicon)에서 hwpx 스킬 저장소에 들어 있는 같은 엔진을 직접 실행해 시험했습니다. Claude 앱에 스킬을 올려 대화로 요청한 시험은 아직 하지 못했습니다. 시험 문서는 회사명·이름·숫자를 모두 지어낸 예시 문서이고, 결과 화면은 오픈소스 편집기 HOP이 쓰는 rhwp 엔진으로 그렸습니다. 한컴오피스(한글)에서 직접 열어 보지는 않았습니다.
시험한 문서는 두 가지입니다.

• 공문 PDF 2쪽: 결재란, 일정표, 1. 가. 번호 체계
• 보고서 워드(DOCX): 결재란, 표, 병합 셀, 막대그래프 그림, 쪽 나눔, 바닥글, 기울임 글꼴

그리고 두 가지 방식으로 만들어 비교했습니다. A는 아무 손도 대지 않은 자동 변환, B는 AI가 원본을 보고 결재란·표 머리행·쪽 나눔·그림·번호를 다시 정해서 만드는 방식입니다. Claude 앱에서 스킬을 쓰면 AI가 하는 일이 B에 가깝습니다.

A. 자동 변환만 했을 때

공문 PDF	파일이 만들어지지 않음. 글자는 모두 뽑혔지만 결재란 표에서 행이 맞지 않아 멈춤. 표에 빈 열이 끼고(4열→6열) 문장이 줄 끝에서 끊김
보고서 DOCX	파일은 만들어지고 엔진 검사도 통과. 그러나 결재란 위에 없던 col1·col2·col3 머리행이 생기고, 병합 셀이 풀리고, 그래프 대신 이미지 코드 글자가 들어감. 바닥글이 사라지고 번호 목록은 글머리표로 바뀜

엔진 스스로도 "레이아웃 충실도는 보장하지 않는다(layout fidelity is not claimed)"고 경고합니다. 자동 변환만으로는 그대로 쓰기 어렵다는 뜻입니다.

B. AI가 구조를 다시 잡았을 때

공문 PDF	결재란(서명 칸 포함), 일정표, 2쪽 나눔, 1. 가. 번호 체계 모두 정상. 거의 그대로 쓸 수 있는 수준
보고서 DOCX	표 테두리, 머리행 음영, 병합 셀, 번호 목록, 막대그래프 그림, 쪽 나눔, 바닥글 쪽 번호, 기울임 모두 정상

다만 B에서도 문제가 하나 있었습니다. 보고서의 소제목 번호가 "1. 1. 추진 배경"처럼 두 번 붙었는데, 엔진 검사와 미리보기 모두 이것을 잡지 못했습니다. 소제목 글자에서 번호를 빼고 다시 만들자 정상으로 나왔습니다.
또 하나 알아 둘 점은, 이 방식이 원본 파일을 변환하는 것이 아니라 원본과 비슷한 새 한글 문서를 다시 만드는 것에 가깝다는 것입니다. 원본의 글꼴, 표 테두리 두께, 칸 너비까지 똑같이 옮기지는 않습니다.

옛 형식(.hwp)으로 저장하면

만든 .hwpx를 옛 형식 .hwp로 저장하는 것도 시험했습니다. 글자, 표, 병합 셀, 바닥글은 유지됐지만 그림은 빈칸으로 사라졌습니다. 엔진은 "빠진 것 없음"이라고 보고했는데 화면으로 그려 보니 비어 있었습니다. 그림이 들어간 문서는 .hwpx로 받는 것이 안전합니다.

6. 99쪽 실제 문서로 해 본 요약서 만들기

예시 문서만으로는 실무에 쓸 수 있는지 판단하기 어려워, 실제 공공기관 제안요청서(.hwp, 99쪽)로도 시험했습니다. 원본은 요구사항 72개, 평가표, 서식 12종이 들어 있는 문서입니다. 실제 문서라 기관명과 사업명은 밝히지 않습니다.

• 읽기: 표 안의 글자까지 73,950자를 모두 읽었습니다. 처음에는 기본 설정에서 10,000자에서 잘려 읽는 글자 수 한도를 늘려야 했습니다.
• 읽기의 한계: 표 안 글자가 본문 뒤로 몰려 나와 앞뒤를 맞춰 읽어야 했고, 그림 속 글자는 읽지 못했습니다.
• 결과: 원본 장 순서를 따른 5쪽짜리 요약서 .hwpx를 만들었습니다. 요약서에 쓴 숫자 21개를 원본에서 하나씩 검색해 모두 원본에 있는 숫자임을 확인했습니다.
• 모양: 표지 배치, 절 제목 모양, □→ㅇ→- 기호, 회색 머리행 표는 원본과 거의 같았습니다. 장 제목 띠 길이, 둘째 줄 들여쓰기, 글꼴은 원본과 달랐습니다.
• 개인정보: 원본에 있던 담당자 이름과 전화번호는 요약서에 넣지 않았습니다.

이 작업에는 읽고 파악하는 데 약 20분, 만들고 확인하고 고치는 데 약 20분이 걸렸습니다. 이번 시험 환경 기준의 시간이라 문서와 환경에 따라 달라질 수 있습니다.

7. 변환 결과를 쓰기 전에 확인할 5가지

시험에서 가장 크게 느낀 점은 "검사 통과"라는 표시를 그대로 믿으면 안 된다는 것입니다. 모양이 깨진 자동 변환 결과도, 소제목 번호가 겹친 결과도, 그림이 빠진 .hwp 파일도 모두 엔진 검사에서는 문제가 없다고 나왔습니다. 결과 파일은 반드시 직접 열어 보고 아래 항목을 확인해 주세요.

1. 결재란과 표 머리행: 없던 칸이 생기거나 병합 셀이 풀리지 않았는지
2. 소제목 번호: 번호가 두 번 붙지 않았는지
3. 그림과 그래프: 빠지지 않았는지, .hwp가 아니라 .hwpx로 받았는지
4. 이름과 연락처: 스킬 설명에는 개인정보를 가린다고 되어 있지만, 시험에서는 이름과 내선 번호가 그대로 남았습니다. 직접 지워야 합니다.
5. 회사 보안 규정: AI에게 파일 변환을 시키면 문서 내용이 AI 서비스로 전송됩니다. 회사 문서라면 사내 AI 사용 기준을 먼저 확인하세요.

8. 자주 묻는 질문

Q. 한컴에서 만든 공식 기능인가요?

아닙니다. 개인 개발자(@airmang)가 공개한 오픈소스 스킬입니다.

Q. PDF를 넣으면 원본 모양 그대로 바뀌나요?

아닙니다. AI가 구조를 다시 잡아 만들면 결재란·표·번호·쪽 나눔은 잘 살아났지만, 글꼴과 테두리 두께, 칸 너비는 원본과 달랐습니다. 원본을 복제한다기보다 비슷한 새 문서를 만든다고 생각하시는 것이 정확합니다.

Q. 스캔한 PDF(이미지 PDF)도 되나요?

이번에는 시험하지 않았습니다. 글자가 선택되는 PDF로만 시험했으니, 스캔본은 직접 확인이 필요합니다.

Q. 한글 프로그램이 없으면 결과를 어떻게 여나요?

한컴 안내에 따르면 한글 2010 버전부터 .hwpx를 지원합니다. 한글이 없다면 오픈소스 편집기 HOP(macOS·Windows·Linux)으로 열어 볼 수 있습니다. HOP의 Windows판은 아직 서명되지 않아 실행할 때 보안 경고가 뜰 수 있습니다.

Q. 무료 플랜에서도 쓸 수 있나요?

Claude 공식 도움말에 따르면 스킬은 Free 플랜을 포함한 모든 플랜에서 쓸 수 있습니다. 단, 코드 실행이 켜져 있어야 합니다.

9. 정리

• 순서는 코드 실행 켜기 → hwpx 폴더 ZIP 만들기 → 업로드 → 파일 첨부 후 요청입니다.
• 자동 변환만으로는 부족했고, AI가 결재란·표·번호 같은 구조를 다시 잡아 만들 때 실무에 쓸 만한 결과가 나왔습니다.
• 원본과 똑같지는 않으니, 결과는 꼭 직접 열어 확인하고 개인정보와 보안 규정을 챙겨 주세요.

한글 문서를 자주 다루는 직장인이라면 반복되는 문서 옮기기 작업을 줄이는 데 도움이 될 수 있습니다.

참고 자료

• airmang/hwpx-plugins 저장소 README·SKILL.md (2026.10.17 열람) – https://github.com/airmang/hwpx-plugins
• Claude 도움말 "Use Skills in Claude" (2026.10.17 열람) – https://support.claude.com/en/articles/12512180-use-skills-in-claude
• Claude 도움말 "Create and edit files with Claude" (2026.8.6 업데이트) – https://support.claude.com/en/articles/12111783-create-and-edit-files-with-claude
• 한컴 다운로드 센터 "HWP·OWPML 문서 형식 공개" – https://www.hancom.com/support/downloadCenter/hwpOwpml
• 바이라인네트워크 "아래아한글, HWP 아닌 HWPX로 저장된다" (2021.4.15) – https://byline.network/2021/04/15-117/
• golbin/hop 저장소 README (2026.10.17 열람) – https://github.com/golbin/hop
• 직접 시험 기록 (2026.10.17, hwpx 스킬 엔진을 맥에서 직접 실행)