말로 지시해 첫 업무 도구 만들기

오늘의 질문 — 무엇을 말로 지시하고, 무엇을 직접 확인할 것인가? 강사 한 줄 요약: "오늘은 CLAUDE.md, 내일은 스킬. 나머지는 명령어일 뿐."

#한눈에 보기

• 폴더가 중심 — 폴더 하나 = 업무(시스템) 하나
• CLAUDE.md = 프로젝트 수행 계획서, 매 대화마다 자동으로 읽힌다
• 지시는 역할 · 맥락 · 형식 · 제약 + 환각 방지 · 되묻기
• 검증은 출처 · 계산식 · 정량 기준으로, 최종 판단과 책임은 사람
• Day 1 완료 기준: 새 대화에서 커맨드 한 줄로 같은 결과가 나온다

#1. 바이브코딩 이해 (1-1)

#코드 대신 의도를 입력한다

만드는 사람의 일이 작성에서 지시와 확인으로 바뀐다. 그래서 업무를 아는 사람이 유리하다. 코드를 읽지 못해도 결과가 맞는지는 판단할 수 있어야 한다.

#사람이 넘기지 않는 세 가지

#잘 맞는 일 vs 주의할 일

• 잘 맞는 일 — 입력과 출력이 파일인 반복 업무: 자료 정리, 두 목록 대조, 정해진 형식의 회신 · 보고 초안, 혼자 쓰는 현황판
• 주의할 일 — 틀리면 피해가 큰 일: 외부 발송, 금액 확정, 개인정보, 여럿이 쓰는 운영 시스템 → 금지는 아니지만 초안까지만 맡기고 사람이 확정

#작동 원리 세 가지

모호한 지시는 틀린 답이 아니라 **"그럴듯한 답"**으로 돌아온다. 그래서 가장 찾기 어렵다.

#Claude Code의 구성

• 모델 — 다음에 할 일을 정함 (/model, /status). Opus · Sonnet · Haiku 등, 큰 모델일수록 어려운 판단에 강하고 사용량이 크다
• 내장 도구 — 파일 읽기/쓰기 · 검색 · 명령 실행 · 웹 조회 (화면의 Read · Write · Bash 줄)
• 지침 — CLAUDE.md와 설정이 모든 대화에 적용 (/memory, /permissions)
• 확장 기능 — Skill · MCP · 서브에이전트 (Day 2)

Claude가 모르는 것(업무 기준일 · 사내 규정 · 팀 관행)은 묻지 않고 추정할 수 있다 → CLAUDE.md에 적어 준다.

#2. 환경 구성 (1-2)

#웹 채팅 vs Claude Code(CLI)

→ 한 번 묻고 답하는 일은 웹 채팅, 반복 업무를 맡기는 일은 Claude Code.

#다섯 층 구조 — 문제가 생기면 ①부터 점검

무료 claude.ai 플랜으로는 Claude Code에 로그인할 수 없다. (Pro 이상 또는 Console 계정 필요)

#Windows 설치 (네이티브 · 권장)

STEP 1. Git for Windows 설치 (git-scm.com, 기본 옵션) → Git Bash가 함께 설치된다

STEP 2. PowerShell(관리자 권한 불필요)에서 설치

git --version
irm https://claude.ai/install.ps1 | iex

STEP 3. 새 터미널 창을 열어 확인 (기존 창은 PATH가 반영되지 않음)

claude --version     # 2.x (Claude Code)
claude doctor        # 마지막 줄에 문제 없음
where claude         # C:\Users\이름\.local\bin\claude.exe

STEP 4. 작업 폴더에서 첫 실행 → 브라우저 로그인 → "Yes, I trust this folder"

mkdir -p ~/work/vibe && cd ~/work/vibe/sales-quote
claude

{ "env": { "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe" } }

#경로 규칙

• 작업 폴더는 영문 · 공백 없는 짧은 경로 (~/work/vibe/)
• 피할 곳: 바탕화면/새 폴더 (2) (공백·괄호·한글), OneDrive (동기화 잠김), C:\Program Files (관리자 권한)
• 경로는 직접 치지 말고 Tab으로 자동 완성
• 터미널 창 하나에 트랙 폴더 하나

