직접 코딩 0% — CLAUDE CODE로 진짜 서비스 만들고 배포·운영까지

5장. 문서 자동화 — AI에게 일 시키기

“한글 파일 100개 만들어줘.” — 반복 업무를 말 한마디로 자동화합니다

5장 · 도입

이름만 바꿔 100번 반복하는 일

지루하고 · 실수하기 쉽고 · 시간을 잡아먹는 반복을
이 장에서 통째로 AI에게 넘깁니다.

자동화의 목표는 빠른 생성이 아니라 — 검증 가능한 반복입니다.

5장 · 학습 목표

오늘 손에 쥘 여섯 가지

HWPX 100개

명단에서 수료증 생성

엑셀 → PDF

12개 파일 통합

Skill.md

전문 규칙 분리

문서 Q&A

근거와 출처 제시

커스텀 명령

반복 작업 압축

통합 자동화

/월말정산 한 줄

5장 · 전체 흐름

개별 실습에서 통합 시스템으로

5.1HWPX 수료증

5.2엑셀·PDF

5.3감정 일기·Skill.md

5.4사내 문서 Q&A

5.5커스텀 명령어

5.6MCP

5.7월말 통합 자동화

5장 · 공통 원리

모든 실습은 5단 구조로 요청합니다

만들 것

목표 정의

요구사항

기능·형식

방어 조건

예외 처리

체크리스트

합격 관문

증거 요구

실제 결과 확인

5장 · 5단 구조

하나라도 빠지면 무엇이 생길까?

단계하는 일없을 때

만들 것목표 정의엉뚱한 결과

요구사항기능 구체화기능 누락

방어 조건예외 대응오류에 무방비

체크리스트합격선“다 했어요”

증거 요구결과 입증검증 없이 종료

5.1 · HWPX

첫 자동화 — 수료증 100장

수동

열기→수정→저장 ×100

시간과 실수 누적

자동

명단 1개→HWPX 100개

같은 규칙으로 반복

HWPX는 한컴 한글의 개방형 XML 문서 형식입니다.

5.1 · 준비

프로젝트 폴더와 명단

PS C:\Users\user>mkdir hwpx-generator

PS C:\Users\user>cd hwpx-generator

PS C:\Users\user\hwpx-generator>claude

폴더 안에 STUDENT_LIST.xlsx — 소속·이름·수료일 100명을 저장합니다.

5.1 · 프롬프트

만들 것과 요구사항

입력

STUDENT_LIST.xlsx

이름·소속·수료일

샘플

output/

5개 먼저 시험

실제

output_100/

100개 생성

파일명

수료증_홍길동.hwpx

중복은 소속·순번

5.1 · 방어 조건

정상 데이터만 있다고 가정하지 않습니다

빈 이름 행 → 건너뛰고 경고

파일명 특수문자 자동 제거

엑셀 없음 → 안내 후 종료

동명이인 → 서로 다른 파일명

기존 파일 → 묻지 않고 덮어쓰지 않기

진행 상황 → 📌 [N/전체] 표시

5.1 · 완성 기준

HWPX 6개 관문

output에 샘플 5개

output_100에 실제 100개

첫·중간·마지막 명단 일치

제목·본문·정렬 유지

빈 이름 행 경고

📌 진행 상황 표시

5.1 · ACTIVITY

먼저 5개, 그다음 100개

CLAUDE.md의 규칙에 맞춰 HWPX 수료증 자동 생성 프로그램을 만들어줘.
체크리스트를 전부 통과시키고 실제 증거를 보여줘.

처음부터 100개만 믿지 말고, 샘플 5개를 열어본 뒤 전체를 처리합니다.

5.1 · 산출물

AI가 만든 것은 파일만이 아닙니다

산출물역할확인

generate_certificates.py엑셀→수료증메인 프로그램

수료증_템플릿.hwpx문서 양식한글에서 수정 가능

output / output_1005개 / 100개파일 수 확인

