사전 준비사항

강의 첫날 전까지 아래 항목을 모두 준비해 주세요.

각 항목의 설치 방법을 아래에서 안내합니다.

1. Git

Git은 코드 버전 관리 도구입니다. 실습 코드를 받아오거나 작업 내용을 저장할 때 사용합니다.

공식 문서: git-scm.com

macOS

macOS에는 Git이 기본으로 설치되어 있는 경우가 많습니다. 터미널에서 git --version으로 설치 여부를 확인합니다. 설치되어 있지 않으면 Xcode Command Line Tools 설치를 안내하는 팝업이 나타납니다. Install을 클릭하면 Git이 자동으로 설치됩니다.

Windows

git-scm.com/downloads에서 Windows 설치 파일을 다운로드하고 실행합니다. 설치 중 옵션이 나오면 기본값(Next)으로 넘어가면 됩니다.

설치 확인

터미널에서 다음 명령어를 실행합니다.

git --version

아래와 같이 버전 번호가 표시되면 정상입니다.

git version 2.47.1

2. Node.js (npm 포함)

Node.js는 JavaScript 런타임이며, 설치하면 패키지 매니저인 npm과 패키지 실행 도구인 npx가 함께 설치됩니다. 강의에서 다루는 MCP 서버 설치와 일부 보조 도구는 npx로 실행되므로 반드시 설치해 주세요.

공식 문서: nodejs.org

macOS

Homebrew로 설치합니다.

brew install node

Windows

nodejs.org에서 LTS 버전을 다운로드하고 설치합니다. 설치 중 옵션이 나오면 기본값(Next)으로 넘어가면 됩니다.

설치 확인

터미널에서 다음 명령어를 실행합니다.

node --version
npm --version

아래와 같이 버전 번호가 표시되면 정상입니다.

v22.14.0
10.9.2

3. Bun

Bun은 빠른 JavaScript 런타임이자 패키지 매니저입니다. 이 강의에서 프로젝트 생성과 실행에 사용합니다.

npm 대비 패키지 설치가 수 배 빠르고, bun run 한 줄로 TypeScript 파일을 바로 실행할 수 있어 실습 흐름을 끊지 않습니다.

공식 문서: bun.com/docs/installation

macOS

Homebrew로 설치합니다.

brew install oven-sh/bun/bun

Windows

VS Code를 열고 터미널(Ctrl+``)에서 실행합니다. 터미널이 **PowerShell**인지 확인하세요. 터미널 탭에 "powershell" 또는 "pwsh"가 표시되어야 합니다. 다른 셸(cmd 등)이 표시된다면 터미널 우측 상단의 +` 옆 드롭다운에서 PowerShell을 선택합니다.

irm bun.sh/install.ps1 | iex

설치가 완료되면 VS Code 터미널을 닫았다가 다시 열어야 bun 명령어를 인식합니다.

설치 확인

터미널에서 다음 명령어를 실행합니다.

bun --version

아래와 같이 버전 번호가 표시되면 정상입니다.

1.2.5

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

[System.Environment]::SetEnvironmentVariable(
  "Path",
  [System.Environment]::GetEnvironmentVariable("Path", "User") + ";$env:USERPROFILE\.bun\bin",
  [System.EnvironmentVariableTarget]::User
)

4. VS Code

VS Code는 이 강의에서 사용하는 코드 편집기입니다. Claude Code를 VS Code 내장 터미널에서 실행합니다.

공식 문서: code.visualstudio.com

위 사이트에 접속하면 운영체제에 맞는 버전이 자동으로 안내됩니다. 다운로드 후 설치합니다.

설치 확인

설치 후 VS Code 를 실행하면 환영 화면이 표시됩니다.

5. GitHub CLI

GitHub CLI(gh)는 터미널에서 Pull Request 생성, 이슈 관리 등 GitHub 작업을 할 수 있는 도구입니다. Claude Code가 코드를 push한 뒤 PR을 자동으로 생성하려면 gh가 필요합니다.

공식 문서: cli.github.com

macOS

brew install gh

Windows

VS Code를 열고 터미널(`Ctrl+``)에서 실행합니다.

winget install --id GitHub.cli

설치 확인

터미널에서 다음 명령어를 실행합니다.

gh --version

아래와 같이 버전 번호가 표시되면 정상입니다.

gh version 2.67.0 (2025-01-13)

추가 설정

설치 후 다음 명령어로 GitHub 계정 인증을 마칩니다.

gh auth login

브라우저가 열리며 GitHub 로그인을 요청합니다. 로그인하면 터미널에서 gh 명령어를 사용할 수 있습니다.

6. Anthropic 계정

Claude Code를 사용하려면 Anthropic 계정과 유료 구독이 필요합니다. 이 강의는 실습을 원활하게 진행할 수 있도록 Claude Team 요금제를 제공합니다. 아래 순서로 계정을 만드세요.

1. 회사 이메일 계정에 접속해 Anthropic이 보낸 팀 플랜 초대 메일을 확인합니다

2. 해당 이메일의 Accept invite 링크를 사외에서 열어 Claude 회원가입 및 Team 등록을 완료합니다

7. Claude Code

Claude Code는 터미널에서 실행되는 AI 코딩 도구입니다. 이 강의의 핵심 도구이므로 반드시 설치해 주세요.

공식 문서: code.claude.com/docs/ko/overview

macOS

터미널을 열고 다음 명령어를 실행합니다.

curl -fsSL https://claude.ai/install.sh | bash

Homebrew를 사용한다면 이 방법도 가능합니다.

brew install --cask claude-code

Windows

VS Code를 열고 터미널(`Ctrl+``)에서 실행합니다. 터미널이 PowerShell인지 확인하세요.

irm https://claude.ai/install.ps1 | iex

설치가 완료되면 VS Code 터미널을 닫았다가 다시 열어야 claude 명령어를 인식합니다.

설치 확인

터미널에서 다음 명령어를 실행합니다.

claude --version

아래와 같이 버전 번호가 표시되면 정상입니다.

1.0.33 (Claude Code)

claude : 'claude' 용어가 cmdlet, 함수, 스크립트 파일 또는 실행할 수 있는 프로그램 이름으로 인식되지 않습니다.

irm https://claude.ai/install.ps1 | iex

추가 설정

설치 후 처음 claude를 실행하면 브라우저가 열리며 Anthropic 계정 인증을 요청합니다. 6번에서 만든 계정으로 로그인하면 됩니다. 인증은 처음 한 번만 합니다.

설치 상태를 종합 점검하려면 다음 명령어를 사용합니다.

claude doctor

최종 체크리스트

모든 설치가 끝났다면, VS Code 터미널에서 아래 명령어를 한 줄씩 실행해 최종 확인합니다.

git --version
node --version
bun --version
gh --version
claude --version

다섯 명령어 모두 버전 번호가 출력되면 준비 완료입니다.

git version 2.47.1
v22.14.0
1.2.5
gh version 2.67.0 (2025-01-13)
1.0.33 (Claude Code)