#꼭 알아야 할 터미널 명령 8개

#권한 모드 (Shift+Tab으로 순환)

auto 모드에서도 기본 차단: 내려받은 스크립트 바로 실행(curl … | bash), 민감 정보 외부 전송, 대량 삭제 · 운영 배포 · 권한 변경.

강사 추천: claude --dangerously-skip-permissions — 권한 승인을 모두 건너뛴다(화면에 bypass permissions on). 밤새 일을 맡길 때 유용하지만 민감 데이터 · 운영 환경 · 키가 있는 폴더에서는 신중히. 대안은 위험 작업을 기본 차단하는 auto 모드.

#설치 오류 빠르게 찾기

관리자 권한으로 다시 실행하지 않는다. 막히면 claude doctor부터.

#실습 L01 · 환경 점검과 트랙 폴더 첫 실행 (10분)

Pass 기준: Claude Code가 트랙 폴더의 파일 목록을 보고한다.

#3. 첫 대화와 화면 읽기 (1-3)

#에이전틱 루프

Claude Code는 정보 수집(Read · 검색) → 실행(Write · Edit · Bash) → 결과 확인을 반복한다. 세 단계가 섞여 진행되므로 방향이 다르면 기다리지 말고 Esc로 중단한다.

#화면에서 읽어야 할 것

#승인 창의 세 가지 선택

거부해도 파일은 손상되지 않고, 이유를 입력하면 그에 맞춰 다시 시도한다.

#필수 단축키

처음 익힐 조작은 Esc · /clear · Shift+Tab 세 가지.

#세션 시작 · 종료 · 재개

#자주 쓰는 슬래시 명령

#입력 방법 세 가지 + α

• @경로 — 파일 · 폴더 지정 (Tab으로 완성). 지정하지 않으면 Claude가 스스로 찾느라 느리고 엉뚱한 파일을 읽을 수 있다
• 이미지 붙여넣기 — 오류 화면 · 양식 사진은 글로 옮기지 말고 캡처 그대로
• !명령 — 셸 명령 바로 실행 (!ls report)

강사: "슬래시(/)와 골뱅이(@)만 잘 쓰면 다 끝난다."

#새 폴더에서는 질문이 먼저

1. 전체 — "이 폴더에 무엇이 있는지 알려줘"
2. 형식 — "data/의 파일은 열 이름이 어떻게 돼?"
3. 용어 — "이 폴더에서 사용하는 용어를 표로 정리해줘"
4. 한 건 — "문의 한 건이 초안이 되기까지 따라가 봐"

#실습 L02 · 트랙 자료로 첫 결과물 만들기 (15분)

Pass 기준: 결과 파일 1건이 생기고 data/는 변경되지 않았다.

아래 시뮬레이터는 트랙 A 자료로 구성되어 있다. 일부러 제약 없이 지시해 보고 결과를 열어 보자.

#4. 지시문 작성 (1-4)

#기본 4요소

네 줄 중 가장 자주 빠지는 것은 제약이고, 제약 한 줄이 결과를 가장 크게 바꾼다. 빠진 요소는 Claude가 스스로(그럴듯하게) 채운다.

#결과가 흔들릴 때 더하는 4기법

1. 예시 — 원하는 출력 한 건을 그대로 보여 준다 (형식 설명보다 정확)
2. 단계 — 1) 읽기 → 2) 계산 → 3) 작성처럼 순서를 나눈다 (중간 확인 가능)
3. 환각 방지 — "자료에 없으면 확인 필요로 표기"
4. 되묻기 — "애매한 점은 시작 전에 물어볼 것"

환각 방지 + 되묻기 두 줄은 모든 지시에 넣는다.

#완성 예 (트랙 A)

