목차
- 00이 책은 무엇을 약속하는가
- 01설치, 한 시간이면 끝난다
- 02첫 대화, 그리고 권한 창
- 03AI에도 종류가 있다
- 04챗봇과 무엇이 다른가
- 05첫 결과물, 자기소개 페이지 🔒
- 06고치는 법이 본론이다 🔒
- 07`CLAUDE.md`, 내 취향을 기억시킨다
- 08Skill이란 무엇인가
- 09품의서, 55분에서 7분으로
- 10결과가 틀렸을 때
- 11Skill을 열어서 뜯어보기 🔒
- 12설계 4단계: 관찰·쪼개기·입출력·매뉴얼
- 13PRD 먼저, 코드는 나중
- 14케이스 스터디 ①: YouTube 탐색 도구 🔒
- 15케이스 스터디 ②: 블로그 글쓰기 🔒
- 16내 업무로 옮기기 🔒
- 17Skill은 절차, Agent는 일꾼
- 18내 Skill을 Agent에 태우기 🔒
- 19API란 무엇인가
- 20크롬 확장 만들어보기 🔒
- 21실습 ①: 밴드 채팅 주문 집계 🔒
- 22실습 ②: 랜딩 페이지, 만들고 올리기 🔒
- 23실습 ③: 한달살기 매물 비교 🔒
- 24막혔을 때
- 25Chat과 Claude Code, 무엇을 어디서
- a설치 트러블슈팅
- bSkill 카탈로그 7종 🔒
- c작업 폴더 구조 🔒
- d단축키와 명령어 모음
- e용어 사전
Claude Code 품의서 자동화 · 업무 자동화용
품의서, 55분에서 7분으로
Claude Code 품의서 자동화 — 견적서 이미지 한 장을 결재용 품의서로. Skill 두 개(/img-to-docs · /approval-doc)로 55분 걸리던 일을 7분에, 왜 두 단계로 나눴는지까지.
9.1 오늘 돌릴 것
견적서 이미지 한 장 → 결재용 품의서 한 장.
쓸 Skill은 두 개입니다. 이미 만들어져 있습니다. 만드는 건 3부입니다.

