AI가 한글 문서를 못 한다는 말은 이제 틀렸다 — 2026년 10월 도구 지도
품앗이가 2026년 10월 28일 깃허브를 다시 뒤져 고른 한글 문서 도구와, 한 지역자활센터 서버에 실제로 깔아 시험한 기록입니다. 묶음 전체는 한글 문서를 AI로 다루기에 있습니다.
한 줄
클로드 같은 AI에게 한글 파일을 맡겼는데 「이 형식은 다룰 수 없습니다」라는 답이 돌아온다면, AI가 못 하는 것이 아니라 그 AI 옆에 도구가 없는 것입니다. 한국 개발자들이 만든 오픈소스 세 개를 깔면 읽기, 고치기, 새로 만들기, 그려서 확인하기가 한컴오피스 없이 됩니다.
왜 다시 썼나
한 지역자활센터 실무자가 자기 AI에게 한글 문서 작업을 시켰더니 못 한다는 답이 돌아왔습니다. 공공 서식과 행정 문서가 대부분 한글로 오는 한국 현장에서 이 한 문장은 작은 불편이 아닙니다. AI를 들인 뒤에도 사람이 문서를 손으로 옮겨 적게 되고, 「AI는 우리 일에는 안 맞는다」는 판단으로 이어집니다.
품앗이는 2026년 5월부터 여러 도구를 손으로 엮어 써 왔습니다. 이번에 검색어 열두 개로 깃허브를 다시 훑고 상위 후보 일곱 개의 코드를 열어 보니, 다섯 달 사이 우리가 엮어 쓰던 것보다 나은 도구가 나와 있었습니다. 그래서 기본 도구를 바꿨습니다.
고른 세 가지
| 도구 | 하는 일 | 만든 사람 | 라이선스 |
|---|---|---|---|
| kordoc | HWP 3·5, HWPX, PDF, 워드·엑셀을 마크다운으로 읽는다. 합친 표 칸까지 살린다. 두 문서 비교, 공문 새로 만들기, 서식 빈칸 채우기, 표기 검수, 개인정보 가리기도 된다. 명령줄과 MCP 서버로 쓴다 | chrisryugj | MIT |
| claw-hwp | 클로드와 코덱스에 붙이는 스킬이다. 받은 .hwp를 다른 형식으로 바꾸지 않고 그대로 고친다. 표 칸, 글꼴, 쪽번호, 도장 얹기가 되고, 개인정보를 AI가 보지 않게 채우는 흐름이 들어 있다 | DoHyun468 | MIT |
| rhwp | 한글 문서를 그림(PNG·SVG)으로 그리는 엔진이다. AI가 결과를 직접 보고 표가 깨졌는지 확인하게 한다. claw-hwp도 이 엔진을 안에 품고 있다 | Edward Kim | MIT |
셋 다 Node.js만 있으면 리눅스, 맥, 윈도에서 돕니다. 코드를 열어 확인한 범위에서 문서를 바깥 서버로 보내는 부분은 없었습니다. kordoc가 사진 글자 인식(OCR)을 처음 쓸 때 인식 모델을 내려받는 것이 유일한 바깥 통신이었습니다.
쓰지 않기로 한 것도 적어 둡니다. 한컴오피스를 원격으로 조종하는 방식의 도구는 윈도에 한컴오피스가 깔려 있어야만 돌아서 서버용으로는 뺐습니다. 지난 기록에서 비상업 전용이라고 적었던 python-hwpx는 지금 판에서 Apache-2.0 라이선스로 바뀌었습니다.
실제로 깔아 보니
2026년 10월 28일 한 지역자활센터의 우분투 서버에 셋을 깔고, 실무자 계정으로 시험했습니다.
- 읽기: 공모 신청서 .hwp를 kordoc로 읽었습니다. 칸을 합친 표가 표 모양 그대로 나왔습니다.
- 고치기: claw-hwp로 신청서 표의 빈칸 두 곳을 채웠습니다. 파일은 .hwp 그대로 남았고, rhwp로 그려 보니 글자가 제 칸에 들어가 있었습니다.
- 새로 만들기: 마크다운으로 쓴 회의 안내를 kordoc로 공문 꼴 HWPX로 만들었습니다. 제목 띠와 표가 갖춰져 나왔습니다.
시험에서 걸린 것이 둘 있었습니다.
- 본문 글자를 찾아 바꾸는 기능은 표 칸 안으로 들어가지 않습니다. 바꿀 글자가 표 안에 있으면 「0건 바꿈」으로 끝납니다. 신청서 문장은 대개 표 안에 있으니 표 칸 고치기 기능을 써야 합니다.
- 「신청」 같은 칸 이름으로 칸을 찾는 기능은, 같은 글자가 다른 표에도 있으면 엉뚱한 칸을 잡고 실패했습니다. 문서의 표 칸 좌표를 먼저 뽑아 보고 좌표로 고치는 편이 확실했습니다.
현장에 까는 법
AI가 일하는 기계가 어디냐에 따라 두 길이 있습니다.
- AI가 서버나 리눅스 기계에서 일할 때: Node.js를 깔고
npm install -g kordoc, claw-hwp 저장소를 받아 스킬 폴더(~/.claude/skills/)에 연결하고, rhwp 배포 파일을 받아 명령으로 둡니다. 품앗이가 쓴 설치 스크립트는 여러 직원 계정에 한 번에 연결하는 데까지 들어 있습니다. - 클로드 데스크톱 앱에서 바로 쓸 때: claw-hwp는 앱의 플러그인 마켓플레이스에 저장소 주소를 넣으면 붙습니다. kordoc는
npx -y kordoc setup으로 MCP를 등록합니다.
깐 다음에는 AI가 읽을 지시문 한 장을 같이 둡니다. 품앗이가 쓴 지시문의 뼈대는 이렇습니다.
- 「한글은 못 한다」고 말하지 않는다. 막히면 어디서 무슨 오류로 막혔는지 그대로 보고한다.
- 원본은 건드리지 않는다. 사본으로 일하고 결과는 새 이름으로 저장한다.
- 다 됐다고 말하기 전에 rhwp로 그려서 직접 본다.
- 주민등록번호, 계좌번호처럼 밖으로 나가면 되돌릴 수 없는 값은 채우지 않고 사람에게 넘긴다.
- 마지막 확인은 사람이 한글 프로그램에서 연 화면이다.
한계
- AI가 그린 그림은 빠른 확인용이다. 한컴오피스와 똑같이 보인다는 보증은 아닙니다. 받는 쪽에 낼 문서는 한글 프로그램이나 한컴독스에서 한 번 열어 봅니다.
- 세 도구 모두 개인이나 작은 모임이 만들어 빠르게 바뀌고 있습니다. 판을 고정해 깔고, 올릴 때는 다시 시험합니다.
- 도구가 생겨도 문서 내용의 책임은 그 문서에 이름을 올리는 사람에게 있습니다. AI가 채운 숫자와 날짜는 사람이 대조합니다.
만든 사람들에게
이 글의 어떤 방법도 chrisryugj, DoHyun468, Edward Kim이 공개한 코드가 없었다면 없었습니다. 쓰다가 찾은 버그와 빠진 설명은 각 저장소에 돌려줄 기여 거리로 봅니다.
- kordoc: github.com/chrisryugj/kordoc
- claw-hwp: github.com/DoHyun468/claw-hwp
- rhwp: github.com/edwardkim/rhwp