AI 에이전트 빌딩 워크샵 · 자료 모음

강의자료

한 줄씩 차례대로 확인하세요

🔓

팀 플랜 권한 우회 방법

"권한 우회 모드 허용" 토글이 비활성화된 경우

▼

권한 우회 켜기 (2단계)

설정 → "권한 우회 모드 허용" 토글 ON
대화창 하단 모드 → "권한 무시" 선택

팀 플랜은 토글이 잠겨 있음

개인 플랜(Pro/Max) — 본인이 직접 ON 가능
팀 플랜 — 조직 관리자가 통제. 개인이 켤 방법 없음

해결 — 조직 관리자(Owner)가 허용

claude.ai → Admin Settings → Claude Code → Managed settings
permissions.disableBypassPermissionsMode: "disable" 항목 삭제
팀원 Claude Code 재시작 → 토글 활성화 확인

⚠️ 관리자 허용 전까지는 "편집 자동 수락" 모드 사용을 추천드립니다.

🔗

사전 설치 가이드 (실습 전 필수 확인)

Claude Desktop · Git · Node.js · Claude Code CLI

설치하러 가기 ↗

①

발표안 (전체 슬라이드)

워크샵에서 사용한 전체 발표 자료 · "AI 에이전트 만드는 방법" 1page는 별도 업데이트 예정

열기 ↗

②

AI 에이전트 만드는 방법 (1page 요약)

아이디어 → 분절 → 대화로 작업지시 → 실행 → 디버깅 → 작업지시서

③

관련 파일 링크 (강의 자료 통합 폴더)

실습용 이미지 폴더 · 광고 raw 데이터 · 견적서 양식 등 워크샵에서 쓴 파일을 한 폴더에 모아 둠

드라이브 열기 ↗

실습자료

파일명 정리 · 스킬 · 대시보드 · MCP · 뉴스 크롤링 · 견적서 · 리서치

💡 반복 작업을 스킬로 만들어 재사용해 보세요.
방금 한 작업이 마음에 들면, 다음에도 그대로 쓸 수 있게 스킬로 만들어 보세요. 스킬로 만들어두면 복잡한 설명 없이도 슬래시(/) 단축키를 쓰거나 "~ 해줘" 한마디만 해도, 얘가 방금 한 작업을 기억했다가 바로 실행해줍니다.

실습 ① · 파일명 일괄 변경

클라이언트 파일이 뒤섞인 "받은자료" 폴더 정리하기

카톡으로, 메일로, 드라이브에서 받다 보면 최종_진짜최종_수정3.pdf · asdf.xlsx · 무제 문서.pdf 같은 이름이 한 폴더에 쌓이죠. 이걸 하나의 규칙으로 한 번에 정리합니다. AI가 파일을 직접 열어서 어느 클라이언트의 무슨 문서인지 알아내는 게 이 실습의 핵심 장면이에요.

📌 상황 — 3개 클라이언트를 담당하는 대행사 마케터

귤메달(과일) · 온더베이글(카페) · 글로우랩(화장품) 세 클라이언트의 7월 한 달치 파일이 한 폴더에 섞여 있습니다. 견적서, 제안서, 시안, 정산서, 회의록, 광고 성과 캡처 — 파일명만 봐서는 뭐가 뭔지 알 수 없어요.

목표 · "귤메달 7월 정산서 어디 있지?"를 폴더 검색 한 번으로 끝나게 만들기.

📁 실습 파일 파일 이름 바꿔보기 실습 (16개 파일 · 0.5MB) 드라이브에서 받기 ↗

📋 그대로 복사해서 붙여넣기

이 폴더 안 파일명을 아래 규칙대로 일괄 정리해줘.

규칙: {클라이언트명}_{문서종류}_{YYMMDD}.{확장자}
  예) 귤메달_견적서_260714.pdf

- 클라이언트명과 문서종류는 파일을 직접 열어보고 판단해.
  (문서종류: 견적서 / 제안서 / 시안 / 정산서 / 회의록 / 광고성과)