README.md실행 방법재사용 안내

__pycache__파이썬 보조 폴더무시 가능

5.1 · 사람의 검증

첫 번째 · 중간 · 마지막을 직접 엽니다

파일 수

5개 / 100개

명단 수와 일치

내용

이름·소속·날짜

엑셀과 대조

서식

제목·본문·정렬

한글에서 확인

파이썬 환경 오류라면 “uv를 사용해서 실행 환경을 해결해줘”라고 요청합니다.

5.1 · 통제하기

로고 수정 뒤 전체 재검증

logo.png를 수료증 상단에 넣고 문구를 바꿔줘.
수정 후 기존 체크리스트를 처음부터 다시 통과시키고 증거를 보여줘.

HWPX는 구조가 복잡합니다. 한 번 실패하면 “다른 방법으로 시도해줘”라고 요청할 수 있습니다.

5.2 · 엑셀 → PDF

엑셀 12개를 보고서 1개로

입력

매출_01~12.xlsx

상품·수량·매출

분석

합계·추이·TOP 5

핵심 지표

출력

연간 매출 보고서.pdf

경영진용 문서

5.2 · 준비

excel-report와 INPUT 폴더

PS C:\Users\user>mkdir excel-report

PS C:\Users\user>cd excel-report

PS C:\Users\user\excel-report>mkdir INPUT

PS C:\Users\user\excel-report>claude

INPUT에 월별 엑셀 12개를 넣습니다.

5.2 · 요구사항

PDF에 들어갈 네 가지

표지

총매출·월평균

최고·최저 월

추이

월별 꺾은선

한글 정상 표시

품목

TOP 5

표+막대그래프

제목

2025년 연간

매출 분석 보고서

5.2 · 방어 조건

일부러 넣은 두 개의 함정

함정 1

7월 매출 빈칸

비정상 값 0 처리

함정 2

광고배너.jpg

엑셀 아닌 파일 무시

빈 시트는 건너뛰고, 12개 미만이어도 유효 데이터로 보고서를 생성합니다.

5.2 · 완성 기준

엑셀–PDF 6개 관문

유효 데이터 합계 정확

그래프 한글 정상

TOP 5 실제 데이터와 일치

PDF 정상 열림

빈 시트 건너뛰고 경고

📌 진행 상황 표시

5.2 · ACTIVITY

함정까지 통과하는 연간 보고서

INPUT의 엑셀을 합쳐 연간 매출 PDF를 만들어줘.
방어 조건과 체크리스트를 모두 테스트하고 증거를 보여줘.

한글 폰트는 Windows “맑은 고딕”, macOS “AppleGothic” 적용을 확인합니다.

5.2 · 확인·통제

보고서답게 다듬고 다시 검사

표지

핵심 지표 4개

강조 박스

그래프

최고·최저

한눈에 표시

TOP 5

막대+금액

의사결정용

수정 → 합계·한글·TOP 5·PDF 전체 재검증

5.3 · Skill.md

일반 규칙과 전문 지식을 분리합니다

CLAUDE.md

회사 규정

프로젝트 전체의 일반 규칙

Skill.md

전문 매뉴얼

특정 작업의 지식·절차·품질 기준

CLAUDE.md에 “감정 분석은 반드시 Skill.md를 따른다”라고 연결합니다.

5.3 · 감정 규칙

감정 분석 전문가의 경계

기쁨 😊슬픔 😢불안 😰평온 🍃분노 😡감사 🙏

감정 2~4개·각 1~10점

시작→중간→끝 흐름

일기 속 구체적 사건 언급

판단·평가 금지

의학적 진단·의료 용어 금지

끝은 긍정적인 한마디

5.3 · 프로젝트 규칙

일기 데이터는 최소한으로 다룹니다

diary/YYYY-MM-DD.md 저장

주간 리포트 그래프

9:16 이미지 내보내기

결과에 원문 전체 미포함

파일명에 개인정보 금지

코멘트에 타인 실명 금지