역할: 너는 영업지원 담당자야.
맥락: inbox/견적문의_01.txt 에 회신할 초안이 필요해. 단가는 data/단가표.csv 에 있어.
형식: 인사 → 품목·수량·단가·합계 표 → 납기 안내 순서로 outbox/drafts/에 저장해줘.
제약: 단가표에 없는 품목은 '확인 필요'로 적고 금액을 만들지 마. 할인은 적용하지 마.
되묻기: 시작 전에 애매한 것이 있으면 먼저 물어봐.

지시문 옆에는 Pass 기준 두 줄을 함께 적어 둔다 — ① 초안의 단가 = 단가표의 단가 ② 단가표에 없는 품목은 '확인 필요'.

#수정 요청은 한 번에 하나, 대상과 기대값으로

#강의 현장 팁

• 프롬프트 자체를 ChatGPT · Gemini에 **"바이브 코딩용 프롬프트 만들어줘"**로 생성해도 된다
• 참고 사이트 URL · 유튜브 링크를 주고 "이런 스타일로" 요청 가능
• 개발 표준 정의서(네이밍 · 폴더 구조)를 참조시켜 코드 생성
• "UX 관점에서 사용성 극대화되게 리팩토링해줘", "주석을 이해하기 쉽게 자세히" 같은 표현이 유용
• 마지막에 **"코드 리뷰 + 테스트까지 해줘"**를 붙인다

#실습 L03 ① · 지시문 다듬기

L02의 짧은 지시를 여섯 요소가 모두 들어간 지시문으로 고쳐 보자.

#5. CLAUDE.md ⭐ 오늘의 핵심

#개념

• 프로젝트 수행 계획서 — 개요 · 역할 · 자료 위치 · 형식 · 제약 · 업무 규칙
• 폴더 맨 위의 CLAUDE.md는 새 대화마다 자동으로 먼저 읽힌다 → 같은 지시를 반복하지 않아도 된다
• 기업 입장에선 재사용 가능한 내부 자산 (이것만 있으면 유사 시스템을 다시 만들 수 있다)
• 다른 도구에도 같은 개념이 있다 (예: Codex의 AGENTS.md)

#위치와 적용 범위

#예시

# 견적 회신 도우미
## 역할
- 너는 영업지원 담당자다.
## 자료
- 단가: data/단가표.csv (수정 금지)
- 문의: inbox/
## 형식
- 인사 → 표(품목·수량·단가·합계) → 납기 안내
- 저장: outbox/drafts/회신_거래처.md
## 제약
- 단가표에 없는 품목은 '확인 필요'
- 할인 금지 · 발송 금지 · 기준일 2026-06-15

#쓸 것 vs 쓰지 말 것 (200줄 이내)

검토 기준: 줄마다 "이 줄이 없으면 AI가 실수하는가?" — 아니면 삭제. 길어지면(헤비해지면) AI가 규칙을 빠뜨린다.

#만들고 고치는 법 · 운영 사이클

1. 자료(수행 계획서 · 아키텍처 · 개발 표준) 확보 → /init으로 초안
2. 자료가 없으면 아이디어(기능 · 사용자 · 비즈니스 로직)를 주고 초안 요청
3. 작업하며 함정을 발견할 때마다 제약 한 줄 추가 ("CLAUDE.md에 반영해줘")
4. 안 쓰는 규칙은 주기적으로 클렌징
5. 수정 후엔 /clear → 새 대화에서 다시 실행해 확인

#실습 L03 ② · CLAUDE.md 완성하기 (20분)

Pass 기준: /clear 뒤 짧은 지시로도 같은 형식의 결과가 나온다. 아래 초안을 고쳐 점수를 8/8로 만들어 보자.

#6. 검증과 오류 해결 (1-5)

#Pass 기준은 지시하기 전에

결과를 본 뒤에 기준을 정하면 결과에 기준을 맞추게 된다. 기준은 셀 수 있는 것(건수 · 합계 · 값의 종류)으로 쓴다.

• ❌ "대체로 맞는 것 같다" → 빠진 건을 찾기 어렵고 완료 시점을 정할 수 없다
• ✅ "대조표 행 수 = 발주 건수", "단가표 없는 품목은 '확인 필요'" → 확인이 몇 분으로 줄어든다

