byteforce

CPN 한국어 자습서 · Claude Code in Action

2 · 직접 해보기

Claude Code 설치

Claude Code setup

이제 Claude Code를 로컬에 설치할 차례입니다. 운영체제에 맞는 설치 명령 한 줄을 실행하고, claude 명령으로 처음 실행하면 색 테마를 고르고 claude.ai 계정으로 로그인하면 끝입니다.

전체 내레이션영상 나레이션 한국어 번역 (전체)

Stephen Grider · 강사

이제 Claude Code를 직접 써 볼 수 있게 로컬 환경에 설치할 차례입니다. 전체 설치 안내는 공식 문서(code.claude.com/docs/en/quickstart)에 자세히 정리돼 있으니, 막히는 부분이 있으면 그곳을 먼저 확인하시면 됩니다.

설치는 운영체제에 맞는 명령 한 줄이면 됩니다. macOS·Linux·WSL에서는 curl 스크립트를, Windows에서는 PowerShell 또는 명령 프롬프트(cmd.exe)용 명령을 씁니다. macOS에서 Homebrew를 쓰신다면 brew로도 설치할 수 있습니다.

설치가 끝나면 터미널에서 claude 명령을 실행합니다. 처음 실행할 때는 터미널에서 쓸 색 테마를 고르라는 안내가 나오고, 이어서 claude.ai 계정으로 로그인(인증)하는 절차가 진행됩니다.

설치했는데도 claude 명령을 찾을 수 없다는 오류가 난다면, 문서의 설치 문제 해결(Troubleshoot installation issues) 항목을 참고하시면 됩니다. 또 Amazon Bedrock, Google Cloud Vertex AI, Microsoft Foundry를 통해 Claude Code를 쓰신다면 별도의 공급자 설정 안내를 따라야 합니다.

이 장에서 배우는 것What you'll learn

약 4분
1

설치 = 운영체제에 맞는 명령 한 줄

2

macOS·Linux·WSL은 curl 설치 스크립트

3

Windows는 PowerShell irm 또는 cmd curl

4

설치 후 claude 실행 → 색 테마 선택

5

이어서 claude.ai 계정으로 로그인

6

오류 시 문서의 설치 문제 해결 참고

먼저 짚고 갈 용어
Claude Code
터미널에서 동작하는 코딩 어시스턴트. 설치 후 claude 명령으로 실행한다.
WSL
Windows에서 리눅스 환경을 쓰게 해 주는 기능(Windows Subsystem for Linux). 이때는 Linux용 명령을 쓴다.
Homebrew
macOS의 패키지 관리자. brew install로 프로그램을 설치한다.
인증(authenticate)
claude.ai 계정으로 로그인해 Claude Code 사용 권한을 연결하는 단계.

1단계 — Claude Code 설치

Install Claude Code

운영체제에 맞는 명령 한 줄이면 설치가 끝납니다. 아래에서 자신의 환경 탭을 눌러 명령을 확인하세요. 전체 안내는 code.claude.com/docs/en/quickstart에 있습니다.

설치 명령 · 운영체제 탭을 눌러 보세요

2단계 — 처음 실행 & 로그인

Run & authenticate

설치가 끝나면 터미널에서 claude를 실행합니다. 처음 실행할 때만 색 테마를 고르고 계정으로 로그인하는 절차가 진행됩니다.

STEP 1

claude 실행

터미널에 claude 입력 후 실행합니다.

STEP 2

색 테마 선택

터미널에서 쓸 색 테마를 하나 고릅니다.

STEP 3

계정 인증

claude.ai 계정으로 로그인해 사용을 시작합니다.

참고

두 번째 실행부터는 이 과정을 건너뛰고 바로 Claude Code가 켜집니다.

막혔다면 & 정리

Troubleshooting & recap
자주 겪는 상황
  • 설치 후 claude 명령을 찾을 수 없다는 오류 → 문서의 설치 문제 해결(Troubleshoot installation issues) 항목을 참고합니다.
  • Amazon Bedrock · Google Cloud Vertex AI · Microsoft Foundry를 통해 쓰는 경우 → 공급자별 설정 안내를 추가로 따릅니다.
  • 전체 설치 안내는 항상 code.claude.com/docs/en/quickstart에서 최신본을 확인할 수 있습니다.
핵심 정리
  • 설치 = 운영체제에 맞는 명령 한 줄(curl · irm · brew).
  • 설치 후 claude 실행 → 색 테마 선택 → claude.ai 계정 로그인.
  • 처음 한 번만 테마·로그인을 거치고, 이후엔 바로 실행된다.

Q1Windows PowerShell에서 Claude Code를 설치하는 명령은?

Q2claude를 처음 실행하면 어떤 절차가 진행되나요?