두 단계입니다. 이 두 단계로 나눈 이유가 이 장의 진짜 주제입니다(9.5절).
9.2 준비 — 폴더 세 개
작업 폴더 안에 폴더 세 개를 만듭니다. Claude에게 시키면 됩니다.
이 폴더 안에 10_input, 20_extracted, 30_output 폴더를 만들어줘
| 폴더 | 무엇이 들어가나 |
|---|---|
10_input/ | 원본 — 견적서 이미지 |
20_extracted/ | 중간 결과 — 추출한 마크다운 |
30_output/ | 최종 결과 — 품의서 HTML |
💡 왜 번호를 앞에 붙일까
폴더 목록이 작업 순서대로 정렬되기 때문입니다.
input,extracted,output이라고만 쓰면 사전순(e → i → o)으로 섞여서, 뭐가 먼저인지 안 보입니다.사소해 보이지만 이런 게 나중에 크게 벌어집니다. 폴더 이름만 봐도 흐름이 읽히는 구조가 좋은 구조입니다.
견적서 이미지 넣기
10_input/ 에 견적서 이미지를 한 장 넣으세요.
⚠️ 회사 견적서를 쓰지 마세요
4.7절에서 말씀드린 대로, 읽힌 파일은 Anthropic 서버로 전송됩니다. 거래처 이름·단가·담당자 연락처가 들어 있는 진짜 견적서는 쓰지 마세요.
연습용으로는 가짜 견적서를 하나 만들면 됩니다. 인터넷에서 “견적서 양식” 을 찾아 아무 회사명·금액으로 채워 캡처하세요. 혹은 Claude에게 “연습용 가짜 견적서 이미지를 만들 HTML을 짜줘” 라고 해도 됩니다.
9.3 1단계 — /img-to-docs
입력창에 이렇게 칩니다.
/img-to-docs 10_input/
/ 를 치면 목록이 뜨니 거기서 골라도 됩니다.
권한 창이 여러 번 뜹니다. 읽기 → 쓰기 순입니다. 파일 이름을 확인하며 허용하세요.
나온 결과
20_extracted/ 에 마크다운 파일이 생깁니다. 열어보면 이런 모양입니다.
# 견적서 — sample-quote-1
## 메타 정보
- 문서번호: Q-2025-0412
- 발행일: 2025-04-12
- 발신: (주)디자인랩
- 수신: (주)월간상사
## 항목
| 품목 | 수량 | 단가 | 금액 |
|------|---:|---:|---:|
| 로고 디자인 | 1 | 1,500,000 | 1,500,000 |
| 명함 디자인 | 2 | 200,000 | 400,000 |
## 합계
- 소계 (VAT 별도): **1,900,000**
- 부가세 (10%): **190,000**
- 총 합계: **2,090,000**
## 🔍 검수 포인트
- [ ] 명함 디자인 단가가 흐릿함 ⚠️
- [ ] 합계와 항목 합산 일치 확인
맨 아래를 보세요. 검수 포인트가 붙어 있습니다.
여기서 반드시 하실 일
⚠️ 숫자를 눈으로 확인하세요. 지금.
3.3절에서 배웠습니다. AI는 숫자를 틀립니다. 특히 이미지에서 읽어낸 숫자는요.
원본 이미지를 옆에 띄우고, 금액 칸만 대조하세요. 1분이면 됩니다. 이 1분을 건너뛰면 틀린 금액이 그대로 품의서에 박혀서 결재까지 올라갑니다.
틀린 게 있으면 그냥 말하면 됩니다.
명함 디자인 단가는 200,000이 아니라 250,000이야. 고쳐줘
9.4 2단계 — /approval-doc
검수가 끝났으면 다음 단계입니다.
/approval-doc 20_extracted/sample-quote-1.md
30_output/ 에 HTML 품의서가 생깁니다. 브라우저로 열어보세요.
방금 만든 품의서를 브라우저로 열어줘
한국식 품의서 양식이 나옵니다. 제목, 오른쪽 위 결재선 박스, 항목 표, 합계, 비고.
결재선이 자동으로 정해졌습니다
품의서 위쪽에 결재선을 이렇게 정한 이유가 한 줄 적혀 있을 겁니다. 이 Skill에는 금액별 규칙이 들어 있습니다.
| 총액 | 결재선 |
|---|---|
| 100만 원 미만 | 팀장 |
| 100만 ~ 500만 원 | 팀장 + 본부장 |
| 500만 ~ 3천만 원 | 팀장 + 본부장 + 대표 |
| 3천만 원 이상 | + 이사회 별도 안건 |
이건 이 Skill을 만든 사람이 정한 규칙입니다. 여러분 회사 규정과 다를 겁니다. 3부에서 Skill을 직접 만들 때, 이 표를 여러분 회사 것으로 바꾸면 그대로 쓸 수 있습니다.
고쳐보기
6장에서 배운 그대로입니다. 만들어진 뒤에도 계속 고칩니다.
결재선에 본부장을 추가해줘
금액을 천 원 단위로 바꿔줘
제목 옆에 빨간색으로 [긴급] 표시 넣어줘
새 파일이 생기는 게 아니라 기존 파일이 고쳐집니다. 브라우저를 새로고침하며 확인하세요.
9.5 왜 한 번에 안 하고 두 번에 나눴나
이 장에서 제일 중요한 부분입니다.
“견적서 이미지 주면 품의서까지 한 방에” 가 더 편해 보입니다. 왜 굳이 중간에 마크다운 파일을 한 번 거칠까요?
세 가지 이유가 있습니다.
① 검수 지점을 만들기 위해
한 방에 가면, 틀린 숫자가 완성된 품의서에 박힌 채로 나옵니다. 그러면 사람은 잘 만들어진 문서를 보고 “잘 됐네” 하고 넘깁니다. 숫자를 다시 안 봅니다.
중간에 끊으면, 중간 결과를 볼 수밖에 없습니다. 9.3절에서 금액을 대조한 그 1분이 여기서 생깁니다.
📖 검수 지점(checkpoint)
자동으로 흘러가는 절차 중간에 일부러 만들어 둔 멈춤 자리. 사람이 결과를 확인하고 넘어가는 지점입니다.
자동화를 설계할 때 가장 많이 빠뜨리는 것이자, 사고를 가장 많이 막아주는 장치입니다.
② 재사용하기 위해
/img-to-docs 의 결과물은 품의서에만 쓰이는 게 아닙니다.

