Claude Code 완벽 가이드: 요금제 선택부터 터미널 설치 및 셋업까지

안녕하세요! 오늘은 Anthropic에서 출시하여 개발 생태계에 큰 파장을 일으키고 있는 CLI 기반 AI 개발 어시스턴트, Claude Code 의 설치와 셋업 과정을 심층 분석해 보려 합니다.

단순한 챗봇을 넘어 터미널에서 코드를 직접 수정하고 실행하며, 깃허브(GitHub) 연동까지 완벽하게 수행하는 Claude Code를 내 것으로 만드는 첫 단추를 지금 함께 끼워보시죠.

1. Claude Code 요금제: 나에게 맞는 선택은?

Claude Code는 독특하게도 두 가지 결제 방식을 제공합니다. 초기 설치 시 본인의 사용 패턴에 맞는 방식을 신중하게 선택해야 합니다.

기존 Claude.ai 웹 서비스의 유료 플랜과 통합된 형태입니다. 정해진 월 사용료 내에서 이용 가능합니다.

Pro ($20/월): 소규모 개인 프로젝트용. 5시간당 약 10~40건의 메시지 제공.
Max ($100/월 ~ $200/월): 헤비 유저용. 대규모 코드베이스 작업에 적합하며, 5시간당 수백 건의 메시지를 처리할 수 있습니다.
장점: 비용 예측이 가능하며 웹 버전과 용량을 공유합니다.

사용한 만큼 비용을 지불하는 방식입니다.

💡 팁: 처음 시작한다면 이미 구독 중인 Pro 플랜 으로 시작해 보고, 부족함이 느껴지거나 대규모 배치가 필요할 때 /update 명령어를 통해 API 방식으로 전환하는 것을 추천합니다.

Claude Code는 Node.js 환경에서 동작하므로, 사전에 Node.js가 설치되어 있어야 합니다.

터미널을 열고 아래 명령어를 입력하여 전역(global) 설치를 진행합니다.

# npm을 이용한 설치
npm install -g @anthropic-ai/claude-code
 
# 설치 확인
claude --version

설치 후 터미널에 claude를 입력하면 첫 실행과 함께 인증 절차가 시작됩니다.

로그인 방식 선택: 구독형(1) 또는 API 방식(2) 중 선택합니다. (구독 중이라면 반드시 1번 선택!)
브라우저 인증: 자동으로 열리는 브라우저에서 Anthropic 계정 로그인을 진행하고 발급된 코드를 터미널에 입력합니다.
터미널 최적화: Shift + Enter로 줄바꿈을 사용할 수 있게 하는 터미널 셋업 제안에 Yes 를 선택하세요. 긴 프롬프트 작성 시 매우 유용합니다.
폴더 신뢰(Trust): 현재 작업 중인 프로젝트 폴더의 파일 접근 권한을 허용합니다.

Claude Code의 진정한 위력은 GitHub와 연동될 때 발휘됩니다. 브라우저를 켜지 않고도 이슈 생성, PR(Pull Request) 리뷰, 리포지토리 생성이 가능해집니다.

# 1. gh CLI 설치 (Mac 기준)
brew install gh
 
# 2. GitHub 인증
gh auth login
 
# 3. Claude에게 명령하기
# ❯ "현재 변경 사항으로 새 PR을 생성해줘"

Claude Code는 단순히 코드를 짜주는 도구가 아니라, 터미널이라는 개발자의 핵심 영역에서 환경을 이해하고 도구를 다루는 진정한 AI 에이전트 에 가깝습니다. 초기 설정만 잘 마쳐도 개발 속도가 비약적으로 상승하는 경험을 하실 수 있을 거예요.

다음 포스팅에서는 실제 Claude Code의 슬래시 명령어(/model, /cost, /usage) 활용법과 실전 협업 시나리오를 다뤄보겠습니다!

궁금한 점이 있으신가요? 구독형과 API형 중 무엇이 더 유리할지 고민되신다면, 현재 프로젝트의 파일 규모를 댓글로 남겨주세요. 적절한 플랜을 추천해 드릴게요!