- 날짜는 아래 순서로 찾아. 오늘 날짜나 파일 수정일은 쓰지 마.
  ① 문서 안에 "작성일" 또는 "시안일"로 적혀 있는 날짜
  ② 없으면 파일명에 들어 있는 날짜
- 셋 중 하나라도 못 찾은 파일은 "미분류_기타_01" 처럼 순번을 붙이고
  비고에 "확인요망"이라고 적어줘.
- 내용이 완전히 같은 중복 파일은 하나만 정상 이름을 주고,
  나머지는 이름 끝에 "_중복"을 붙여줘. 삭제는 하지 마.
- 새 이름이 서로 겹치면 끝에 _2, _3을 붙여줘.
- 표로 [기존 이름 → 새 이름 → 비고] 미리보기를 먼저 보여주고,
  내가 "OK" 하면 그때 일괄 변경해줘.

이 프롬프트의 핵심 · ① "파일을 직접 열어보고 판단해" — 이게 폴더 접근 에이전트의 진짜 능력입니다. asdf.xlsx를 열어 "온더베이글 7월 정산서"라는 걸 스스로 알아내요. 파일명만 바꾸는 도구로는 불가능한 일 · ② 날짜를 파일 수정일이 아니라 문서 안에 적힌 날짜에서 읽습니다 — 파일은 받는 순간 수정일이 "오늘"로 바뀌어버려서, 수정일을 믿으면 16개가 전부 같은 날짜가 됩니다. 문서 안에 적힌 날짜는 누가 언제 받아도 안 변해요 · ③ 애매한 파일은 억지로 배정하지 않고 "미분류 + 확인요망" — AI가 못 하는 일을 인정하게 만드는 게 오히려 정확도를 올립니다 · ④ 중복은 지우지 않고 "_중복" 표시만 — 삭제는 되돌릴 수 없으니 사람이 결정 · ⑤ "미리보기 → OK → 변경" 안전장치로 잘못 바뀌는 사고 방지.

🚀 응용 — 정리한 파일을 클라이언트별 폴더로 나누기

정리한 파일을 클라이언트별 폴더로 나눠서 넣어줘.

- 이 폴더 안에 클라이언트 이름으로 하위 폴더를 만들고,
  각 파일을 자기 클라이언트 폴더로 이동해줘.
- "미분류"로 시작하는 파일은 "미분류" 폴더로.
- 표로 [파일명 → 이동할 폴더] 미리보기를 먼저 보여주고,
  내가 "OK" 하면 그때 이동해줘.

파일명 정리(위)에서 한 단계 더 나아간 버전입니다 · 앞에서 파일명 맨 앞에 클라이언트명을 박아뒀기 때문에 이 지시가 4줄로 끝납니다 — 정리를 한 번 해두면 그다음 작업 지시가 계속 짧아진다는 게 포인트 · 같은 틀로 "귤메달 파일만 골라 귤메달_전달용 폴더로 복사해줘" (클라이언트에게 보낼 것만 추리기), "정산서만 모아줘" (월말 정산) 처럼 실무 상황에 바로 응용됩니다.

실습 ② · /스킬 만들기

방금 한 작업을 "스킬"로 만들어 다음에도 그대로 쓰기

실습 ①에서 한 파일명 정리가 마음에 들었다면, 같은 절차를 다음 폴더에서도 한 줄로 부를 수 있게 굳혀두세요. ①규칙을 문서로 기억시키기 → ②그 문서를 스킬로 만들기 순서로 갑니다. 규칙을 먼저 문서로 뽑아두면, 나중에 규칙만 고쳐도 스킬이 따라 바뀝니다.

💬 1단계 — 규칙을 마크다운 문서로 기억시키기

방금 적용한 파일명 규칙을 다음에도 그대로 쓰게 문서로 남겨줘.

