이 문서는 Claude Code에 접근하기 위해 Pro 또는 Max 플랜 구독을 사용하는 개인 소비자에게 적용됩니다. Claude for Work 조직의 구성원인 경우 팀 또는 엔터프라이즈 플랜에서 Claude Code 사용을 참조하세요.
Claude Code란 무엇인가요?
Claude Code는 터미널에서 Claude 모델에 직접 접근할 수 있게 해주는 명령줄 도구로, 투명성과 제어를 유지하면서 복잡한 코딩 작업을 위임할 수 있습니다. Pro 및 Max 플랜을 통해 웹, 데스크톱, 모바일 앱의 Claude와 터미널의 Claude Code에 하나의 통합 구독으로 접근할 수 있습니다.
Claude와 Claude Code를 왜 사용하나요?
하나의 간단한 구독으로 두 가지 강력한 AI 제품을 사용하세요.
Claude를 사용하여 작문, 연구, 분석 등을 수행하세요 — 직장과 집에서.
Claude Code를 터미널 기반 코딩 워크플로우에 사용하세요.
Claude Code를 플랜과 연결하는 방법
Pro 또는 Max 플랜에서 Claude Code 사용을 시작하려면:
활성 Pro 또는 Max 플랜 구독이 있는지 확인하세요
아직 구독하지 않았다면 claude.ai/upgrade에서 업그레이드하세요.
Pro 플랜: 소규모 저장소에서 가벼운 코딩 작업을 위해 월 $20.
Max 플랜은 두 가지 사용 계층을 제공합니다:
Pro 사용량의 5배 (월 $100)
Pro 사용량의 20배 (월 $200)
Claude Code 설치
Claude Code 문서를 방문하여 Claude Code를 다운로드하고 설치하세요.
운영 체제에 맞는 설치 지침을 따르세요.
Claude 자격증명으로 인증
설정 또는 처음 사용 중에 메시지가 표시되면 Claude에 사용하는 것과 동일한 자격증명으로 로그인하세요.
이렇게 하면 Pro 또는 Max 플랜 구독이 Claude Code에 연결됩니다.
Claude Console PAYG를 통해 Claude Code에 이미 로그인한 경우 Claude Code 내에서 /login을 실행하여 구독 플랜으로 전환하세요.
Pro 또는 Max 플랜을 사용하여 Claude Code에 접근하는 데 문제가 있나요?
선호하는 계정으로 인증하는 옵션이 보이지 않으면 다음 단계를 따라 Claude Code를 업데이트하세요:
/logout명령을 사용하여 활성 세션에서 완전히 로그아웃하세요.claude update를 실행하세요.변경 사항이 적용되도록 터미널을 완전히 다시 시작하세요.
claude를 실행하고 Claude Code를 사용할 올바른 계정을 선택하세요.
중요: 시스템에 ANTHROPIC_API_KEY 환경 변수가 설정되어 있으면 Claude Code는 Claude 구독(Pro, Max, Team 또는 Enterprise 플랜)이 아닌 이 API 키를 인증에 사용하므로 구독의 포함된 사용량을 사용하는 대신 API 사용 요금이 발생합니다. 자세한 내용은 이 문서를 참조하세요: Claude Code에서 API 키 환경 변수 관리.
사용 한도는 어떻게 작동하나요?
Pro 및 Max 플랜 모두 Claude와 Claude Code 전체에서 공유되는 사용 한도를 제공합니다. 즉, 두 도구의 모든 활동이 동일한 사용 한도에 포함됩니다. 보낼 수 있는 메시지 수는 메시지 길이, 대화 길이 및 파일 첨부에 따라 달라지며, Claude Code 사용량은 프로젝트 복잡도, 코드베이스 크기 및 자동 수락 설정에 따라 달라집니다. 더 많은 계산 집약적 모델을 사용하면 사용 한도에 더 빨리 도달합니다.
Pro 플랜
Pro 플랜 사용 한도에 대해 자세히 알아보려면 Claude의 Pro 플랜 사용 정보를 참조하세요.
모델 접근: Pro 플랜 구독자는 Sonnet에 접근할 수 있지만 추가 사용을 활성화하고 구매한 경우에만 Claude Code에서 Opus를 사용할 수 있습니다.
최적 용도: 소규모 저장소에서의 가벼운 작업(일반적으로 1,000줄 미만의 코드).
이전 모델의 사용 한도
Pro ($20/월): 평균 사용자는