이 문서는 Claude Code에 접근하기 위해 Pro 또는 Max 플랜 구독을 사용하는 개인 소비자에게 적용됩니다. Team 또는 Enterprise 플랜 조직의 구성원인 경우 Team 또는 Enterprise 플랜에서 Claude Code 사용하기를 참조하세요.
Claude Code란 무엇인가요?
Claude Code는 터미널에서 Claude 모델에 직접 접근할 수 있게 해주는 명령줄 도구로, 투명성과 제어를 유지하면서 복잡한 코딩 작업을 위임할 수 있습니다. Pro 및 Max 플랜을 사용하면 이제 웹, 데스크톱, 모바일 앱의 Claude와 터미널의 Claude Code에 하나의 통합 구독으로 접근할 수 있습니다.
Claude와 Claude Code를 왜 사용하나요?
하나의 간단한 구독으로 두 가지 강력한 AI 제품을 사용하세요.
Claude를 사용하여 작문, 연구, 분석 등을 수행하세요 — 직장과 집에서.
Claude Code를 터미널 기반 코딩 워크플로우에 사용하세요.
Claude Code를 Pro 또는 Max 플랜에 연결하는 방법
활성 Pro 또는 Max 플랜 구독이 있는지 확인하세요
아직 구독하지 않았다면 claude.ai/upgrade에서 업그레이드하세요
Claude Code 설치
Claude Docs의 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 간에 공유되는 사용량 제한을 제공합니다. 즉, 두 도구의 모든 활동이 동일한 사용량 제한에 포함됩니다. 사용량을 모니터링하는 데 도움이 되도록 남은 용량에 대한 경고 메시지가 표시됩니다.
사용량 제한에 도달하면 필요에 따라 몇 가지 옵션 중에서 선택할 수 있습니다:
Pro 플랜 사용자
제한에 자주 도달하고 더 큰 저장소를 위해 더 많은 용량이 필요한 경우 Max 5x 플랜으로 업그레이드하는 것을 고려하세요.
추가 사용량을 활성화하여 포함된 사용량 제한에 도달한 후 Pro 플랜으로 Claude를 계속 사용하세요.
집중적인 코딩 스프린트를 위해 Claude Console 계정으로 종량제 사용으로 전환할 수 있는 유연성이 있습니다.
사용량 제한이 재설정될 때까지 기다리세요.
Max 플랜 사용자
Max 5x 플랜을 사용 중이고 제한에 자주 도달하면 Max 20x 플랜으로 업그레이드하는 것을 고려하세요.
추가 사용량을 활성화하여 포함된 사용량 제한에 도달한 후 Max 플랜으로 Claude를 계속 사용하세요.
집중적인 코딩 스프린트를 위해 Claude Console 계정으로 종량제 사용으로 전환할 수 있는 유연성이 있습니다.
사용량 제한이 재설정될 때까지 기다리세요.
효율적인 사용에 대한 자세한 내용은 사용량 제한 모범 사례를 참조하세요.
Claude Code 청구
두 가지 별개 시스템 이해
이것이 별개의 시스템임을 인식하는 것이 중요합니다:
Claude Code: API 크레딧을 통한 계속 사용 옵션을 제시합니다.
Claude Console / Claude API: 터미널이 위치한 곳에서 API 크레딧 관리를 위한 선택적 자동 재충전 설정을 포함합니다.
API 크레딧 사용 선택
Claude Code를 통해 API 크레딧을 사용하려면:
사용량은 표준 API 요금으로 청구됩니다(Pro/Max 플랜 가격과 다름).
Console 계정에서 자동 재충전이 활성화되어 있으면 잔액이 부족할 때 추가 크레딧이 자동으로 추가됩니다.
플랜 내에서 유지
Pro 또는 Max 플랜 할당 내에서 사용량을 엄격하게 유지하려면:
제시될 때 API 크레딧 옵션을 거절하세요.
Claude Code를 계속 사용하기 전에 사용량 기간이 재설정될 때까지 기다리세요.
/status 명령을 사용하여 남은 할당을 모니터링하세요.
Claude Code의 API 크레딧 거절
API 크레딧 옵션이 완전히 나타나지 않도록 하려면:
터미널에서
claude logout을 실행하세요.claude login을 실행하고 Pro 또는 Max 플랜 자격증명만 사용하여 인증하세요.로그인 프로세스 중에 Claude Console 자격증명을 추가하지 마세요.
이렇게 하면 Claude Code가 플랜 할당만 사용하고 제한에 도달했을 때 API 크레딧을 사용하라는 메시지가 표시되지 않습니다.
자동 재충전 설정 관리
자동 재충전 기능은 Claude Code가 아닌 Claude Console 계정 내에서 관리됩니다:
Console 청구 설정을 검토하여 자동 재충전 상태를 확인하세요.
자동 크레딧 구매를 피하려면 Console에서 이러한 설정을 조정하세요.
자동 재충전은 API 크레딧 사용을 선택했을 때만 적용됩니다.
요약
Claude Code는 청구 결정에 대한 엄격한 사용자 제어를 유지합니다.
API 크레딧 사용으로의 모든 전환에는 명시적 사용자 동의가 필요합니다.
자동 재충전은 독립적인 Claude Console 기능입니다.
Pro 또는 Max 플랜 예산을 유지하려면 제시될 때 API 크레딧 옵션을 거절하면 됩니다.