#결과를 확인하는 네 가지 방법

"확실해?"라고 묻는 대신 확인할 수 있는 근거를 요구한다.

#트랙별 함정

함정에 걸렸다면 지시문에 제약 한 줄이 빠진 것이다.

#오류 해결 4단계

1. 원문 전달 — 에러 메시지를 요약하지 말고 그대로 복사, 직전에 한 일을 한 줄로
2. 원인 먼저 — 수정 전에 원인을 한 문장으로 설명하게 한다
3. 한 곳만 수정 — 원인에 해당하는 곳만, 승인 창에서 범위 확인
4. 다시 실행 — 같은 명령으로 Pass 기준 확인, 안 되면 1단계로

예) UnicodeDecodeError: 'cp949' codec … → "원인을 한 문장으로 설명하고 고칠 곳 한 군데만 알려줘" → 파일은 UTF-8인데 cp949로 읽었다 → "그 한 줄만 고치고 다시 실행해줘"

세 번 고쳐도 안 되면 /rewind로 되돌리고 지시를 다시 쓴다.

#자주 막히는 네 가지

#되돌리기와 그 한계

Esc Esc 또는 /rewind → 시점 선택 → 다섯 가지 메뉴

Bash로 변경한 것은 되돌릴 수 없다. 외부 메일 발송 · 외부 시스템 변경 · Git 푸시 · 인프라 작업은 맡기지 않거나 초안까지만. 키 정보가 있는 프로젝트는 Private 레포 + .gitignore 확인.

#실습 L04 · Pass 기준으로 함정 찾기 (25분)

Pass 기준: 함정 두 개가 결과에 표시되어 있다. 먼저 제약 없이 초안을 만들어 함정에 걸려 보고, 되돌린 뒤 제약을 넣어 다시 실행해 비교한다.

#7. 업무 도구 1호 · 커맨드 (1-6)

#커맨드 파일

.claude/commands/quote.md를 만들면 **/quote**로 실행된다. 파일 이름이 곧 명령 이름이다.

---
description: 견적 문의에 회신 초안을 만든다
---
1. inbox/에서 회신하지 않은 문의를 찾는다.
2. data/단가표.csv에서 품목별 단가를 찾는다.
3. CLAUDE.md의 형식으로 초안을 작성한다.
4. outbox/drafts/에 저장한다.
5. 처리한 문의 수와 '확인 필요' 품목을 보고한다.

대상 문의: $ARGUMENTS

• description — / 목록에 표시되는 한 줄 설명
• 본문 — 절차를 번호로 작성
• $ARGUMENTS — /quote 정우테크처럼 뒤에 적은 말이 들어간다
• 규칙은 쓰지 않는다 — "CLAUDE.md를 따른다"로만 (같은 내용을 두 곳에 쓰면 한쪽만 고치게 된다)

#CLAUDE.md vs 커맨드 vs 스킬

강사 의견: 실무에선 커맨드보다 스킬로 만드는 경우가 훨씬 많다. 삼성전자 반도체 · LG전자 등은 스킬 개수 · 활용도를 성과 지표로 삼는 추세.

#트랙별 커맨드

#실습 L05 · 커맨드로 업무 도구 1호 만들기 (20분)

Pass 기준: 새 대화에서 커맨드 한 줄로 Pass 기준을 통과한다.

#Day 1 자가 점검

• CLAUDE.md에 네 요소(역할 · 자료 · 형식 · 제약)가 있다
• 기준일(2026-06-15)이 적혀 있다
• .claude/commands/에 커맨드 파일이 한 개 있다
• 커맨드에 절차가 번호로(네다섯 단계) 적혀 있다
• /clear 뒤 새 대화에서 커맨드가 실행된다
• 결과가 Pass 기준(건수 · 값의 종류)을 통과한다
• 함정 두 개가 결과에 표시된다 ('확인 필요' 등)
• data/ 원본이 그대로다

#8. 강의에서 나온 추가 이야기

