정책과제 딸깍 — 사용설명서

경북연구원 정책과제 보고서를 Claude Code로 집필하고, 경북연구원 양식 한글(.hwpx)까지 내 PC에서 완결합니다.

전체 흐름

① 집필 환경 만들기(처음 한 번) → ② 집필 + 로컬 변환(Claude Code) → ③ 마무리(한글)

기획·자료조사·집필·감수·HWPX 변환·조판이 전부 내 PC에서 돌아갑니다(품질·환각방지 하네스 가동). 원고를 어디에도 업로드하지 않습니다.

① 집필 환경 만들기 (처음 한 번)

Git for Windows 설치 — git-scm.com/downloads/win 에서 받아 기본값으로 설치. (데스크탑 앱이 첫 실행 때 필요 — 안 깔면 앱이 못 켜집니다)
Claude Code 데스크탑 앱 설치 — claude.ai/download 에서 Windows x64 설치 파일(.exe)을 받아 더블클릭.
앱 실행 → 로그인 — Claude Pro/Max(또는 회사 Team/Enterprise) 계정으로 로그인. 무료 계정은 불가. 한 번 로그인하면 다음부터 자동.
Node.js 18+ 설치 — nodejs.org 에서 LTS. HWPX 변환·조판 엔진 구동용. 설치 후 새 명령창에서 node -v 확인.
(그림용) Python 3 설치 — python.org 에서 설치 시 'Add Python to PATH' 체크 → 새 명령창에서 pip install pymupdf. 참고문헌 PDF의 원본 도표 추출·삽입과 렌더 검증용.
집필 패키지 받기 + 풀기 — 메인 화면의 「집필 패키지 (.zip)」을 받아, 작업 폴더(예: 문서\GDI보고서)에 압축을 풉니다.
앱에서 폴더 열기 — 앱의 Code 탭 → + New session → Project folder에서 방금 그 폴더를 선택. Environment는 Local(기본값) 유지.

압축 풀기가 어렵다면 — 앱에서 빈 폴더를 열고, 채팅 입력창의 + 버튼(또는 드래그앤드롭)으로 패키지 zip을 첨부한 뒤 "이 패키지 설치해줘"라고 입력하세요.

② 보고서 집필 + 변환 (앱 채팅창)

작업 폴더를 연 뒤 채팅창에서 작업합니다. 슬래시 명령과 자연어 대화 두 가지 다 됩니다.

방법 1 — 슬래시 명령 (정확)

/ 를 치면 사용 가능한 명령이 자동완성으로 보입니다.

/gdi-plan 경상북도 ○○ 도입 및 활성화 방안
/gdi-research              ← 또는 sources 폴더에 자료를 직접 넣기
/gdi-chapter 1            ← 마지막 장까지 2, 3, 4, 5 …
/gdi-finalize

방법 2 — 자연어로 대화 (편함)

슬래시 명령이 어색하면 그냥 한국어로 말해도 됩니다. Claude가 알맞은 단계(기획·자료조사·집필·감수)를 알아서 실행합니다.

"경상북도 ○○ 도입·활성화 방안 보고서 기획해줘"
"자료 조사해줘"  ·  "2장 현황 부분 써줘"  ·  "4장 정책 써줘"
"감수해줘"  ·  "최종본 만들어줘"

슬래시 명령은 정확한 단계 지정용 단축키일 뿐입니다. 자연어로 말해도 내부적으로 같은 기획·집필·감수 단계가 돌아가며, 환각 방지 하네스도 똑같이 작동합니다.

/gdi-finalize(또는 "최종본 만들어줘")가 요약·참고문헌·조립에 이어 내 PC에서 변환·조판까지 수행해 output\report_최종.hwpx 를 만듭니다(표지·목차·간지·쪽번호·참고문헌 박스·뒷표지 포함, 용지 190×260mm).

팁 — 각 단계가 끝나면 Claude가 [확인요망] 항목(미검증 수치·서지 등)을 보고합니다. 검토 후 다음 단계로 넘어가세요.

③ 한글에서 마무리

output\report_최종.hwpx 를 한글로 열고:

[도구] - [차례/색인] - [차례 만들기] → 목차·표/그림목차의 쪽번호(000) 자동 채움
표지의 [확인요망](연구진·발간정보) 직접 채우기
PDF 내보내기 시 용지를 '문서 크기(190×260)' 로 지정(기본 A4면 내용이 좌상단에 배치됨)

그림 넣기

종류	방법
참고문헌 원본 도표	집필·최종화 중 Claude가 `sources/` PDF에서 본문 논거와 직결되는 도표를 자동 발굴·추출해 HWPX에 임베드(Python+PyMuPDF 설치 시). 출처·쪽번호는 자료주와 출처 대장에 기록됩니다.
모식도·개념도·예시도	Claude가 만들어 준 `※ 이미지 생성 프롬프트`를 복사 → GPT Image / Nano Banana로 생성 → 한글의 `[그림]` 자리에 삽입
데이터 그래프	Claude가 제시한 표를 딸깍 개발실 차트 딸깍에 넣어 차트 생성 → 삽입

주의 — 데이터·수치 그림을 이미지 AI로 만들지 마세요(막대·숫자를 지어내고 한글 라벨이 깨집니다). 데이터는 반드시 표 → 차트 딸깍으로.

자주 묻는 것

저장할 때 "[GDI 하네스 검토 요망]" 메시지가 떠요

오류가 아니라 자동 검증 안내입니다 — 출처 없이 단위 수치가 쓰인 줄을 짚어 줍니다(보조 검증 훅). 이미 출처 대장에 있으면 무시하고, 아니면 [확인요망] 등을 붙이세요. 집필은 그대로 진행됩니다.

HWPX 변환이 실패해요

새 명령창에서 node -v 가 18 이상인지 확인하세요. 그림 추출이 안 되면 pip install pymupdf 여부를 확인하세요(설치 후 명령창을 새로 열어야 PATH가 갱신됩니다). 그래도 안 되면 채팅창에 "변환 오류 원인 찾아줘"라고 요청하거나 관리자에게 문의.

왜 표지 연구진이 비어 있나요

고유명사 날조 방지 원칙상 [확인요망] 으로 둡니다. 한글에서 확정값으로 교체하세요.

← 정책과제 딸깍으로 돌아가기