Vynn LeeVynn Lee

Claude Code 실습을 위한 사전 준비 가이드라인

Vynn Lee

Claude Code 실습에 필요한 Claude Desktop, Node.js와 공공데이터 OpenAPI 인증키를 준비하는 방법을 안내합니다.

이 문서는 Claude Code 실습을 시작하기 전에 필요한 환경과 공공데이터 OpenAPI 인증키를 준비하는 가이드입니다. 아래 단계를 순서대로 완료해 주세요.

전체 준비 순서

  1. 노트북과 설치 권한을 확인합니다.
  2. Claude Desktop을 설치합니다.
  3. Node.js와 npm을 설치합니다.
  4. KOSIS OpenAPI 인증키를 발급합니다.
  5. 서울 열린데이터광장 OpenAPI 인증키를 발급합니다.
  6. 최종 체크리스트를 확인합니다.

1. 준비사항 확인

다음 항목을 준비해 주세요.

  • macOS 11 이상 또는 Windows 10 이상의 개인 노트북
  • 노트북 충전기
  • 안정적인 인터넷 연결
  • 프로그램 설치 권한 또는 노트북 관리자 암호
  • 이메일 및 휴대전화 본인인증 수단
  • 최신 버전의 웹 브라우저(Chrome 권장)

2. Claude Desktop 설치

Claude Code는 Claude Desktop 앱의 Code 탭에서 실행합니다. 별도의 Claude Code CLI를 설치할 필요는 없습니다.

Claude Desktop 공식 다운로드

macOS

  1. Claude Desktop 공식 다운로드를 여세요.
  2. macOS용 설치 파일을 다운로드하세요.
  3. 다운로드한 설치 파일을 열고 화면의 안내에 따라 설치하세요.
  4. Finder의 응용 프로그램에서 Claude를 실행하세요.
  5. 메뉴 막대에서 Claude > Check for Updates를 선택해 최신 버전인지 확인하세요.

macOS용 설치 파일은 Intel Mac과 Apple Silicon Mac을 모두 지원합니다.

Windows

시스템 종류 확인

  1. 설정 > 시스템 > 정보를 여세요.
  2. 시스템 종류에서 x64 기반 또는 ARM 기반 여부를 확인하세요.

앱 설치

  1. Claude Desktop 공식 다운로드를 여세요.
  2. Intel·AMD 기반 PC는 Windows x64를 다운로드하세요.
  3. ARM 기반 PC는 Windows ARM64를 다운로드하세요.
  4. 설치 파일을 실행하고 화면의 안내에 따라 설치하세요.
  5. 시작 메뉴에서 Claude를 실행하세요.
  6. Help > Check for Updates를 선택해 최신 버전인지 확인하세요.

Git for Windows 설치

Windows에서 Claude Code의 로컬 세션을 사용하려면 Git for Windows가 필요합니다.

  1. Git for Windows 공식 다운로드를 여세요.
  2. 사용 중인 PC에 맞는 설치 파일을 다운로드하세요.
  3. 설치 옵션은 기본값으로 진행하세요.
  4. 설치가 끝나면 Claude Desktop을 완전히 종료한 뒤 다시 실행하세요.

3. Node.js와 npm 설치

Node.js는 Claude Code가 아니라 Next.js 프로젝트를 실행하기 위해 필요합니다. Next.js는 Node.js 20.9 이상을 요구합니다.

Node.js 공식 다운로드

macOS

  1. Node.js 공식 다운로드를 여세요.
  2. 사용 중인 Mac에 맞는 아키텍처와 macOS가 선택되어 있는지 확인하세요.
  3. 하단 설치 프로그램을 직접 다운로드하여 설치를 진행해 주세요.
Node.js 다운로드 페이지의 macOS 설치 프로그램 다운로드 버튼
  1. 다운로드한 macOS 설치 프로그램 (.pkg)을 실행하고 기본 안내에 따라 설치하세요.
  2. Claude Desktop을 다시 실행하세요.

Windows

  1. Node.js 공식 다운로드를 여세요.
  2. 사용 중인 PC에 맞는 아키텍처와 Windows가 선택되어 있는지 확인하세요.
  3. 하단 설치 프로그램을 직접 다운로드하여 설치를 진행해 주세요.