#폴더 중심 작업 원칙

• 폴더 하나 = 하나의 시스템/목적 (데이터 분석과 웹 서비스를 한 폴더에 섞지 않기)
• 폴더별로 터미널을 여러 개 띄워 병렬 작업 가능 (토큰만 충분하면)
• @는 실행 폴더 내부만 인식 → 외부 자료는 절대 경로로 지정하거나 폴더 안으로 복사
• 새로 넣은 파일이 인식 안 되면 나갔다 들어오거나 새 대화
• ⚠️ 세션 간 격리가 완벽하지 않으니 엉뚱한 터미널에 지시하는 실수 주의
• VS Code: 터미널에서 code .로 현재 폴더 열기, 내장 터미널에서 claude 실행해도 된다
• 강사는 맥에서 alias(c, c -c, c -r)로 등록해 사용

#운영 원칙 다섯 가지 (Day 2 2-5에서 권한 규칙으로 강제)

#배포와 확장

• GitHub 연동 → "Private 레포 만들어서 올려줘"로 커밋 · 푸시까지 (최초 인증 필요)
• 무료 배포 옵션: Cloudflare(정적 · 서비스), Render(백엔드), Supabase · Firebase(DB), Streamlit Community Cloud, Hugging Face Spaces, Oracle Cloud Free Tier
• 로그인 기능이 필요하면 구글 로그인이 가장 간단
• cron 등 스케줄링과 결합 → 매일 자동 보고서를 만드는 에이전트로
• 강사 사례: 바이브코딩으로 학습 사이트(Tech Learning Hub)를 며칠 만에 Cloudflare에 무료 배포

#요금제 (강사 언급)

• Max는 Pro 대비 약 5배 사용량, 강사는 Max $200 플랜 사용
• 많이 시키면 토큰 한도에 도달해 리셋까지 대기 → 최신 요금은 공식 사이트 확인

#9. 실습 트랙과 폴더 구조

직무 트랙 네 개 중 하나를 Day 1에 정하고 이틀 동안 바꾸지 않는다. 절차는 같고 자료만 다르다.

~/work/vibe/sales-quote/
├── CLAUDE.md           # 규칙 (1-4)
├── data/               # 원본 자료 · 수정 금지
├── inbox/              # 새로 들어온 요청
├── report/             # 결과물
├── outbox/drafts/      # 발송 전 초안 (사람이 확인 후 발송)
├── .claude/commands/   # 커맨드 (1-6)
├── .claude/skills/     # Skill (2-3)
├── tools/              # 도구 스크립트 (2-2)
├── memory/             # 기억 파일 (2-3)
└── scripts/            # 자동 실행 (2-4)

#실습 일정 (L01 ~ L11, 총 245분)

#10. 복습 퀴즈

#✅ 복습 체크리스트

• 실습 폴더에서 claude 실행 및 폴더 신뢰
• /init으로 CLAUDE.md 초안을 만들고 제약 한 줄 추가
• 역할 · 맥락 · 형식 · 제약 + 환각 방지 · 되묻기로 지시문 작성
• Pass 기준 두 줄을 먼저 쓰고 함정 찾기
• 반복 작업을 커맨드(.claude/commands/)로 만들어 새 대화에서 실행
• GitHub Private 레포에 커밋 · 푸시 해 보기
• 개인 프로젝트 하나 정해서 계속 써 보기 (안 쓰면 까먹는다)

#다음 시간 예고 (Day 2)

• 스킬 작성 · 활용 — 오늘 견적 회신 작업을 quote-reply 스킬로 만드는 시연
• 외부 공개 스킬 가져다 쓰기
• 에이전트 구성 (Hermes, OpenClaw 등 — 강사는 AWS 소형 인스턴스에서 격리 운영)
• Plan 모드 설계 → 도구 스크립트 → Skill · Memory → 자동 실행 → 승인과 권한 → 종합 실습
• 아침에는 claude -c로 오늘 대화를 이어 갈 수 있다. 본인 업무 후보 하나를 생각해 오기