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

Overview

Chapter 1 의 마지막 레슨에서 Claude Code가 Terminal-native 이고 프로그래밍 가능한 Agent 임을 살펴봤습니다. 이제 이 Agent를 내 컴퓨터에서 직접 깨워볼 차례입니다.

이번 레슨에서는 Claude Code를 설치하고 로그인하는 과정부터, 요금제별로 어떻게 사용량이 다른지, 그리고 Opus·Sonnet·Haiku 세 모델을 어떤 작업에 골라 쓰는지까지 다룹니다. 마치면 첫 대화를 시작할 준비가 됩니다.

학습 목표

• Claude Code를 설치하고 Anthropic 계정으로 로그인합니다.
• 내 요금제가 Claude Code를 어떻게 제공하는지, 사용량 한도는 어떻게 동작하는지 이해합니다.
• Opus·Sonnet·Haiku 세 모델의 성격을 이해하고, 작업에 맞춰 골라 쓸 수 있습니다.

시작하기 전 확인사항

• VS Code 설치 (https://code.visualstudio.com)
• 터미널 (macOS Terminal, Windows PowerShell, Linux Terminal)
• 지원 OS: macOS 13.0+, Ubuntu 20.04+, Windows 10 1809+
• Anthropic 계정 (사전 준비사항 참조)

설치와 첫 실행

Claude Code는 터미널에서 한 줄 스크립트로 설치됩니다. 설치 후 claude 를 실행하면 브라우저가 열리면서 계정 연동이 이어집니다.

설치 방식은 두 갈래가 있습니다. 처음 쓰는 분이라면 설치 스크립트를 권장하고, macOS에서 Homebrew·Windows에서 WinGet을 이미 쓰고 있다면 패키지 매니저 쪽이 업데이트 관리까지 편합니다.

macOS·Linux·WSL

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

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

Windows

PowerShell에서 다음을 실행합니다.

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

패키지 매니저로 설치

# macOS/Linux - Homebrew
brew install --cask claude-code

# Windows - WinGet
winget install Anthropic.ClaudeCode

설치가 끝나면 버전을 확인해 설치 여부를 점검합니다.

claude --version

첫 실행: 브라우저가 열리면 로그인

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

claude

처음 실행하면 브라우저가 자동으로 열립니다. 사전 준비에서 등록한 Anthropic 계정으로 로그인하면 인증이 끝납니다. 이 과정은 처음 한 번만 필요하고, 이후에는 로그인 상태가 그대로 유지됩니다.

로그인을 마치면 다시 터미널로 돌아와 Claude Code 프롬프트를 받게 됩니다. 여기서부터 대화를 시작하면 됩니다.

요금제별 Claude Code

Claude Code는 Anthropic 계정 권한 안에서 동작합니다. 같은 claude 명령이라도 어느 요금제로 로그인했는지에 따라 쓸 수 있는 모델, 사용량 한도, 팀원 관리 방식이 달라집니다.

세 가지 요금제

• Pro: 개인 개발자용. Claude Code를 쓸 수 있지만 Opus 사용량 한도가 Max보다 타이트합니다. 가볍게 쓰기에는 충분합니다.
• Max: 고빈도 사용자용. Opus 한도가 넉넉해 실습량이 많거나 하루 종일 붙어 쓰는 분에게 맞습니다.
• Team: 조직 단위. 관리자가 멤버를 초대하고 멤버별 사용량이 관리됩니다.

가볍게 쓰는 개인은 Pro, 매일 본격적으로 쓰는 개인은 Max, 회사 단위 도입은 Team을 선택합니다.

사용량 한도 관리

Claude Code는 두 가지 한도를 함께 적용합니다.

• 세션 한도: 5시간 rolling window. 토큰을 쓴 시점부터 정확히 5시간 후 그 토큰부터 차례로 풀립니다.
• 주간 한도: 7일 rolling window. Sonnet과 Opus가 별도로 측정되므로 Opus를 무겁게 쓰면 Sonnet 한도가 남아 있어도 Opus만 막힐 수 있습니다.

정확한 수치는 빠르게 바뀌므로 Anthropic 공식 문서를 참조하세요.

Opus·Sonnet·Haiku 세 모델

Claude Code에는 세 모델이 준비되어 있습니다. 모든 작업에 가장 비싼 모델을 쓸 필요는 없습니다. 작업의 난이도에 따라 모델을 바꿔 가며 쓰면 품질과 비용을 함께 조절할 수 있습니다.

Opus: 아키텍처 설계와 대규모 리팩토링

Opus는 가장 강력한 모델입니다. 여러 파일에 걸친 어려운 버그, 큰 구조 변경, 설계 결정이 섞여 있는 작업처럼 깊은 추론이 필요한 자리에 씁니다. 속도가 상대적으로 느리고 비용이 높으므로, 단순한 작업에 쓰면 낭비가 됩니다.

Sonnet: 기본값으로 삼기 좋은 균형점

Sonnet은 성능과 비용의 균형이 잘 잡힌 모델입니다. 일반적인 기능 구현, 코드 리뷰, 테스트 작성 같은 일상 개발 작업의 기본값으로 두기 가장 무난합니다. 특별한 이유가 없다면 Sonnet으로 시작해도 좋습니다.

Haiku: 단순 수정과 빠른 질문

Haiku는 가장 빠르고 저렴한 모델입니다. 파일 이름 변경, 짧은 코드 수정, 간단한 질문처럼 복잡한 추론이 필요 없는 작업에 적합합니다. 응답 속도가 매우 빠르지만, 복잡한 문제에서는 품질이 떨어집니다.

모델 전환: /model, --model

세션 도중에 모델을 바꾸려면 /model 명령을 씁니다.

/model sonnet
/model opus
/model haiku

세션을 시작할 때 처음부터 특정 모델로 들어갈 수도 있습니다.

claude --model opus

모델을 바꿔도 이전 대화 맥락(Context)은 그대로 이어집니다. 같은 세션에서 "설계 단계는 Opus, 구현 단계는 Sonnet"처럼 바꿔 쓰는 흐름이 가능합니다.

Opus 계획 + Sonnet 구현 전략

세 모델을 처음부터 자유자재로 섞어 쓰기는 어렵습니다. 먼저 다음 조합을 기본 전략으로 잡으면 흔들림이 줄어듭니다.

1. 문제 파악과 계획 수립은 Opus: 여러 파일을 탐색하고 접근 방식을 결정하는 단계. 여기서 실수하면 이후 구현이 전부 어긋나므로 품질을 우선합니다.
2. 구현과 반복 실행은 Sonnet: 계획이 정해진 뒤 코드를 고치고 테스트를 돌리는 단계. 속도와 비용이 현실적으로 중요해집니다.
3. 단순 작업은 Haiku: 파일명 변경, 짧은 질문, 반복 작업. 굳이 무거운 모델을 쓰지 않습니다.

이 흐름이 익숙해지면 자신만의 조합을 찾게 됩니다. 처음에는 이 기준으로 충분합니다.

Pro 구독자에게 유용한 두 명령

Pro 한도에서 Opus를 효율적으로 빌려 쓰는 패턴이 두 가지 준비돼 있습니다. 둘 다 평소엔 Sonnet으로 진행하다가 필요한 순간에만 Opus를 부르는 흐름입니다.

• /model opusplan (단계 기반): Plan Mode를 켤 때만 Opus, 평소에는 Sonnet으로 자동 전환됩니다. "계획 단계만 Opus" 라는 룰이 명확합니다. Plan Mode는 Chapter 04에서 자세히 다룹니다.
• /advisor (신호 기반, experimental): Sonnet으로 진행하다 복잡한 결정·반복 오류·작업 정체가 감지되면 Sonnet이 Opus를 자문역으로 호출합니다. 명령을 실행하면 모델 선택 프롬프트가 떠 advisor 로 쓸 모델(Opus 권장)을 고르게 됩니다.

opusplan은 계획 단계가 분명한 작업에, advisor는 어디서 막힐지 모르는 탐색적 작업에 잘 맞습니다.

FAQ

• Q: 사용량 제한에 걸리면 어떻게 되나요?

  • A: 일시적으로 대기 상태가 됩니다. 일정 시간이 지나면 다시 사용할 수 있습니다. 제한에 자주 걸린다면 Chapter 03에서 배울 Context 관리와 Task Sizing이 직접적인 해답입니다.

• Q: 모델을 대화 중간에 바꿀 수 있나요?

  • A: 네. /model sonnet 처럼 세션 안에서 언제든 변경할 수 있고 이전 대화 맥락은 유지됩니다. 설계는 Opus로 시작하고, 구현은 Sonnet으로 전환하는 식의 활용이 자연스럽습니다.

• Q: Terminal CLI와 VS Code Extension 중 어떤 걸 써야 하나요?

  • A: 둘 다 같은 기능을 제공합니다. 터미널에 익숙하면 CLI가 빠르고, GUI를 선호하면 Extension이 편합니다. 둘 다 설치해두고 상황에 맞춰 써도 좋습니다.

• Q: Opus가 더 깊이 생각하게 만드는 옵션도 있나요?

  • A: 네. /effort 명령으로 Opus의 추론 예산을 조절할 수 있습니다. 다만 이 레슨 범위를 벗어나는 고급 옵션이라 Chapter 04 Plan Mode와 함께 다룹니다.

이어서 배울 내용

Claude Code 설치와 로그인, 요금제 이해, 모델 선택까지 마쳤습니다. 설치는 끝났지만 자연어 한 줄이 실제 코드를 어떻게 움직이는지는 직접 써봐야 감이 잡힙니다. 다음 레슨에서는 Todo 앱을 받아 다섯 번의 대화로 첫 개발 사이클을 한 번에 돌려 봅니다.

• 한 코드 사이클: 읽기 → @ 파일 첨부 → README 수정 → 실수 복구 → git 커밋
• 권한 승인 흐름과 Always allow 의 위험성
• Esc+Esc 와 Checkpoint 로 잘못된 변경 되돌리기