Node.js 다운로드 페이지의 Windows 설치 프로그램 다운로드 버튼
  1. 다운로드한 Windows 설치 프로그램 (.msi)을 실행하고 기본 안내에 따라 설치하세요.
  2. Claude Desktop을 다시 실행하세요.

설치 확인

Claude Code의 통합 터미널에서 다음 명령을 각각 실행하세요.

node -v
npm -v

다음 두 결과를 확인하세요.

  • node -v: v20.9.0 이상의 버전이 표시됩니다.
  • npm -v: npm 버전 번호가 표시됩니다.

Windows PowerShell에서 npm.ps1 실행 정책 오류가 발생하면 명령 프롬프트에서 같은 명령을 다시 실행하세요.

4. KOSIS OpenAPI 인증키 발급

KOSIS OpenAPI를 사용할 경우 개인 인증키를 발급해 주세요.

KOSIS 공유서비스

  1. KOSIS 사이트에서 회원가입을 선택하세요.
  2. 약관 동의, 본인 확인, 회원정보 입력을 완료하세요.
  3. 가입한 계정으로 로그인하세요.
  4. 공유서비스의 활용신청 또는 OPEN API 인증키 신청으로 이동하세요.
  5. 활용용도와 사용목적을 입력하세요.
  6. 이용약관에 동의하고 신청을 등록하세요.
  7. 신청현황에서 승인 상태와 인증키를 확인하세요.
  8. 인증키를 비공개 메모에 저장하세요.

신청 정보는 다음 예시를 참고해 입력할 수 있습니다.

입력 항목입력 예시
활용용도대학 연구
사용목적대학 연구를 위한 목적으로 신청합니다.

KOSIS 활용신청은 자동 승인 방식입니다. 실습 시작 전에 발급 상태를 반드시 확인해 주세요.

5. 서울 열린데이터광장 OpenAPI 인증키 발급

서울 열린데이터광장 OpenAPI를 사용할 경우 개인 인증키를 발급해 주세요.

서울 열린데이터광장

  1. 서울 열린데이터광장에서 로그인을 선택하세요.
  2. 계정이 없다면 서울시 누리집 회원가입과 본인인증을 완료하세요.
  3. 가입한 계정으로 로그인하세요.
  4. 나의 화면 > 인증키 신청으로 이동하세요.
  5. 활용 목적 등 신청 정보를 입력하세요.
  6. 신청을 완료하고 발급 상태를 확인하세요.
  7. 발급된 인증키를 비공개 메모에 저장하세요.

신청 정보는 다음 예시를 참고해 입력할 수 있습니다.

입력 항목입력 예시
활용용도대학 연구
사용목적대학 연구를 위한 목적으로 신청합니다.

메뉴를 찾기 어렵다면 OpenAPI 인증키 안내를 확인하세요.

6. API 인증키 보관

OpenAPI 인증키는 비밀번호와 동일하게 관리해 주세요.

  • 인증키 원문을 타인 또는 외부에 공유하지 마세요.
  • 인증키는 텍스트 파일, 메모장 또는 별도의 프로그램에 잘 보관해주세요.

7. 최종 체크리스트

실습 시작 전에 다음 항목을 모두 확인해 주세요.

  • Claude Desktop이 정상적으로 실행됩니다.
  • node -v가 v20.9.0 이상의 버전을 표시합니다.
  • npm -v가 버전 번호를 표시합니다.
  • KOSIS OpenAPI 인증키가 발급되었습니다.
  • 서울 열린데이터광장 OpenAPI 인증키가 발급되었습니다.
  • 두 인증키를 비공개로 보관했습니다.
  • 노트북 충전기를 준비했습니다.

문제 해결

설치 또는 실행 과정에서 오류가 발생하면 다음 정보를 운영진에게 전달해 주세요.

  1. 사용 중인 운영체제와 버전
  2. 문제가 발생한 단계
  3. 실행한 명령 또는 선택한 메뉴
  4. 전체 오류 메시지가 보이는 화면 캡처

화면에 API 인증키나 비밀번호가 보인다면 반드시 가린 뒤 전달해 주세요.

공식 참고 문서

다른 글 살펴보기