Claude Code 설치 방법 윈도우 맥 설치와 첫 실행

🚀

Claude Code 사용하기 2강

3분이면 설치 완료. 터미널에서 바로 시작할 수 있습니다.

설치 전 체크사항

🖥️
지원 OS

macOS, Linux, Windows

📦
Git 설치

Windows는 Git for Windows 필수

👤
Claude 계정

claude.ai에서 가입 (유료 구독 또는 API 키)

설치 방법

macOS / Linux

터미널에서 한 줄로 설치

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

Windows (PowerShell)

PowerShell에서 설치

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

PATH 환경변수 등록 (설치 후 claude 명령이 안 될 때)

[Environment]::SetEnvironmentVariable(
  "PATH",
  "$env:PATH;$env:USERPROFILE\.local\bin",
  [EnvironmentVariableTarget]::User
)

기타 Windows 설치 방법

명령 프롬프트 (CMD)

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

WinGet

winget install Anthropic.ClaudeCode
⚠️

예전에는 npm install로 설치했지만 현재는 더 이상 권장하지 않습니다. 위의 공식 설치 방법을 사용하세요.

설치 확인

버전 확인

claude --version

✅ 버전 번호가 출력되면 설치 성공!

첫 실행

1
프로젝트 폴더로 이동

Claude Code는 “현재 폴더”를 기준으로 파일을 인식합니다

2
claude 명령 실행

PowerShell, CMD, Git Bash 어디서든 가능

3
로그인

처음 실행하면 로그인 화면이 나옵니다. Claude 계정으로 로그인하세요

첫 실행

# 프로젝트 폴더로 이동
cd 내프로젝트폴더

# Claude Code 실행
claude

프로젝트 초기 설정

⚙️

처음 사용하는 프로젝트라면 /init을 실행하세요

프로젝트를 분석해서 CLAUDE.md 파일을 자동으로 만들어줍니다. 이 파일이 있으면 Claude가 프로젝트 구조와 규칙을 항상 참고합니다.

초기 설정 자동 생성

/init

첫 대화 해보기

🔍
프로젝트 파악
이 프로젝트가 뭐하는 건지 설명해줘
📄
파일 설명
src/App.vue 파일이 뭐하는 건지 알려줘
✏️
간단한 수정
README 파일에 프로젝트 설명 추가해줘

팁: @ 문법을 사용하면 특정 파일을 콕 집어서 컨텍스트에 포함시킬 수 있습니다. 예: @src/router.js 이 파일 기준으로 수정해줘

다양한 실행 방법

기본 대화형
claude
질문과 함께 바로
claude "폴더 구조 설명해줘"
지난 대화 이어서
claude --continue
모델 지정
claude --model opus

공식 문서: OS별 상세 설치 방법은 Claude Code 공식 문서에서 확인할 수 있습니다.