이 프로젝트 폴더 안에 파일명규칙.md 파일로 저장해줘.
문서 안에는 아래를 그대로 담아줘.
- 최종 파일명 형식과 실제 예시 3개
- 클라이언트명·문서종류를 정하는 방법 (파일을 직접 열어 판단)
- 문서종류 목록 (견적서/제안서/시안/정산서/회의록/광고성과)
- 날짜를 찾는 순서 (①문서 안 작성일 →②파일명, 수정일·오늘 날짜 금지)
- 미분류·중복 파일 처리 방식
- "미리보기 표 → OK → 일괄 변경" 진행 순서

저장한 다음 절대 경로를 알려줘.

왜 문서로 먼저 뽑나 · "기억해줘"라고만 하면 이번 대화창 안에서만 유효합니다. 마크다운 파일로 남기면 다음 대화·다른 사람·다른 폴더에서도 같은 규칙을 쓸 수 있고, 규칙이 바뀔 때 이 파일 한 곳만 고치면 됩니다 · "확인 명령까지 담아줘"가 중요합니다 — 규칙만 적어두면 다음번에 AI가 또 자기 방식대로 날짜를 읽습니다.

💬 2단계 — 그 문서를 스킬로 만들기 (경로·이름까지 지정)

방금 만든 파일명규칙.md 를 스킬로 만들어줘.

이 프로젝트의 .claude/skills/filesort/SKILL.md 로컬 스킬로 저장해줘.
글로벌(~/.claude)에는 만들지 마.
스킬 이름은 filesort 로 하고, /filesort 로 실행되게 해줘.

스킬 안에는 규칙 문서 내용을 그대로 넣되,
대상 폴더는 실행할 때 내가 지정하는 걸로 비워둬.
만든 다음 저장된 절대 경로를 알려줘.

스킬 이름 = 슬래시 커맨드입니다 · 따로 지정하는 단축키는 없어요. .claude/skills/filesort/SKILL.md 로 만들면 그대로 /filesort 가 됩니다 · 이름을 안 정해주면 AI가 알아서 짓는데, 매번 다른 이름이 나와서 나중에 본인이 못 찾습니다. 짧은 영문 소문자로 직접 정해주세요 · 이미 있는 스킬과 같은 이름을 쓰면 덮어쓰니, 만들기 전에 / 를 쳐서 목록을 한 번 확인하세요.

💡 운영 팁 — 프로젝트 → 글로벌 순서로 옮기기
먼저 이 프로젝트 폴더 안에 스킬을 만들어 써보세요. 직접 돌려보고 결과가 마음에 들면, 그때 글로벌(전역)로 올려서 활용하면 됩니다. 글로벌로 올리면 다른 프로젝트에서도 같은 스킬을 그대로 쓸 수 있어요.

실습 ③ · 대시보드 만들기

대시보드 만들기

베이커리 판매 데이터(xlsx)를 던지면, 매출·트렌드·제품별 성과를 한눈에 보는 대시보드를 만들어줍니다.

📊 실습 파일 베이커리 판매 데이터 (xlsx) 드라이브에서 열기 ↗

💬 대시보드 만들기 프롬프트 예시

첨부한 파일은 우리 베이커리의 판매 데이터야. 이거를 시각화하는 대시보드를 만들고 싶어.

1. 판매 트렌드 분석
   (a) 제품별 1주일, 2주일, 3주일 단위의 판매 트렌드
   (b) 일별(Daily) 판매 데이터를 볼 수 있었으면 좋겠어

2. 성과 비교 및 상세 분석
   (a) 전체 판매 매출 성과를 제품별로 비교하는 기능
   (b) 특정 날짜를 설정해서 해당 기간의 데이터를 볼 수 있는 기능

3. 대시보드 구조
   (a) 맨 상단에는 전체 요약(Summary) 정보를 담은 스코어 카드 배치
   (b) 스코어 카드 아래에 상세 내용이 위치하는 구조

⭐ 중요

"Claude Code에 허용하시겠습니까?" 팝업 안 뜨게 하기

매번 같은 작업할 때마다 권한 확인 팝업이 떠서 흐름이 끊긴다면, oh-my-claudecode의 명령어 한 번으로 해결할 수 있어요.

Claude Code 대화창에 아래 명령어를 입력하세요:

/fewer-permission-prompts

