첫 대화 시작하기 | Claude Code 설치와 실행

Overview

Claude Code에는 빠른 작업부터 장기 자율 작업까지 서로 다른 모델이 있습니다. 가장 강력한 모델을 계속 쓰기보다 작업의 난이도, 길이, 사용 한도에 맞춰 고르는 것이 중요합니다. 이 레슨에서는 설치와 로그인을 마치고 내 작업에 맞는 모델을 선택합니다.

학습 목표

• Claude Code를 설치하고 Anthropic 계정으로 로그인합니다.
• 내 계정의 기본 모델과 사용량 한도를 확인합니다.
• 작업의 난이도와 길이에 따라 모델을 고르고 전환합니다.

시작하기 전 확인사항

• VS Code를 설치하고 터미널을 열 수 있는지 확인합니다.
• Anthropic 계정으로 로그인할 수 있는지 확인합니다.
• macOS와 Windows의 최신 지원 버전은 Claude Code 공식 문서에서 확인합니다.

설치와 첫 실행

Step 1: 터미널 열기

VS Code에서 따라 한다면 상단 메뉴에서 Terminal > New Terminal을 선택합니다. 단축키는 Ctrl+` 입니다.

Windows에서는 터미널 탭에 PowerShell 또는 pwsh가 보이는지 확인합니다. cmd가 열렸다면 터미널 오른쪽 위 드롭다운에서 PowerShell을 선택합니다.

Step 2: Claude Code 설치하기

사용하는 OS에 맞는 설치 명령을 터미널에 붙여 넣고 실행합니다.

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

brew install --cask claude-code

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

winget install Anthropic.ClaudeCode

Step 3: 설치 확인하기

설치가 끝나면 버전을 확인합니다.

claude --version

Step 4: 첫 실행과 로그인

터미널에서 claude 를 입력해 세션을 엽니다.

claude

처음 실행하면 로그인 안내가 나타납니다. 브라우저가 열리면 Anthropic 계정으로 로그인하고 터미널로 돌아옵니다. 대부분 이후 실행부터는 로그인 과정 없이 바로 세션이 열립니다.

로그인이 끝나면 Claude Code 입력창이 나타납니다. 이제 첫 메시지를 입력하면 됩니다.

요금제별 Claude Code

Claude Code는 Anthropic 계정 권한 안에서 동작합니다. 같은 claude 명령이라도 요금제에 따라 사용 가능한 모델, 사용량 한도, 팀원 관리 방식이 다릅니다.

요금제가 바꾸는 기본값과 사용 범위

• Pro: 기본 모델은 Sonnet입니다. Fable은 Usage Credits로 사용합니다.
• Max: 기본 모델은 Opus입니다. Fable은 주간 사용량 일부에 포함됩니다.
• Team·Enterprise: 좌석 종류와 관리자 설정에 따라 기본 모델과 Fable 사용 범위가 달라집니다.

요금제는 처음 선택되는 모델과 사용할 수 있는 범위를 정합니다. 같은 요금제에서도 작업 방식에 따라 다른 모델을 선택할 수 있습니다.

Fable의 포함 여부와 Usage Credits 적용 범위는 요금제별 Fable 제공 안내에서 확인합니다.

사용량 한도 관리

Claude Code에는 일정 시간 단위의 사용량 한도와 주간 한도가 함께 적용됩니다. 구체적인 한도와 모델별 사용량은 요금제에 따라 달라지므로 /usage에서 현재 상태와 초기화 시점을 확인합니다.

정확한 기준은 빠르게 바뀌므로 Anthropic 공식 문서도 함께 참조하세요.

작업에 맞는 모델 고르기

Claude Code 모델은 잘하는 작업이 서로 다릅니다. 가장 강한 모델을 계속 쓰기보다 작업의 난이도와 길이에 맞춰 선택하면 속도와 사용량을 함께 조절할 수 있습니다.

Haiku: 빠르게 끝나는 단순 작업

Haiku는 결과가 분명하고 빠르게 끝낼 수 있는 단순 작업에 씁니다. 파일 이름 변경, 짧은 코드 수정, 간단한 질문처럼 복잡한 판단이 필요 없는 작업에 적합합니다.

Sonnet: 일상 개발 작업

Sonnet은 요구사항이 비교적 명확한 일상 개발 작업에 씁니다. 일반적인 기능 구현, 코드 리뷰, 테스트 작성에 두루 잘 맞습니다.

Opus: 복잡하고 모호한 문제

Opus는 복잡한 판단, 모호한 문제, 어려운 디버깅에 씁니다. 여러 파일에 걸친 버그, 큰 구조 변경, 설계 결정이 섞인 작업처럼 깊은 추론이 필요한 자리에 적합합니다.

Fable: 장기 자율 작업

Fable은 한 번의 작업 시간에 끝나지 않는 장기·자율 작업에 씁니다. 범위가 큰 마이그레이션, 복잡한 구현, 여러 단계에 걸친 조사처럼 오랫동안 맥락을 유지하며 스스로 진행해야 하는 작업에 적합합니다.

Fable은 어떤 요금제에서도 자동으로 선택되는 기본 모델이 아닙니다. /model fable로 직접 선택합니다. 모델 목록에 보이지 않으면 Claude Code를 최신 버전으로 업데이트하고 계정 또는 조직의 사용 권한을 확인합니다. 공식 설치 스크립트를 사용했다면 claude update, Homebrew를 사용했다면 brew upgrade claude-code, WinGet을 사용했다면 winget upgrade Anthropic.ClaudeCode를 실행합니다.

모델 전환: /model, --model

/model 명령을 실행하면 모델 선택 목록이 열립니다. 모델을 선택하면 현재 세션에서 전환되고 이후 새 세션의 기본 모델로도 저장됩니다. 현재 세션에서만 바꾸려면 모델 선택 화면에서 s를 누릅니다.

/model haiku
/model sonnet
/model opus
/model fable

한 세션만 특정 모델로 시작하려면 --model 옵션을 사용합니다.

claude --model opus

모델을 바꿔도 현재 대화는 그대로 이어집니다.

모델 운영 방식 고르기

기본 모델은 작업을 시작하는 출발점입니다. 같은 요금제에서도 속도, 사용량, 작업의 난이도에 따라 서로 다른 방식으로 운영할 수 있습니다.

처음 사용한다면 기본값 유지형으로 시작해도 됩니다. 사용 패턴을 알기 전까지 설정을 바꾸지 않아도 된다는 뜻이며, 모든 사용자에게 가장 좋은 방식이라는 뜻은 아닙니다.

Opus를 부르는 세 가지 방법

• 직접 전환: 사용자가 어려운 작업이라고 판단하면 /model opus로 바꿉니다.
• 단계 기반 전환: opusplan은 Plan Mode에서 Opus를 사용하고 실행 단계에서 Sonnet으로 전환합니다.
• 판단 기반 전환: /advisor는 작업 중 어려운 결정이 나타났을 때 Claude가 Opus의 의견을 구합니다. 아직 실험 단계인 기능입니다.

셋을 모두 사용할 필요는 없습니다. 사용자가 직접 판단하고 싶다면 /model, 계획 단계가 중요하다면 opusplan, 작업 중 어디서 막힐지 알기 어렵다면 /advisor를 선택합니다. Plan Mode는 Chapter 4에서 자세히 다룹니다.

처음에는 계정 기본 모델로 시작하고, 실제 사용에서 속도나 품질이 아쉬운 지점을 발견한 뒤 운영 방식을 조정합니다.

핵심 포인트 정리

1. 설치와 첫 실행: 운영체제에 맞는 설치 명령을 실행하고 Anthropic 계정으로 로그인하면 첫 세션을 열 수 있습니다.
2. 요금제와 기본 모델: 요금제는 처음 선택되는 모델과 사용량 범위를 정하지만, 하나의 운영 방식만 요구하지는 않습니다.
3. 모델 운영: 계정 기본 모델로 시작하고 작업의 난이도와 길이에 따라 Haiku, Sonnet, Opus, Fable로 전환합니다.

FAQ

이어서 배울 내용

Claude Code를 설치하고 계정 기본 모델로 첫 세션을 열었습니다. 다음 레슨에서는 작은 Todo 앱을 받아 코드 읽기부터 파일 수정, 실수 복구, git 커밋까지 첫 개발 흐름을 직접 진행합니다.

• 프로젝트 파일을 읽고 @로 답변 범위를 좁힙니다.
• 파일을 수정하며 권한 요청을 확인하고 이번 파일 수정만 승인합니다.
• Esc+Esc와 Checkpoint로 잘못된 변경을 되돌립니다.
• 자연어로 변경사항을 git에 커밋합니다.