모듈 1 · CH01 환경 세팅

1-1. Claude Code 설치 · API 키 발급

CH01 강의 영상 · 전체 6:33

분석을 시작하려면 두 가지가 필요해요. 도구(Claude Code)와 데이터 접근권(API 키). 둘 다 하루면 끝나요. 한 번 세팅하면 다음 주제에도 그대로 씁니다.


1. 일반 원칙 — 환경은 한 번만

분석마다 환경을 새로 만들면 비효율적이에요. 한 번 세팅한 뒤 다음 주제로도 재사용하는 게 원칙. 그래서 처음에 약간 손이 가더라도 다음 주제부턴 "데이터 받아줘" 한 줄로 시작할 수 있어요.

2. Claude Code 설치

터미널에 공식 설치 명령 한 줄이면 돼요. 이 방식은 Node.js가 필요 없고, 설치한 뒤에는 알아서 최신 버전으로 업데이트됩니다. 내 컴퓨터에 맞는 줄 하나만 실행하세요.

# macOS · Linux · WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell (프롬프트가 PS C:\ 로 시작)
irm https://claude.ai/install.ps1 | iex

# Windows CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

# 설치 확인 — 새 터미널 창을 열고
claude --version

# 작업 폴더 만들고 진입
mkdir my-analysis && cd my-analysis

# 시작
claude

처음 실행하면 Claude 계정 로그인을 요청해요. 브라우저 인증 한 번이면 끝. 무료 플랜에서는 Claude Code를 쓸 수 없어서 Pro 이상 구독이 필요합니다.

※ claude를 못 찾는다고 나오면 터미널을 완전히 닫았다가 다시 여세요. 그래도 안 되면 claude doctor로 점검합니다. Homebrew(brew install --cask claude-code)나 WinGet(winget install Anthropic.ClaudeCode)으로도 설치할 수 있고, 예전 방식인 npm 설치는 Node.js 22 이상이 필요합니다. 출처: Claude Code 공식 설치 문서

3. API 키 — 데이터 접근의 열쇠

공공·민간 데이터는 대부분 API로 받아요. 그러려면 발급받은 키가 필요. 이번 강의에서 쓸 핵심 3곳:

data.go.kr (공공데이터포털)

한국관광 데이터랩 · 코레일 등 정부 API의 관문. 키 1개로 여러 서비스 활용 신청.

NAVER API HUB

네이버 데이터랩 검색어 트렌드 + 블로그 검색. NCP 계정으로 신청, Client ID/Secret 한 쌍 발급.

(옵션) Apify

인스타·웹 스크래핑이 필요할 때. 무료 $5 크레딧.

4. data.go.kr 한국관광 데이터랩 신청

  1. data.go.kr 회원가입 / 로그인
  2. "한국관광공사 빅데이터 지역별 방문자수" 검색 → 활용신청
  3. 마이페이지에서 일반 인증키(Decoding) 복사 — 디코딩 키여야 함(인코딩 X)
  4. 같은 키로 코레일 카리지 통계도 활용신청해두면 좋아요

★ 주의. 한국 공공 API는 발급 직후 1~2시간 키 전파 지연이 있어요. 처음 호출에 403이 떠도 잠시 후 다시 시도.

공공데이터포털 API 호출 예시

아래 예시는 발급받은 일반 인증키로 지역별 방문자수 데이터를 조회하는 방법입니다. 내_인증키 자리에 본인 키를 넣으세요. 주소창에 직접 붙여 넣는 curl에서는 Encoding 키를, 파이썬 코드(.env)에서는 Decoding 키를 씁니다. (깨짐 방지를 위해 URL을 따옴표로 감싸 호출합니다)

curl -s "https://apis.data.go.kr/B551011/DataLabService/metcoRegnVisitrDDList?serviceKey=내_인증키&numOfRows=10&pageNo=1&MobileOS=ETC&MobileApp=AppTest&startYmd=20210513&endYmd=20210513"

