<h1 align="center">claw-hwp</h1>

<p align="center"> 한글 문서(<b>.hwp · .hwpx</b>)를 <b>Claude · Codex로</b> 읽고 · 만들고 · 고치는 도구<br/> 한컴오피스가 없어도, 코딩을 몰라도 됩니다. </p>

<p align="center"> <img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/DoHyun468/claw-hwp/main/.github/traffic-summary.json" alt="Clones (14-day)" /> <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT" /></a> </p>

<p align="center"> <strong>한국어</strong> · <a href="README_EN.md">English</a> </p>

---

## 이게 뭔가요?

회사에서 한글(.hwp) 문서, 많이 쓰시죠? 보고서·공문·계획서·표가 잔뜩 든 서식들요.

`claw-hwp`를 설치하면 **Claude·Codex 같은 AI에게 한국어로 말하듯 시키기만 하면** 한글 문서를 직접 읽고, 새로 만들고, 고쳐 줍니다.

> - "이 보고서 표에서 매출 칸을 120억으로 바꿔줘" > - "제목은 파란색 굵게, 본문은 맑은 고딕으로 해줘" > - "이 문서 본문을 2단으로 나눠줘" > - "표 하나 만들고 꼬리말에 쪽번호 넣어줘"

이렇게 말하면 됩니다. 결과 파일은 **한컴오피스나 한컴독스(한글 웹)에서 그대로 열립니다 — 안 깨져요.**

한컴오피스 · LibreOffice · 윈도우 전용 프로그램 — **아무것도 필요 없습니다.**

## 누구를 위한 건가요?

- 한글(.hwp) 문서를 자주 다루는 **회사원 · 공무원 · 실무자** - Claude Code / Codex 등 AI 에이전트를 쓰는 분 - **코딩을 몰라도 됩니다** — 한 번 설치하고, 말로 시키면 돼요.

---

## 뭐가 되나요?

한글 문서에서 자주 쓰는 기능을 기준으로, **지금 되는 것(✅)** 을 정리했어요.

### 📖 읽기 - ✅ 문서 내용 · 표 · 정보 읽어 오기 - ✅ 표 안 셀 내용까지 통째로 뽑아 보기

### ✍️ 글자 꾸미기 - ✅ 굵게 · 기울임 · 밑줄 · 취소선 - ✅ 형광펜 · 글자색 - ✅ 글자 크기 · 글꼴(폰트) - ✅ 위 첨자 · 아래 첨자 - ✅ 자간(글자 사이 간격) · 장평(글자 폭) - ⬜ 외곽선 · 그림자 · 강조점

### 📐 문단 꾸미기 - ✅ 정렬 (왼쪽 · 가운데 · 오른쪽 · 양쪽 · 배분 · 나눔) - ✅ 줄 간격 - ✅ 들여쓰기 · 왼/오른쪽 여백 · 문단 위아래 간격 - ✅ 문단 배경색 - ✅ 글머리표 · 문단 번호 · 수준 올리기/내리기

### 📊 표 - ✅ 표 만들기 - ✅ 셀 내용 입력 · 바꾸기 - ✅ 셀 배경색 · 테두리 · 대각선 - ✅ 셀 합치기 · 나누기 - ✅ 줄/칸 추가 · 삭제 - ✅ 셀 너비·높이 같게 · 세로 정렬 - ✅ 표 머리행 색 · 셀 여백 · 표 크기 · 쪽 넘는 표 경계선

### 🧩 넣기 - ✅ 그림(이미지) - ✅ 도형 (사각형 · 타원 · 선 · 호) - ✅ **차트 — 20종** (막대 · 꺾은선 · 원 · 도넛 · 3D 등) + 행/열 데이터 직접 지정 + **문서 테마색 자동 적용** - ✅ 글상자 - ✅ 수식 - ✅ 문자표(특수기호) - ✅ 각주 · 미주 - ✅ 누름틀(입력 양식) · 하이퍼링크 · 책갈피 - ✅ 문단 띠 - ✅ **서명 · 날인** (도장 · 서명을 서명란에 얹기 — 줄에 맞춰 정확히, 표/페이지 안 키움) - ✅ **개체 배치** (글 앞으로 · 어울림 · 자리차지 · 글 뒤) + 위치 · 크기 · 선 · 채우기 조절 - ✅ **개체 삭제** (그림 · 도형 · 차트 · 표 · 수식 지우기) - ⬜ 메모 *(저