이 명령어를 실행하면 최근 대화에서 자주 썼던 안전한 명령들(파일 읽기, 폴더 조회, 검색 등)을 자동으로 골라내서 프로젝트의 허용 목록(.claude/settings.json)에 추가해줍니다. 다음부터는 그 명령들에 대해 팝업이 뜨지 않습니다.

⚠ 안전 장치 · 위험할 수 있는 명령(파일 삭제, git push 등)은 자동으로 제외되니, 실수로 막 허용되는 일은 없어요.

실습 ④ · MCP 연결

Notion MCP 연결하기

Claude Code에서 Notion 페이지를 직접 읽고·쓰고·검색할 수 있도록 연결합니다. 2단계로 진행됩니다.

Claude Code 데스크톱 앱에서 Notion 커넥터 추가
터미널 작업 없이 클릭만으로 끝납니다.
(a) 데스크톱 앱 열기 · Claude Code 데스크톱 앱을 평소처럼 실행합니다.
(b) 설정 → Connectors 메뉴 진입 · 앱 안에서 설정 → Connectors 로 이동합니다.
(c) 목록에서 Notion 선택 후 활성화 · 커넥터 목록에서 Notion 을 클릭, OAuth 로그인 후 연결할 워크스페이스를 고르고 "I recognize and trust this URL" 체크 → Continue 를 누르면 1단계 완료.

Notion 페이지에서 접근 허용 (2차 연결)
여기가 가장 많이 빼먹는 단계입니다. Notion에서 Claude가 읽고 쓰게 할 페이지·데이터베이스로 직접 이동한 뒤, 페이지 우상단 ••• 메뉴를 열고 "Add connections"(연결 추가) → 방금 추가한 통합을 선택해 허용합니다. 이 단계를 빼먹으면 Claude Code에서 Notion을 검색해도 object not found 또는 빈 결과만 돌아옵니다.

📘 공식 가이드 Notion 공식 가이드 ↗ Claude Code MCP 문서 ↗

실습 ⑤ · 뉴스 크롤링 → 노션

주식 뉴스 3건 크롤링해서 노션으로 받기

내가 지정한 뉴스 사이트에서 주식 기사 3개를 가져와, 기사마다 브리핑 · 주요 키워드 · 원문 3종 세트로 정리해 노션 페이지에 쌓습니다. 아래 프롬프트에서 맨 윗줄 사이트 주소만 원하는 곳으로 바꾸면 됩니다.

⚠ 실습 ④ Notion MCP 연결이 먼저 끝나 있어야 합니다. 특히 2단계(노션 페이지에서 "Add connections" 허용)를 빼먹으면 노션에 페이지가 안 만들어져요. 노션에 주식 뉴스 브리핑이라는 빈 페이지를 하나 만들고 연결을 허용해 두면 준비 끝.

📋 그대로 복사 → 맨 윗줄 사이트 주소만 바꾸기

아래 뉴스 사이트에서 주식 관련 최신 기사 3개를 가져와서
노션에 정리해줘.

뉴스 사이트: https://finance.naver.com/news/mainnews.naver
  ← 이 줄만 원하는 사이트로 바꾸면 됨

가져올 기사 기준:
- 사이트에 노출된 최신 기사 위에서부터 순서대로 3개
- 광고, 포토 기사, 시세표만 있는 페이지는 건너뛰기

기사 1개당 정리할 내용 (3종 세트, 형식 고정):
1. 브리핑: 기사 내용을 3~5문장으로 요약.
   기사에 없는 내 의견이나 전망은 붙이지 마.
2. 주요 키워드: 종목명·기업·인물·정책·수치 중심으로 5개,
   쉼표로 구분해서 한 줄로.
3. 원문: 기사 본문 전체 텍스트를 그대로 붙이고,
   맨 아래에 출처 링크.

노션에 넣는 방식:
- 노션에서 "주식 뉴스 브리핑" 페이지를 찾아,
  그 아래에 오늘 날짜(YYMMDD) 하위 페이지를 만들어줘.
- 기사 1개당 토글 1개.
  토글 제목: [언론사] 기사 제목
  토글 안 순서: 브리핑 → 주요 키워드 → 원문

