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

Overview

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

학습 목표

• Claude Code를 설치하고 Anthropic 계정으로 로그인합니다.
• 내 계정에서 사용할 수 있는 모델과 현재 사용량 한도를 확인합니다.
• 내 계정에서 사용할 수 있는 모델 중 작업의 난이도와 길이에 맞는 모델을 고르고 전환합니다.

시작하기 전 확인사항

• 이 강의에서는 VS Code를 설치하고 통합 터미널을 열 수 있는지 확인합니다.
• Claude Pro·Max 또는 조직의 Team·Enterprise 계정으로 로그인할 수 있는지 확인합니다.
• macOS와 Windows의 최소 지원 버전과 시스템 요구사항은 Claude Code 공식 문서에서 확인합니다.

설치하고 첫 세션 열기

Step 1: 터미널 열기

VS Code 상단 메뉴에서 Terminal > New Terminal을 선택합니다. 이미 터미널을 열었다면 Ctrl+`로 터미널 패널을 표시하거나 숨길 수 있습니다.

Windows에서는 프롬프트가 PS로 시작하는지 확인합니다. cmd가 열렸다면 터미널 오른쪽 위 드롭다운에서 PowerShell 프로필을 선택해 새 터미널을 엽니다.

Step 2: Claude Code 설치하기

Anthropic은 자동 업데이트되는 네이티브 설치 스크립트를 권장합니다. 패키지 관리자를 사용하려면 Homebrew나 WinGet으로도 설치할 수 있지만, 이후 업데이트는 각 패키지 관리자에서 직접 실행해야 합니다.

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

brew install --cask claude-code

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

winget install Anthropic.ClaudeCode

설치가 끝나면 새 터미널을 엽니다. 새 터미널에서도 claude 명령을 찾지 못하면 설치 완료 메시지의 Setup notes에 따라 PATH를 반영합니다.

Step 3: 설치 확인하기

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

claude --version

Step 4: 첫 실행과 로그인

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

claude

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

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

작업에 맞는 모델 고르기

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

모델별로 잘하는 작업 비교하기

• Haiku: 결과가 분명하고 빠르게 끝낼 수 있는 단순 작업에 씁니다. 파일 이름 변경, 짧은 코드 수정, 간단한 질문처럼 복잡한 판단이 필요 없는 작업에 적합합니다.
• Sonnet: 요구사항이 비교적 명확한 일상 개발 작업에 씁니다. 일반적인 기능 구현, 코드 리뷰, 테스트 작성에 두루 잘 맞습니다.
• Opus: 복잡한 판단, 모호한 문제, 어려운 디버깅에 씁니다. 여러 파일에 걸친 버그, 큰 구조 변경, 설계 결정이 섞인 작업처럼 깊은 추론이 필요한 자리에 적합합니다.
• Fable: 한 번에 끝내기 어려운 장기·자율 작업에 고려합니다. 모든 작업에서 Opus보다 나은 선택은 아니며 비용과 사용량 부담이 더 큽니다.

처음부터 운영 방식을 정할 필요는 없습니다. 현재 선택된 모델로 시작하고, 단순 작업은 Haiku, 복잡한 판단은 Opus, 한 번에 끝내기 어려운 장기 자율 작업은 Fable을 고려합니다.

요금제와 조직 설정이 바꾸는 모델·사용량 범위

사용할 수 있는 모델과 사용량 한도는 로그인한 계정의 요금제·좌석 종류·조직 관리자 설정에 따라 달라집니다. /model에서 현재 선택할 수 있는 모델을 확인합니다.

/usage로 사용량 확인하기

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

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

/model로 모델 전환하기

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

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

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

claude --model opus

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

핵심 포인트 정리

1. 설치와 첫 실행: 운영체제에 맞는 설치 명령을 실행하고 Anthropic 계정으로 로그인하면 첫 세션을 열 수 있습니다.
2. 요금제와 모델 범위: 요금제와 조직 설정에 따라 선택할 수 있는 모델과 사용량 범위가 달라집니다.
3. 모델 운영: /model에서 사용할 수 있는 모델을 확인하고 작업의 난이도와 길이에 따라 전환합니다.

FAQ

이어서 배울 내용

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

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