응답 예시 (XML):

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<response>
  <header>
    <resultCode>0000</resultCode>
    <resultMsg>OK</resultMsg>
  </header>
  <body>
    <items>
      <item>
        <areaCode>11</areaCode>
        <areaNm>서울특별시</areaNm>
        <daywkDivCd>4</daywkDivCd>
        <daywkDivNm>목요일</daywkDivNm>
        <touDivCd>1</touDivCd>
        <touDivNm>현지인(a)</touDivNm>
        <touNum>4828435.5</touNum>
        <baseYmd>20210513</baseYmd>
      </item>
    </items>
    <numOfRows>10</numOfRows>
    <pageNo>1</pageNo>
    <totalCount>51</totalCount>
  </body>
</response>

네이버 개발자 센터(developers.naver.com)는 2026년 7월 31일부터 검색 · 검색어 트렌드 API의 신규 신청을 막았고, 기존 키도 2027년 6월 30일에 끝나요. 이제 네이버 클라우드 플랫폼(NCP) 계정으로 NAVER API HUB에서 신청합니다.

  1. NAVER API HUB 소개 페이지에서 [회원가입] → NCP 계정 생성(네이버 아이디로도 가입 가능)
  2. 콘솔 로그인 후 Menu → All Services → Application Services → NAVER API HUB 이동
  3. 좌측 Application 메뉴 → Application Management 화면에서 [등록] 클릭
  4. 사용 API에 '검색' + '데이터랩(검색어 트렌드)' 둘 다 체크 → 애플리케이션 이름 입력 → 완료
  5. 등록한 Application 선택 → [인증 정보]에서 Client ID · Client Secret 복사

★ 주의. 인증 헤더 이름이 바뀌었습니다 — 예전 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로 바뀌었어요. 아래 7번 예시가 새 방식입니다.

6. .env 파일 — 키 보관의 정석

키를 코드에 직접 넣으면 깃에 올릴 때 사고 나요. .env 파일에 모으고 코드에선 환경변수로 읽기가 원칙.

# 프로젝트 루트에 .env (gitignore에 추가!)
TOUR_API_KEY=발급받은_디코딩_키
NAVER_ID=클라이언트_ID
NAVER_SECRET=시크릿
APIFY_TOKEN=옵션

실행할 땐 한 줄:

set -a; source .env; set +a
# 이제 환경변수로 사용 가능

7. 첫 자연어 명령 — 확인

모든 게 잘 되었나 확인할 한 줄. Claude Code에서:

".env 파일이 잘 읽히나? 네이버 데이터랩 API로 '서울' 키워드 최근 한 달 검색 받아봐."

NAVER API HUB 검색어 트렌드 API 사용법

아래 예시는 NAVER API HUB 검색어 트렌드 API 를 활용하는 방법을 보여줍니다.

curl -s -X POST "https://naverapihub.apigw.ntruss.com/search-trend/v1/search" \
  -H "X-NCP-APIGW-API-KEY-ID: YOUR_CLIENT_ID" \
  -H "X-NCP-APIGW-API-KEY: YOUR_CLIENT_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"startDate":"2026-05-01","endDate":"2026-05-31","timeUnit":"week","keywordGroups":[{"groupName":"서울","keywords":["서울"]}]}'

응답 예시:

{
  "startDate": "2026-04-27",
  "endDate": "2026-05-31",
  "timeUnit": "week",
  "results": [
    {
      "title": "서울",
      "keywords": [
        "서울"
      ],
      "data": [
        {
          "period": "2026-04-27",
          "ratio": 84.85883
        },
        {
          "period": "2026-05-04",
          "ratio": 71.07901
        },
        {
          "period": "2026-05-11",
          "ratio": 75.6752
        },
        {
          "period": "2026-05-18",
          "ratio": 78.27971
        },
        {
          "period": "2026-05-25",
          "ratio": 100
        }
      ]
    }
  ]
}

월별 숫자가 나오면 환경 세팅 완료. 안 되면 키 전파(2시간)·헤더(User-Agent) 누락을 의심.

🔑
환경 세팅의 본질
한 번 만든 폴더·키·.env는 다음 주제도 그대로 재사용. "환경 세팅" 비용은 한 번 내고, 분석에 시간을 씁니다.
다음 클립
2-1 분석은 가설부터 — 좋은 가설·좋은 질문
이어보기 →