최근 바이브코딩에 빠져있습니다.

클로드 코드로 작업을 하고 있는데..최근 한글 파일 작성할 일이 많이 생기다 보니.

pptx, Excel은 클로드나 다른 프로그램에서 만들고 편집이 되는데..왜 한글은 안될까 ? 라고 생각해보니.

1) 한글은 한국에서만 쓴다.

2) 한컴이 오픈소스에 적극적일 이유가 없다.

3) 공공기관은 한글을 쓰지만, 개인들은 적절히 다른 방법(?)으로 한글을 설치해서 쓰고 있다.

4) AI(클로드, Chatgpt, gemini) 에서 한글 파일 만드는거에 관심도 없다..너무 한국적이라서.

2번 문제는 파이썬 오픈소스를 횔용..4번은 클로드 스킬로 만들어서 AI + 한글파일 만들기를 만들어 봤습니다.

LLM 이랑 붙여서 "이 양식 채워줘" 한 마디로 끝내는 게 진짜 목적입니다.                                                                                                       

  ━━━ 1. 양식 채우기 — 3줄이면 끝 ━━━━━━━━━━━━━━━━ 

    pip install pyhwpxlib                                          

    pyhwpxlib template add 검수확인서.hwpx --name 검수서

    pyhwpxlib template fill 검수서 -d data.json -o 결과.hwpx

  표 안 셀이든 라벨 옆 빈칸이든 알아서 찾아 넣습니다. 30개 일괄도 됩니다. 

  ━━━ 2. Claude Code 스킬 ━━━━━━━━━━━━━━━━━━━━━━━━      

  라이브러리 사용법 외울 필요 없이 한국어로 말하면 됩니다.                               

  설치 — Releases 페이지에서 hwpx-skill-0.18.3.zip 다운로드 후 압축 풀기:    

    https://github.com/ratiertm/hwpx-skill/releases/tag/v0.18.3                                     

    → ~/.claude/skills/hwpx/ 에 풀고 Claude Code 재시작            

    "이 양식 채워줘. 회사명 ABC, 담당자 홍길동, 일자 오늘"                                          

    "5월 보고서 만들어줘. 표는 분기별 매출이랑 비용 비교."                                          

    "공문 기안문 작성해줘. 수신은 OO과, 제목은 XX 안내."                                            

                                                                                                    

  스킬이 양식 분석 → 데이터 매핑 → 채우기 → 미리보기 PNG까지 보여주고,                              

  "5번째 칸 안 채워졌는데 다시 할까요?" 정도까지 합니다 (과장 아님).                                                                                           

  행정안전부 「2025 행정업무운영 편람」 준수 공문 자동 생성도 들어있어요.  

  ━━━ 3. ChatGPT/Cursor 등 다른 LLM — MCP 연결 ━━━━━━         

  MCP 표준 지원 클라이언트면 한 줄 설정으로 붙습니다 — Claude Desktop /                             

  Cursor / Cline / Continue.dev / Goose / Zed 등.

    pip install 'pyhwpxlib[mcp]'                                   

  클라이언트 설정 (예: Claude Desktop의 claude_desktop_config.json):                                

   

    {                                                                                               

      "mcpServers": {                                              

        "hwpx": {                        

          "command": "python",

          "args": ["-m", "pyhwpxlib.mcp_server"]

        }                                                                                           

      }

    }                                                                                               

                                                                   

  이러면 LLM이 hwpx 도구를 직접 호출해서 양식 채우기·문서 생성·미리보기를                           

  처리합니다. (ChatGPT Desktop 은 OpenAI Connectors 통한 별도 등록 필요)

  ━━━ 그 외 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━   

  마크다운/HTML → .hwpx, .hwp → .hwpx (한컴 없이), 보고서·제안서 처음부터                           

  만들기, 표 자동 페이지 넘김, 한글 폰트 깨짐 자동 처리 등.

  ◆ 링크                                                                                            

                                                                   

    PyPI:    https://pypi.org/project/pyhwpxlib/                                                    

    GitHub:  https://github.com/ratiertm/hwpx-skill

    Releases: https://github.com/ratiertm/hwpx-skill/releases                                       

                                                                   

  설치하다 막히시면 댓글에 문의 에러 메시지 남겨주세요.  

  저는 맥 + 파이썬 + VS code + Claud code로 만들었고,  맥+클로드 데스크탑, 윈도우+클로드데스크탑만 테스트를 해봐서..

  다른 AI LLM 은 잘 동작이 안될 수 있습니다. 참조하세요.