한 방짜리 Skill로 만들었으면 품의서 말고는 아무 데도 못 씁니다. 쪼개두면 앞부분을 계속 돌려 씁니다.
③ 고장 난 곳을 찾기 위해
결과가 이상할 때, 두 단계로 나뉘어 있으면 어디서 틀렸는지 바로 압니다.
- 마크다운이 이미 틀렸다 → 읽기(1단계) 문제
- 마크다운은 맞는데 품의서가 이상하다 → 양식(2단계) 문제
한 방이면 “뭔가 이상한데 어디가 문제지” 로 끝납니다.
💡 쪼개는 기준 — 이 책 전체의 사고법
쪼개는 이유 한 줄 검수 사람이 봐야 할 자리에서 끊는다 재사용 다른 데도 쓸 부분은 따로 뗀다 고장 추적 틀렸을 때 범인을 찾을 수 있게 12장 「설계 4단계」의 두 번째 단계가 이 쪼개기입니다. 15장에서는 블로그 글쓰기를 네 조각으로 쪼갠 사례를 봅니다. 지금 이 감각을 잡아두시면 3부가 훨씬 쉽습니다.
9.6 7분의 정체
처음 표를 다시 봅니다.
| 단계 | 사람이 하는 일 | 시간 |
|---|---|---|
| 1 | /img-to-docs 입력 + 권한 허용 | 30초 |
| 2 | 금액 대조 ⭐ | 2분 |
| 3 | /approval-doc 입력 | 30초 |
| 4 | 결재선·사유 확인 ⭐ | 2분 |
| 5 | 수정 요청 한두 번 | 2분 |
| 합계 | 약 7분 |
별표 두 개가 사람의 일입니다. 나머지는 기다리는 시간입니다.
55분에서 48분이 사라졌는데, 사라진 건 전부 옮겨 적기였습니다. 그리고 판단하고 확인하는 일은 그대로 남았습니다.
이게 이 책이 말하는 자동화입니다. 사람을 빼는 게 아니라, 사람이 사람만 할 수 있는 일에만 남게 하는 것.
9.7 🔁 혼자 해보기
- 견적서를 한 장 더 넣고
/img-to-docs 10_input/을 다시 돌리세요. 두 장이 한 번에 처리되는 걸 확인하세요 (4.5절의 그 이야기입니다) - 일부러 흐릿하거나 기울어진 이미지를 넣어보세요. 검수 포인트에 뭐라고 적히는지 보세요
/approval-doc에 폴더를 통째로 줘보세요 (/approval-doc 20_extracted/). 여러 견적이 한 장으로 합쳐집니다- 완성된 품의서를 인쇄 미리보기(
Ctrl + P)로 열어 A4 한 장에 들어가는지 확인하세요
2번이 중요합니다. AI가 자신 없어 할 때 어떻게 표시하는지 눈에 익혀두세요. 그 표시를 믿고 검수하게 됩니다.
9.8 정리
| 흐름 | 이미지 → (/img-to-docs) → 마크다운 → (/approval-doc) → 품의서 |
|---|---|
| 폴더 | 10_input/ → 20_extracted/ → 30_output/ |
| 쪼갠 이유 | 검수 · 재사용 · 고장 추적 |
| 7분의 정체 | 호출 1분 + 검수 4분 + 수정 2분 |
| 📖 검수 지점 | 일부러 만들어 둔 멈춤 자리 |
다음 장은 틀렸을 때 이야기입니다. 오늘은 잘 됐지만, 실제로는 자주 틀립니다. 그리고 틀린 걸 그대로 결재에 올리는 사고가 이 책에서 가장 걱정하는 일입니다.