🛠️ 사전 준비
자료실 & 사전 준비
원활한 라이브 워크숍 진행을 위해 강의 시작 전 본인 컴퓨터에 반드시 설치 및 가입해 두어야 하는 환경 설정 자료들입니다.
필수 설치 및 가입
강의 수강에 반드시 필요한 프로그램과 개발자 플랫폼 계정입니다.
공통 · macOS / Windows
VS Code (Visual Studio Code)
강의에서 사용할 주력 코드 에디터(IDE)입니다. Claude Code 에이전트를 통합 셸에서 연동하여 코딩합니다.
Node.js (LTS 버전) — 선택
Claude Code 기본 설치(공식 설치 스크립트)에는 필요 없습니다. npm으로 Claude Code를 설치하거나 Node 기반 실습 도구를 쓸 때만 필요해요. 받는다면 홈페이지 메인의 LTS 버전(22 이상)을 받으세요.
Claude Code 가입 및 계정 준비
말하듯 일을 시키는 터미널 기반 AI 에이전트입니다. 무료 플랜에서는 Claude Code를 쓸 수 없어서 Pro 이상 구독이 필요합니다. 설치는 터미널에 한 줄 — 방법은 1-1 환경 세팅에 있어요.
GitHub (깃허브) 회원가입
버전 관리와 원활한 코드 관리를 위한 개발자 플랫폼입니다. 나중에 Vercel 배포를 동기화하기 위해 필수적입니다.
Git (깃) 설치하기
코드의 이력을 기록하고 AI 에이전트가 코드를 커밋하고 배포하는 브릿지 역할을 해주는 핵심 버전 관리 소프트웨어입니다.
Claude Desktop App 설치
웹 브라우저를 띄우지 않고 로컬 PC에서 가장 쾌적하게 클로드 모델과 대화하며 작업 환경을 연동할 수 있는 공식 설치형 앱입니다.
핵심 API 및 데이터 서비스 계정
실제 데이터 수집 및 데이터베이스 저장을 위한 발급처 및 서비스 계정 목록입니다. (사전 가입 권장)
공공데이터포털 (data.go.kr) 회원가입
한국관광 데이터랩(지역별 방문자수 등)과 기상청 통계 등 정부 공공 API를 활용하기 위해 회원가입이 필요합니다.
한국관광 데이터랩 (datalab.visitkorea.or.kr) 회원가입
지역별 방문자·체류·숙박 데이터를 웹에서 CSV로 바로 다운로드할 수 있는 한국관광공사 서비스입니다. 모듈 2 전처리 실습(동해시 방문자 데이터)에서 사용합니다.
NAVER API HUB (ncloud.com) 신청
네이버 데이터랩 검색어 트렌드 API와 블로그 검색 API를 쓰려면 여기서 신청합니다. 네이버 개발자 센터(developers.naver.com)는 2026년 7월 31일부터 이 API들의 신규 신청을 막았어요 — 이제 네이버 클라우드 플랫폼(NCP) 계정으로 신청하고 Client ID/Secret을 발급받습니다.
서울 열린데이터광장 (data.seoul.go.kr) 회원가입
서울시 공공자전거 대여이력(따릉이 데이터) 등 서울시 특화 공공 데이터를 수집하기 위해 회원가입 및 API 인증키 발급이 필요합니다.
Apify (apify.com) 회원가입
인스타그램 해시태그나 웹 페이지의 데이터를 직접 스크래핑(Scraping)할 때 활용하는 클라우드 스크래퍼 서비스입니다. 무료 크레딧($5) 범위 내에서 실습합니다.
Supabase (supabase.com) 회원가입
분석한 정형 데이터나 가공된 결과를 저장하고 다루기 위한 클라우드 PostgreSQL 데이터베이스 서비스입니다. GitHub 계정으로 간편히 가입할 수 있어요. 무료 플랜은 실습용으로 충분하지만 프로젝트 2개, DB 500MB, 1주일 안 쓰면 일시정지 같은 제한이 있습니다.
Google Cloud Platform (GCP) 가입 및 프로젝트 생성
Gmail, Google Sheets, Google Drive, YouTube Data API 등 Google 서비스 연동 및 데이터 수집·자동화를 위해 계정 생성과 프로젝트 설정이 필요합니다.
강의 스킬 · CLAUDE.md 자료
강의에서 함께 쓰는 클로드 스킬 5종 — 분석 4단계 스킬(① 가설 · ② 수집 · ③ 의심 · ④ 정리)과 이 넷을 순서대로 굴리는 파이프라인 스킬 — 을 플러그인 하나로 묶어 배포했습니다(현재 v2.0.0). Claude Code에서 아래 두 줄이면 설치가 끝납니다.
추천 · 플러그인 설치
데이터팝콘 분석 플러그인 — 두 줄이면 끝
/plugin marketplace add team-datapopcorn/datapopcorn-analysis-plugin
/plugin install datapopcorn-analysis@datapopcorn
설치하면
예전 버전을 설치했다면
스킬 각각이 뭘 하는지는 모듈 2에서, 플러그인이 어떻게 만들어지는지는 6-1에서 다룹니다.
소스: github.com/team-datapopcorn/datapopcorn-analysis-plugin
/datapopcorn-analysis:2-collect처럼 이름으로 직접 부를 수도 있고, "CSV 전처리해줘"라고 말해도 알아서 꺼내 씁니다. "분석해줘"라고만 하면 data-analysis-pipeline이 ①부터 순서대로 굴려요.예전 버전을 설치했다면
/plugin marketplace update datapopcorn으로 업데이트하세요. v2.0.0부터 이름이 바뀌었습니다 — work-analysis → 1-hypothesis, data-preprocess → 2-collect, popcorn-report → 4-report, 3-suspect는 새로 생겼어요. "전처리해줘", "popcorn-report 스타일로"처럼 부르던 말은 그대로 통합니다.스킬 각각이 뭘 하는지는 모듈 2에서, 플러그인이 어떻게 만들어지는지는 6-1에서 다룹니다.
소스: github.com/team-datapopcorn/datapopcorn-analysis-plugin
스킬 하나만 열어보거나 CLAUDE.md 예시만 따로 복사하고 싶다면, 원문을 그대로 볼 수 있습니다. 전부 마크다운 텍스트 파일이라 — 원문을 열어 복사하면 그대로 여러분 것이 됩니다.
1-hypothesis — ① 가설 스킬
무엇을 분석할지 정해지지 않았을 때. 목표를 인터뷰해서 검증 가능한 가설 · 핵심/방어 지표 · 판정 기준을 hypothesis.md로 남깁니다. (예전 이름 work-analysis)
2-collect — ② 수집 스킬
데이터를 확보하고 인코딩 · 타입 · 결측 · 중복을 정리해 data/clean/과 preprocessing_report.html을 남깁니다. (예전 이름 data-preprocess)
3-suspect — ③ 의심 스킬 (v2.0.0 신규)
결론 내기 전에 데이터를 의심하는 단계. EDA + 함정 10개(공통 5 · 검증 5) 판정으로 eda_report.html과 traps_check.md를 남깁니다.
4-report — ④ 정리 스킬
분석 결과를 한 장짜리 매거진 톤 HTML 리포트로 만드는 데이터팝콘 표준 디자인. 헤드라인 · KPI · 인사이트 박스 · 액션 카드. (예전 이름 popcorn-report)
data-analysis-pipeline — 4단계 오케스트레이터
①~④를 순서대로 굴리고 진행 상황을 관리합니다. 단계마다 파일이 남아서 중간에 끊겨도 "어디까지 했지" · "다음 단계"로 이어 돌릴 수 있어요.
data-preprocess — 4-3 실습용 전처리 스킬 (직접 만드는 예시)
raw CSV를 다듬고 preprocessing_report.html을 남기는 5줄 규칙. 4-3에서 내 손으로 스킬을 만들어 보는 연습용 예시입니다. 플러그인의 2-collect가 이걸 확장한 버전이에요.
CLAUDE.md 예시 — 분석 프로젝트 규칙 파일
5-3 실습에서 작성하는 프로젝트 규칙 파일 예시. 복사해서 프로젝트 폴더 맨 위에 CLAUDE.md로 저장하면 모든 세션에 자동 적용됩니다. 내 업무 기준으로 규칙을 고쳐 쓰는 게 핵심.
실습 데이터
모듈 2·4 실습에서 쓰는 데이터입니다. 데이터랩 가입·다운로드가 늦어지면 여기 파일로 바로 따라오세요.
동해시 방문자 수(연인원) 추이 CSV
4-3 전처리 실습용. 월별 방문자수·전년동월·증감률, 2024.11~2026.04 (월간 조회 한도가 18개월이라 18행). 직접 받으려면: 데이터랩 → 지역별 데이터랩 → 동해시 → 방문자 탭 → "방문자 수(연인원) 추이"의 [데이터 다운로드].
광고 캠페인 성과 CSV (연습용 가상 데이터)
"내 파일로 시작" 경로 연습용. 채널별(검색광고·인스타·카카오) 월별 광고비·노출·클릭·전환·매출 17개월. 실제 데이터가 아닌 생성 데이터입니다.
Streamlit 인터랙티브 앱 예제 — 라이브 배포본 (CH07 보너스)
Claude Code로 만든 두 대시보드(캠페인 성과·묵호 관광 트렌드)를 실제로 배포해 뒀습니다 — 클릭하면 바로 열립니다. 소스는 강의 저장소의
demo_streamlit/ 폴더, 로컬 실행은 pip install -r requirements.txt 후 streamlit run app.py. 만드는 과정은 CH07 보너스 페이지에서 확인할 수 있습니다.
스킬 설치 방법
내 프로젝트에 넣는 방법 — 플러그인 vs 낱개
🔌 방법 1 — 플러그인 설치 (추천)
5종을 한 번에 받는 방법입니다. Claude Code에서:
두 줄이면 ① 가설 · ② 수집 · ③ 의심 · ④ 정리 스킬과 파이프라인 스킬이 한 번에 들어옵니다. 이미 설치했다면
5종을 한 번에 받는 방법입니다. Claude Code에서:
/plugin marketplace add team-datapopcorn/datapopcorn-analysis-plugin/plugin install datapopcorn-analysis@datapopcorn두 줄이면 ① 가설 · ② 수집 · ③ 의심 · ④ 정리 스킬과 파이프라인 스킬이 한 번에 들어옵니다. 이미 설치했다면
/plugin marketplace update datapopcorn으로 최신 버전을 받으세요.
📋 방법 2 — 낱개로 복사해 넣기
스킬 하나만 필요하거나 내용을 고쳐 쓰고 싶을 때 씁니다.
1. 위 카드에서 원문을 열고 전체 복사합니다 (Ctrl/Cmd+A → C).
2. 프로젝트 폴더에
3. Claude Code에서 "어떤 스킬을 쓸 수 있어?"라고 물어 목록에 나오면 끝 — 저장하면 재시작 없이 바로 적용됩니다.
※ 스킬이 뭔지부터 보려면 4-1 스킬이 뭔지 · 플러그인 구조는 6-1 플러그인 · 공식 문서: Claude를 skills로 확장하기
스킬 하나만 필요하거나 내용을 고쳐 쓰고 싶을 때 씁니다.
1. 위 카드에서 원문을 열고 전체 복사합니다 (Ctrl/Cmd+A → C).
2. 프로젝트 폴더에
.claude/skills/스킬-이름/SKILL.md 파일을 만들어 붙여넣고 저장합니다.3. Claude Code에서 "어떤 스킬을 쓸 수 있어?"라고 물어 목록에 나오면 끝 — 저장하면 재시작 없이 바로 적용됩니다.
※ 스킬이 뭔지부터 보려면 4-1 스킬이 뭔지 · 플러그인 구조는 6-1 플러그인 · 공식 문서: Claude를 skills로 확장하기
윈도우 & 맥 공통
Git (깃) OS별 상세 설치 방법
에이전트의 변경 사항 기록 및 연동을 위해 컴퓨터에 Git이 반드시 설치되어 있어야 합니다.
🖥️ Windows (윈도우) 환경 설치 방법
1. Git 공식 홈페이지에서 Windows용 설치 파일(64-bit Git for Windows Setup)을 다운로드하여 실행합니다.
2. 설치 과정 중 나타나는 설정 창에서는 기본 옵션을 모두 유지한 채 Next를 누르면 됩니다.
3. (권장) AI 에이전트 및 CLI 환경을 쾌적하게 활용하기 위해, 설치 후 윈도우 검색창에서 Git Bash를 열어 명령어를 입력하는 환경을 주로 활용하게 됩니다. Git for Windows가 있으면 Claude Code도 Git Bash로 명령을 실행하고, 없으면 PowerShell로 돌아갑니다.
1. Git 공식 홈페이지에서 Windows용 설치 파일(64-bit Git for Windows Setup)을 다운로드하여 실행합니다.
2. 설치 과정 중 나타나는 설정 창에서는 기본 옵션을 모두 유지한 채 Next를 누르면 됩니다.
3. (권장) AI 에이전트 및 CLI 환경을 쾌적하게 활용하기 위해, 설치 후 윈도우 검색창에서 Git Bash를 열어 명령어를 입력하는 환경을 주로 활용하게 됩니다. Git for Windows가 있으면 Claude Code도 Git Bash로 명령을 실행하고, 없으면 PowerShell로 돌아갑니다.
🍏 macOS (맥) 환경 설치 방법
1. 화면 우상단 돋보기(Spotlight)를 클릭해 터미널(Terminal) 앱을 검색하여 실행합니다.
2. 터미널 창에
3. Git이 아직 설치되어 있지 않다면, macOS 시스템에서 "Xcode 명령줄 도구(Command Line Tools)를 설치하시겠습니까?"라는 팝업 알림이 뜹니다. [설치] 버튼을 눌러 진행하면 자동으로 완료됩니다.
4. (대안) 이미 개발용 패키지 관리자인 Homebrew를 사용 중이라면, 터미널에
1. 화면 우상단 돋보기(Spotlight)를 클릭해 터미널(Terminal) 앱을 검색하여 실행합니다.
2. 터미널 창에
git --version을 입력하고 Enter를 누릅니다.3. Git이 아직 설치되어 있지 않다면, macOS 시스템에서 "Xcode 명령줄 도구(Command Line Tools)를 설치하시겠습니까?"라는 팝업 알림이 뜹니다. [설치] 버튼을 눌러 진행하면 자동으로 완료됩니다.
4. (대안) 이미 개발용 패키지 관리자인 Homebrew를 사용 중이라면, 터미널에
brew install git을 실행해 간편히 설치할 수도 있습니다.
API 키 준비 팁
공공데이터포털 신청 팁
🔑 공공데이터포털 활용신청 팁
- 회원가입 후 "한국관광공사 빅데이터 지역별 방문자수"를 검색하여 [활용신청]을 승인받습니다.
- 마이페이지에서 일반 인증키 (Decoding) 값을 복사하여 보관해 두어야 강의 때 바로 로드할 수 있습니다.
- ⚠️ 발급 후 약 1~2시간의 키 전파 지연이 있을 수 있으니 강의 전에 미리 가입 및 신청을 해두는 것을 강력히 권장합니다.
- 회원가입 후 "한국관광공사 빅데이터 지역별 방문자수"를 검색하여 [활용신청]을 승인받습니다.
- 마이페이지에서 일반 인증키 (Decoding) 값을 복사하여 보관해 두어야 강의 때 바로 로드할 수 있습니다.
- ⚠️ 발급 후 약 1~2시간의 키 전파 지연이 있을 수 있으니 강의 전에 미리 가입 및 신청을 해두는 것을 강력히 권장합니다.
API 키 발급 · NCP 콘솔
NAVER API HUB — 가입부터 사용까지
네이버 개발자 센터(developers.naver.com)는 2026년 7월 31일부터 검색 · 검색어 트렌드 API의 신규 신청을 막았고, 기존 키도 2027년 6월 30일에 끝납니다. 이제 네이버 클라우드 플랫폼(NCP) 계정으로 NAVER API HUB에서 신청합니다.
1️⃣ NCP 계정 가입
- NAVER API HUB 소개 페이지에서 [회원가입]으로 네이버 클라우드 플랫폼(NCP) 계정을 만듭니다 — 네이버 아이디로도 가입할 수 있습니다.
- 콘솔 로그인 후 우측 상단 [리전 & 플랫폼]은 기본값 그대로 두면 됩니다.
- NAVER API HUB 소개 페이지에서 [회원가입]으로 네이버 클라우드 플랫폼(NCP) 계정을 만듭니다 — 네이버 아이디로도 가입할 수 있습니다.
- 콘솔 로그인 후 우측 상단 [리전 & 플랫폼]은 기본값 그대로 두면 됩니다.
2️⃣ 애플리케이션 등록
- 콘솔 상단 Menu → All Services → Application Services → NAVER API HUB로 이동합니다.
- 왼쪽 Application 메뉴에서 Application Management 화면의 [등록] 버튼을 클릭합니다.
- 사용 API는 '검색'과 '데이터랩(검색어 트렌드)' 두 가지를 모두 체크해야 에이전트가 정상적으로 수집할 수 있습니다.
- 애플리케이션 이름을 입력하고 완료합니다.
- 콘솔 상단 Menu → All Services → Application Services → NAVER API HUB로 이동합니다.
- 왼쪽 Application 메뉴에서 Application Management 화면의 [등록] 버튼을 클릭합니다.
- 사용 API는 '검색'과 '데이터랩(검색어 트렌드)' 두 가지를 모두 체크해야 에이전트가 정상적으로 수집할 수 있습니다.
- 애플리케이션 이름을 입력하고 완료합니다.
3️⃣ Client ID / Secret 발급
- 등록한 Application을 선택하고 [인증 정보] 버튼을 눌러 Client ID와 Client Secret을 각각 복사합니다.
- 두 값을 텍스트 파일이나
- 등록한 Application을 선택하고 [인증 정보] 버튼을 눌러 Client ID와 Client Secret을 각각 복사합니다.
- 두 값을 텍스트 파일이나
.env에 보관해 두면 강의 때 바로 로드할 수 있습니다.
4️⃣ 달라진 점 — 호출 방식
- 인증 헤더 이름이 바뀌었습니다: 예전
- 엔드포인트 도메인도
- 실제 호출 예시는 1-1 환경 세팅에서, 공식 문서는 NAVER API HUB 개요에서 확인하세요.
- 인증 헤더 이름이 바뀌었습니다: 예전
X-Naver-Client-Id / X-Naver-Client-Secret 대신 X-NCP-APIGW-API-KEY-ID / X-NCP-APIGW-API-KEY를 씁니다.- 엔드포인트 도메인도
openapi.naver.com에서 naverapihub.apigw.ntruss.com로 바뀌었습니다.- 실제 호출 예시는 1-1 환경 세팅에서, 공식 문서는 NAVER API HUB 개요에서 확인하세요.
고급 연동 & DB 팁
Supabase & Apify & GCP 연동 팁
🗄️ Supabase 데이터베이스 생성 팁
- 가입 후 [New Project]를 생성할 때 지정하는 Database Password는 절대 잊어버리지 않게 안전한 곳에 기록해 두세요.
- 프로젝트 생성이 완료되면 Project Settings에서 Project URL과 API Keys 화면의 Publishable key(예전 이름 anon key) 값을 복사하여 보관해 둡니다. Secret key(service_role)는 코드나 화면에 노출하지 마세요.
- 무료 플랜은 1주일 동안 쓰지 않으면 프로젝트가 일시정지됩니다. 강의 전날 대시보드에서 한 번 열어 두세요.
- 가입 후 [New Project]를 생성할 때 지정하는 Database Password는 절대 잊어버리지 않게 안전한 곳에 기록해 두세요.
- 프로젝트 생성이 완료되면 Project Settings에서 Project URL과 API Keys 화면의 Publishable key(예전 이름 anon key) 값을 복사하여 보관해 둡니다. Secret key(service_role)는 코드나 화면에 노출하지 마세요.
- 무료 플랜은 1주일 동안 쓰지 않으면 프로젝트가 일시정지됩니다. 강의 전날 대시보드에서 한 번 열어 두세요.
🕸️ Apify API 토큰 팁
- 회원가입 후 우측 상단의 프로필 혹은 Settings -> Integrations에서 Personal API Token 값을 복사하여 활용합니다.
- 무료 가입 시 매달 제공되는 $5 상당의 무료 크레딧만으로도 인스타그램이나 네이버 지도 스크래핑 실습에 충분합니다.
- 회원가입 후 우측 상단의 프로필 혹은 Settings -> Integrations에서 Personal API Token 값을 복사하여 활용합니다.
- 무료 가입 시 매달 제공되는 $5 상당의 무료 크레딧만으로도 인스타그램이나 네이버 지도 스크래핑 실습에 충분합니다.
☁️ Google Cloud Platform (GCP) API 활성화 팁
- GCP 콘솔에서 [프로젝트 생성]을 완료한 후, API 및 서비스 > 라이브러리에서 필요한 API(예: Google Sheets API, YouTube Data API v3 등)를 각각 검색하여 [사용] 버튼을 눌러 활성화해야 합니다.
- 사용자 인증 정보 메뉴에서 API 키를 생성하거나, 안전한 서버 간 연동을 위해 서비스 계정(Service Account) 키 파일(.json)을 생성해 작업 폴더에 보관하여 로드해 활용합니다.
- GCP 콘솔에서 [프로젝트 생성]을 완료한 후, API 및 서비스 > 라이브러리에서 필요한 API(예: Google Sheets API, YouTube Data API v3 등)를 각각 검색하여 [사용] 버튼을 눌러 활성화해야 합니다.
- 사용자 인증 정보 메뉴에서 API 키를 생성하거나, 안전한 서버 간 연동을 위해 서비스 계정(Service Account) 키 파일(.json)을 생성해 작업 폴더에 보관하여 로드해 활용합니다.