진행 방식:
- 나한테 되묻지 말고 위 기준대로 진행해.
- 본문을 가져올 수 없는 기사(로그인·유료 등)는 건너뛰고
  다음 기사로 채워서 3개를 맞춰줘.
- 노션에 올리기 전에 [기사 제목 / 키워드 / 브리핑 첫 문장]
  표로 먼저 보여주고, 내가 "OK" 하면 그때 노션에 올려줘.

이 프롬프트의 핵심 · ① 사이트 주소를 첫 줄에 고정 — 실습 ①의 브랜드명 자리와 같은 원리로, 바꿀 곳 한 줄만 열어두고 나머지는 닫아둡니다 · ② 산출물을 브리핑 · 키워드 · 원문 3종 세트로 형식 고정 → 매번 다른 모양으로 정리되는 걸 방지 · ③ 유료·로그인 기사 같은 실패 케이스 처리 규칙을 미리 정해 중간에 멈추지 않음 · ④ 노션에 쓰기 전 "미리보기 → OK" 안전장치 — 외부 서비스에 뭔가 쓰는 작업일수록 이 단계가 중요합니다.

💡 응용 — 매일 아침 자동으로 받기
이 작업이 마음에 들면 실습 ②처럼 스킬로 만들어두고, "매일 아침 8시에 실행해줘"라고 스케줄까지 걸면 출근 전에 뉴스 브리핑이 노션에 쌓여 있는 자동화가 됩니다.

실습 ⑥ · 문서 자동화

견적서 만들어보기

GEOCM 가상 인플루언서·기자 리스트를 Claude에게 읽히면, 샘플 견적서와 똑같은 디자인으로 견적서를 자동으로 만들어줍니다.

📄 실습 파일 견적서_샘플_팀보더.html · pdf + GeoCM_인플루언서_기자_풀_실습데이터.csv 드라이브에서 열기 ↗

💬 견적서 작성 프롬프트 예시

GeoCM_인플루언서_기자_풀_실습데이터.csv 는 GEOCM의 가상 인플루언서·기자 리스트야.
이 파일을 읽고, 리스트 항목 중 첫 번째와 두 번째 기자님의 견적서를 만들어줘.

조건:
- 견적서_샘플_팀보더.html 과 디자인이 똑같아야 해
- 부가세 10%와 합계까지 자동 계산해서 넣을 것
- 파일명은 "견적서_{이름}_{소속채널명}_{날짜}.html" 로 저장하고 PDF로도 변환해줘

실습 ⑦ · 웹 리서치

구글 검색으로 브랜드 빠르게 정리하기

Claude에게 한 줄로 "이 브랜드 구글링해서 정리해줘"라고 시키면, 공식 사이트·뉴스·SNS·리뷰까지 훑어서 한 페이지로 압축해줍니다. 경쟁사 리서치 · 신규 클라이언트 사전조사 · 신상품 트렌드 파악에 그대로 쓸 수 있어요.

💬 구글링 리서치 프롬프트 예시

"귤메달"이라는 브랜드에 대해 간단히 구글링하여 정리해줘.

한 줄로도 충분 · Claude가 알아서 공식 홈페이지·인스타·뉴스·블로그를 훑어보고, 브랜드 정체성·주력 상품·가격대·고객 반응까지 정리해줍니다. 더 구체적인 결과가 필요하면 "경쟁사 3곳도 함께", "광고 메시지 톤도 분석", "최근 6개월 신상품만" 같은 조건을 덧붙이세요.

도구 · 확장 프로그램

워크샵 환경 그대로 재현

🎙

Typeless — AI 음성 받아쓰기

말로 한 내용을 깔끔한 문장으로 정리해주는 AI 받아쓰기 앱 · Mac · Windows · iOS · Android 지원

다운로드 ↗ 공식 사이트 ↗

🌐

Claude for Chrome — 브라우저 확장

Claude를 크롬 안에서 바로 호출 · 웹 자동화 실습에 필요

설치 페이지 ↗