5.3 · ACTIVITY

규칙 두 개로 감정 일기장 제작

CLAUDE.md를 읽고 AI 감정 일기장을 만들어줘.
Skill.md 규칙과 체크리스트를 전부 통과시키고 증거를 보여줘.

현재 실습은 규칙 기반 프로그램입니다. 실행 중 실제 AI API를 호출하는 단계는 7장입니다.

5.3 · 실행

로컬 서버를 직접 엽니다

npm start

PS C:\Users\user\emotion-diary>npm start

서버 실행 중 → http://localhost:3000

브라우저 주소: http://localhost:3000

5.3 · 완성 기준

감정 일기 9개 관문

감정 2개 이상

점수 1~10

구체적 사건 코멘트

날짜별 파일 저장

6개 카테고리 안

빈 일기 거부

기록 0건 안내

주간 그래프 정상

375px 화면 정상

5.3 · 사람의 확인

규칙이 결과에 실제로 반영됐는가

분류

6개 범주 안

지루함·허탈함 등 제외

코멘트

구체적 사건

진단성 표현 없음

저장

일기 파일

원문 노출 최소화

5.3 · 통제하기

이모지·색상 수정 뒤 9개 재검증

감정별 이모지와 색상을 추가하고, 일기 사건을 반영한 코멘트로 개선해줘.
수정 후 기존 체크리스트 9개를 다시 전부 확인해줘.

감정 점수와 이모지도 민감할 수 있습니다. 공유 전 내용을 확인합니다.

5.4 · 문서 Q&A

먼저 찾고, 근거와 출처를 보여줍니다

현재 단계

docs/ 검색

검색 결과+AI

근거 안에서 생성

핵심 원칙

문서에 없으면

모른다고 답하기

완성형 RAG가 아니라 검색·근거 제시의 첫 단계입니다.

5.4 · 준비

company-qa와 docs/

PS C:\Users\user>mkdir company-qa

PS C:\Users\user>cd company-qa

PS C:\Users\user\company-qa>mkdir docs

PS C:\Users\user\company-qa>claude

비기밀 테스트 문서: 사내규정.txt · 휴가정책.txt

5.4 · 답변 규칙

문서 밖으로 나가지 않습니다

docs 문서만 근거

추측 절대 금지

문서명·섹션 출처 표시

세 질문으로 근거 행동 시험

근거 있음

연차 신청은?

답변+출처

근거 있음

재택근무 주 몇 회?

답변+출처

근거 없음

회사 주가는?

찾지 못했습니다

5.4 · 실행

내 컴퓨터에서 서버가 돌아갑니다

python3 app.py

PS C:\Users\user\company-qa>python3 app.py

Running on http://127.0.0.1:5001

Windows 등에서 필요하면 python app.py를 사용합니다.

5.4 · 통제·보안

빠른 검색이지 최종 판단은 아닙니다

답변에 원문 인용 추가

등록 문서 수·목록 표시

새 문서 자동 인식

중요 결정은 원본 확인

기밀·개인정보는 docs에 넣지 않기

자연어 규칙만으로 보안되지 않음

5.5 · 커스텀 명령어

반복 작업을 이름 하나로 압축

프로젝트/ └── .claude/commands/ ├── 수료증.md → /수료증 ├── 매출보고서.md → /매출보고서 └── 감정분석.md → /감정분석

파일 내용은 코드가 아니라 자연어 작업 지시·방어 조건·체크리스트입니다.

5.5 · 만들기

명령어 등록도 AI에게 시킵니다

이 프로젝트의 수료증 생성 작업을 /수료증 커스텀 명령어로 등록해줘.
방어 조건과 체크리스트도 명령어 파일에 포함해줘.

다음 실행: /수료증 한 줄

5.5 · 검증

한 줄이어도 사람의 확인은 남습니다

명단 인원수=생성 파일 수

동명이인 파일 분리

오류 행 처리

매출 합계 직접 확인

