화성도시공사 · 관용차 2회차
화성도시공사 업무자동화 AI Agent 개발 코칭 · 과제 ② · 2회차 · 2026. 10. 13
영수증은 찍어서 올리고,
한 마디로
넣습니다
휴대폰으로 올린 주유 영수증을 Claude가 읽어 엑셀에 적고,
대시보드는 코드가 그립니다. CLAUDE.md와 skill도 같이 다룹니다.
대시보드는 코드가 그립니다. CLAUDE.md와 skill도 같이 다룹니다.
김혜련 · 이노핏파트너스 파트너교수
Today · 오늘 만드는 순서
찍어서 올리고, 한 마디로 넣고,
화면은 코드가 그립니다
영수증 사진을 읽어 엑셀에 적는 일은 각자 받으신 Claude 계정이 하고, 사진을 받고 화면을 그리는 일은 코드가 합니다. 그래서 Claude를 안 쓰는 직원도 휴대폰으로 올리고 화면을 봅니다.
Part 01
CLAUDE.md
제대로
설정하기
Claude는 새 대화마다 CLAUDE.md부터 읽습니다.
늘 하는 당부는 대화창이 아니라
이 파일에 적습니다.
늘 하는 당부는 대화창이 아니라
이 파일에 적습니다.
실습01 · 새 대화에서 이어 하기
새 대화를 열어도
tasks.json을 읽고 이어 갑니다
치는 말
tasks.json 보고 어디까지 했는지, 다음에 뭐 할 차례인지 알려줘.
- 1회차T01-T11 끝. 유류 374건 30,695,953원, 수리 87건 13,097,710원
- 남은 일T12 나머지 4대 검사 날짜
- 2회차 계획지난주엔 "PDF 영수증 읽어 옮기기". 4절에서 바꿉니다
숙제 결과(83부·87무, 406,480원)는 이 대화에 말로 알려 주세요. "83부는 83무 오타야. 고쳐줘"처럼요.
실습02 · 해 보기 · 메모장으로 고치기
메모장으로 열어
한 줄을 직접 칩니다
- 1파일 탐색기 → 문서 → car-dashboard
- 2CLAUDE.md 오른쪽 클릭 → 연결 프로그램 → 메모장
- 3맨 아래에 한 줄 치고 Ctrl+S
치는 줄
5. **파일을 지우기 전에는 먼저 물어본다.**
실습02 · 새 대화에서 확인
새 대화를 열면
직접 친 줄이 규칙으로 나옵니다
치는 말
이 폴더에서 일할 때 지켜야 할 규칙 알려줘.
답 (발췌)
5. 파일을 지우기 전에는 먼저 여쭤봐요.
참고로 CLAUDE.md는 아직 저장(커밋)되지
않은 수정이 있어요. 5번 규칙을 최근에
추가하신 것 같은데, 저는 이 규칙도
똑같이 지킬게요.대화 중간에 고치면 그 대화에서는 바뀐 줄을 놓칠 수 있습니다. 고친 뒤에는 새 대화에서 한 번 확인합니다.
실습03 · 해 보기 · 모든 폴더로 옮기기
같은 규칙은 이 폴더 CLAUDE.md에서
빼기까지 했습니다
치는 말
"답은 쉬운 말로 짧게" 이건 다른 폴더에서 일할 때도 지킬 거야. 모든 폴더에 쓰이는 CLAUDE.md로 옮겨줘.
- 새 파일C:\Users\smile\.claude\CLAUDE.md (smile 대신 각자 이름)
- 이 폴더같은 규칙은 뺐고, 5번이 4번으로 올라감
사용자 폴더의 .claude\CLAUDE.md가 생겼는가. 이 폴더 CLAUDE.md 번호가 하나 줄었는가.
실습04 · 오늘의 원칙 넣기
오늘 만들 것의 원칙을
먼저 적어 둡니다
치는 말
CLAUDE.md에 두 줄 넣어줘. 대시보드는 API 키 없이 코드만으로 돌아가게 만들 것. 영수증 사진은 네가 읽어서 엑셀에 적고, 화면은 코드가 그 엑셀을 읽어서 그린다.
답 (발췌)
확인할 점: 1번 규칙 때문에 Docs 폴더의
원본 엑셀은 고칠 수 없어요. 그래서 영수증
내용은 data/ 폴더에 새로 만든 엑셀에
적으려고 해요. 이게 맞다면 6번 규칙에
"data/ 폴더의 엑셀"이라고 적어 둘까요?새 규칙과 지난주 규칙이 서로 안 맞을 수 있어서 먼저 물어봅니다. "응, data 폴더 엑셀로 적어 둬"라고 답합니다.
실습04 · 계획 바꾸기
2회차 계획을
휴대폰 영수증 쪽으로 바꿉니다
치는 말
2회차 계획 바꿀 거야. 휴대폰으로 영수증 찍어서 대시보드에 올리는 화면 만들고, 올라온 영수증은 네가 읽어서 추가내역 엑셀에 넣고, 같은 영수증은 두 번 안 들어가게 막고, 이걸 "영수증 넣어줘" 한 마디로 하게 skill로 만들 거야. 감사자료 엑셀은 마지막에 짧게. PLAN.md랑 tasks.json 2회차 부분 이렇게 고쳐줘. 아직 만들지는 마.
- 올리기 서버휴대폰 사진을 받아 data/영수증함/에 저장. 3회차 일을 앞당김
- 직접 하실 일방화벽은 보안 설정이라 Claude는 방법만 알려 줍니다
- 확인 부탁말하지 않은 "Docs 자료 옮기기"를 남겨 둬도 되는지
실습04 · 질문에 답하기
다 됐다고 볼 기준이
"한 마디면 10분"으로 바뀌었습니다
치는 말
1번은 빼줘. spec.md 8, 9도 지금 같이 고쳐줘.
답 (발췌)
§8 완성 기준
- 휴대폰으로 찍어 올리고 "영수증 넣어줘"
한 마디 하면 10분 안에 화면에 보인다.
- 같은 영수증은 두 번 들어가지 않는다.
§2 추가내역 엑셀에 카드 승인번호 칸을
넣었어요. 같은 영수증인지 가려낼 때
필요해서요.CLAUDE.md에 5·6번이 있는가. spec.md §8 완성 기준이 휴대폰 방식으로 바뀌었는가. 오늘 끝날 때 이 기준으로 확인합니다.
Part 02
휴대폰에서
영수증
올리기
노트북에서 켜 둔 화면을
같은 Wi-Fi의 휴대폰이 주소로 엽니다.
올리는 일은 코드가 합니다.
같은 Wi-Fi의 휴대폰이 주소로 엽니다.
올리는 일은 코드가 합니다.
실습05 · 해 보기 · 켜 두기
대시보드를 켜고
휴대폰에서 열 주소를 받습니다
치는 말
대시보드를 같은 Wi-Fi에 있는 휴대폰에서도 열 수 있게 켜줘. 휴대폰에서 열 주소 알려줘.
답 (발췌)
대시보드를 켰어요. 휴대폰에서는 아래 주소로
여시면 돼요.
http://192.168.31.47:8090
- 8080이 아니라 8090번이에요. 8080번은
PC에서 이미 다른 bun 서버가 쓰고 있었어요.주소와 끝 번호는 PC마다 다릅니다. 각자 답에 나온 주소를 씁니다.
실습06 · 휴대폰으로 열기
휴대폰에서 연 대시보드,
숫자가 같습니다
- 1휴대폰 Wi-Fi를 노트북과 같은 곳에
- 2인터넷 앱 주소창에 5절의 주소
- 확인839너 재검사 · 기름값 30,695,953원 · 수리비 13,097,710원
- 안 열리면① Wi-Fi 이름이 같은가 ② https가 아니라 http인가 ③ 노트북에서 대화를 닫지 않았는가
세 분 휴대폰에서 모두 열리는가. 숫자가 노트북 화면과 같은가.
실습07 · 해 보기 · 올리기 화면
휴대폰 영수증 올리기 화면을
만듭니다
치는 말
휴대폰으로 영수증 사진 찍어서 올리는 화면 만들어줘. tasks.json 순서대로 하고, 다 되면 휴대폰에서 열 주소 알려줘.
- 주소http://192.168.31.47:8090/upload.html
- serve.ts휴대폰 사진을 data/영수증함/에 저장, 같은 사진은 거절
- upload.html카메라로 찍기 · 앨범에서 여러 장 · 아직 안 넣은 사진 수
기다리는 동안 휴대폰으로 영수증을 한두 장 찍어 둡니다.
실습07 · 세 장 올리기
앨범에서 고르면
바로 올라갑니다
- 올린 사진 3장아직 엑셀에 안 넣은 사진 3장
- 저장된 곳노트북의 data/영수증함/
- 아직엑셀에는 안 들어갔습니다. 읽는 일은 3부에서 Claude가
노트북 data/영수증함/ 폴더에 올린 사진이 생겼는가.
실습08 · 같은 사진 다시
같은 사진을 또 올리면
"이미 올린 사진"
- 올린 사진3장 그대로
- 못 막는 것같은 영수증을 다시 찍은 사진은 파일이 달라서 통과합니다. 3부에서 승인번호로 막습니다
같은 사진을 다시 올려도 "올린 사진" 숫자가 늘지 않는가.
Part 03
Claude에게
영수증
읽히기
영수증에 없는 것은 Claude도 모릅니다.
사람이 한 번 알려 준 것을 표로 남기면
다음부터는 그 표를 봅니다.
사람이 한 번 알려 준 것을 표로 남기면
다음부터는 그 표를 봅니다.
설명09 · 왜 0건인가
주유 영수증에는
차량번호가 없습니다
- 영수증에 있는 것날짜 · 유종 · 리터 · 금액 · 주유소 · 승인번호 · 카드번호 일부
- 없는 것차량번호. 지금은 첨부서식 아래 칸에 사람이 손으로 적습니다
- 실마리"차량마다 카드가 다 달라요" (1회차에 하신 말)
실습11 · 다시 찍은 영수증
사진 파일은 달라도
승인번호가 같습니다
치는 말
새로 올라온 영수증 넣어줘.
답 (발췌)
이미 들어간 영수증이라 넣지 않았어요.
- 중복인 이유: 승인번호 58506559가
아까 넣은 9월 2일 영수증(839너)과 같아요.
하나 알려드릴 점: 이 중복 사진은 엑셀에
적히지 않아서 앞으로도 "넣을 사진"으로
계속 세어져요.승인번호는 카드 결제마다 하나씩 붙는 번호입니다. 같은 영수증이면 몇 번을 찍어도 같습니다.
실습12 · 휴대폰에서 반영 확인
새로 고치면
2026 버튼이 생깁니다
- 2026839너 기름값 79,850원, 주유 1건 44L
- 전체기름값 30,695,953원 → 30,775,803원 (+79,850원)
- 빠진 2장차를 아직 몰라 화면 합계에 안 들어감
휴대폰 화면의 숫자와 Claude가 답에 적은 숫자가 같은가.
Part 04
"영수증
넣어줘"
skill
매주 같은 순서로 시키는 일은
skill로 만들어 두면 새 대화에서도
한 마디로 같은 순서를 밟습니다.
skill로 만들어 두면 새 대화에서도
한 마디로 같은 순서를 밟습니다.
실습14 · 해 보기 · skill 만들기
spec.md 9번 절차로
skill을 만들고 시험까지 했습니다
치는 말
/skill-creator spec.md 9번 절차 보고 "영수증 넣어줘"라고 하면 하는 skill 만들어줘.
- SKILL.md안 넣은 사진 찾기 → 읽기 → 적기 → 화면 → 숫자 맞추기 → 보고
- receipts.ts엑셀에 적는 일을 늘 같은 방식으로 하는 도우미 코드
- 시험사진 4장으로. "진짜 엑셀은 건드리지 않았습니다"
/skill-creator가 안 뜨면 앞의 /skill-creator를 빼고 같은 문장을 쳐도 됩니다. 제 PC에서는 6분 걸렸습니다.
실습15 · 처음부터 끝까지 ①
새 영수증 한 장을
휴대폰으로 올립니다
- 1휴대폰 올리기 화면 → 앨범에서 고르기
- 2노트북에서 + 새로 생성으로 새 대화
- 3"영수증 넣어줘" 한 마디
실습15 · 처음부터 끝까지 ②
새 대화에서도 한 마디로
같은 순서를 밟습니다
치는 말
영수증 넣어줘
답 (발췌)
영수증 1장을 넣었습니다.
- 넣은 건: 유류 1건, 90,740원
- 9월 8일 소방주유소, 경유 50리터.
50리터 × 리터당 1,814.92원으로
계산해 봐도 맞습니다.
- 화면에 아직 안 나오는 건: 카드 끝자리
742가 카드차량표에도 없어서 어느 차인지
모릅니다."사용함 도구 1개"를 누르면 receipt-intake가 있습니다. 올리기부터 화면 반영까지 10분 안인가. 4절의 완성 기준입니다.
실습16 · 흐린 사진 넣어 보기
흐려도 승인번호를 읽어
중복으로 걸렀습니다
치는 말
영수증 넣어줘
답 (발췌)
이미 넣은 영수증을 다시 찍은 사진이라
넣지 않았습니다.
- 사진은 조금 흐리지만 금액과 승인번호는
읽힙니다.
- 건너뛴 사진으로 따로 기록해 두어서,
다음에 또 처리되지 않습니다.세 분은 글씨가 안 보일 만큼 흔들어 찍어 보세요. 못 읽은 칸을 지어내지 않고 "확인 필요"로 남기는지 봅니다.
Part 05
감사자료,
정리
1회차에 이야기한 감사자료 양식을
한 마디로 뽑고,
3회차 전까지 할 것을 정합니다.
한 마디로 뽑고,
3회차 전까지 할 것을 정합니다.
실습17 · 감사자료 엑셀
감사자료 양식 엑셀도
한 마디로 뽑습니다
치는 말
감사자료 엑셀 뽑아줘. 오늘 넣은 영수증까지 들어가게.
- 10-다 원본374건 30,695,953원. 원본 엑셀과 같음
- 10-다 전체375건 30,775,803원 (+79,850원)
- 빠진 3건272,220원. 차를 몰라서. 카드 표가 채워지면 들어감
out 폴더의 엑셀을 열어 10-다 맨 아래 줄과 합계 30,775,803원을 봅니다.
실습19 · 커밋하고 마치기
커밋 전에 차량번호·이름이
섞였는지 스스로 봤습니다
치는 말
오늘 한 것 전부 커밋해줘. "2회차: 영수증 올리기"로.
- 들어간 것serve.ts · upload.html · skill · 엑셀·감사자료 코드 · 문서 13개
- 안 들어간 것Docs/ · data/(영수증 사진·엑셀) · out/ · data.js
영수증 사진과 엑셀(data/)이 커밋에 안 들어갔는가.