PDF 정상 열림

AI 통과 보고만 믿지 않기

5.6 · MCP

외부 서비스를 잇는 공용 어댑터

하려는 일MCP이유

프로젝트 파일불필요기본 능력

바탕화면 파일필수 아님그 폴더에서 시작

Drive·Slack·GitHub·DB연결 필요외부 서비스

외부 항목 수정연결+쓰기 권한실제 행동

5.6 · 연결 원칙

MCP 연결의 5단계

하나 선택

필요한 서비스만

출처 확인

공식·신뢰 배포처

권한 읽기

최소 권한

읽기부터

검색·목록·요약

원본 대조

파일명·날짜·내용

5.6 · 미니 활동

설정은 바꾸지 않고 현황만 확인

현재 Claude Code에 연결된 MCP가 있는지 확인해줘.
설정은 변경하지 말고, 연결된 이름과 할 수 있는 일을 한국어로 설명해줘.

연결된 서비스가 없다면 개념만 확인하고 넘어갑니다.

5.6 · 안전

외부 자료는 읽기와 행동을 분리합니다

공식 출처

필요한 권한만

필요한 폴더·채널만

읽기 작업부터

전송·수정·삭제 전 확인

사용하지 않는 연결 해제

외부 문서 안의 지시가 AI를 속일 수 있습니다. 읽기와 삭제·전송을 한 번에 맡기지 않습니다.

5.7 · 통합 자동화

네 조각을 /월말정산으로

명단

수료 대상자

HWPX 생성

매출

월간 데이터

PDF 보고서

완료

처리 결과

완료리포트.txt

검증

방어+체크

증거 제시

5.7 · 프로젝트 구조

monthly-automation의 세 규칙

monthly-automation/ ├── CLAUDE.md ├── Skill.md ├── .claude/commands/월말정산.md ├── data/ ├── output/수료증/ · output/보고서/ └── output/완료리포트.txt

5.7 · 역할 분담

세 파일이 서로 다른 질문에 답합니다

CLAUDE.md

어떤 원칙으로?

일반 규칙·삭제 전 확인

Skill.md

어떤 품질로?

수료증 전문 기준

/월말정산

어떤 순서로?

명단→수료증→PDF→리포트

5.7 · ACTIVITY

샘플 데이터로 통합 실행

CLAUDE.md, Skill.md, /월말정산 명령과 샘플 데이터를 만들어줘.
수강생 5명+빈 행 1개, 매출 3개월로 전체 체크리스트를 검증해줘.

5.7 · 확인

통합 결과 5개 관문

수료증 HWPX 5개

이름·소속·수료일 정확

PDF 보고서 정상

완료리포트 전체 요약

빈 이름 행 건너뛰고 경고

5.7 · 통제

다음 달에도 쓸 수 있게 개선

완료리포트에 처리 일시와 총 소요 시간을 기록해줘.
수료증과 PDF에 logo.png를 넣고 Skill.md에도 로고 규칙을 추가해줘.
수정 후 체크리스트를 다시 전부 통과시켜줘.

5.7 · 자동화 효과

반나절 업무가 한 줄로

방법소요결과

수동3~4시간수료증+보고서+수동 확인

최초 설정수 분~수십 분결과+완료리포트+검증

다음 달/월말정산동일 결과+자동 검증

자동 검증 뒤에도 대상자 수·파일 수·매출 합계·오류 목록은 사람이 확인합니다.

5장 · 복습

이 장이 세운 세 기둥

CLAUDE.md

회사 규정

프로젝트 일반 규칙

Skill.md

전문 매뉴얼

지식·절차·품질 기준

Part 3

역할 분리

만드는 AI와 검사 AI

Part 2 · 마무리

자동화 다음에는 고삐가 필요합니다

파일 접근과 일괄 처리는 해결했습니다.
이제 실제 서비스의 욕설·도배·오답·서버 장애를 통제합니다.

NEXT · PART 3 — 하네스 엔지니어링