Pro·Max 구독으로 Claude Code 연결하기
이 문서는 Claude Code에 액세스하기 위해 Pro 또는 Max 요금제 구독을 사용하는 개별 소비자에게 적용됩니다. Team 또는 Enterprise 요금제 조직의 구성원이라면 Team 또는 Enterprise 요금제로 Claude Code 사용하기를 참조하세요.
Claude Code란 무엇인가요?
Claude Code는 터미널 또는 지원되는 IDE에서 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 키 환경 변수 관리하기.
IDE에서 Claude Code 사용하기
Pro 또는 Max 요금제에는 VS Code, Cursor 및 기타 VS Code 포크, 그리고 IntelliJ와 PyCharm 같은 JetBrains IDE를 포함한 지원되는 IDE의 Claude Code도 포함됩니다. 터미널에서 사용하는 것과 동일한 Claude 자격 증명으로 로그인하세요. IDE 사용량은 Claude와 Claude Code 전반에 공유되는 동일한 사용 한도에 포함됩니다.
IDE용 확장 프로그램을 설치하고 설정하려면 Claude Code Docs의 플랫폼 및 통합을 참조하세요.
사용량 한도에 도달하면 어떻게 되나요?
Pro와 Max 요금제 모두 5시간 세션 한도와 주간 한도가 있습니다. Max 요금제에는 Fable에 대한 별도의 주간 한도도 있습니다. 이러한 한도는 Claude와 Claude Code 전반에 공유되므로, 두 도구에서의 모든 활동이 같은 한도에 포함됩니다. 사용량을 확인할 수 있도록, 각 한도에 가까워지면 경고 메시지가 표시됩니다.
Claude Code가 응답을 진행하던 중 5시간 세션 한도에 도달하면, Claude Code는 중간에 멈추는 대신 현재 진행 중인 단계를 마칠 수 있도록 잠시 계속 작업할 수 있습니다. 이때 Claude Code에는 “Usage limit reached · wrapping up”이 표시됩니다. 이 마무리 허용치는 매우 작고 상한이 있으며, 사용량은 주간 한도에 포함됩니다. 이는 이미 진행 중인 응답에만 적용되며, 한도에 도달한 후 새로 보낸 메시지에는 적용되지 않습니다. Pro 요금제에서는 주간 사용 기간마다 최대 한 번 적용됩니다. Max 요금제에서는 주간 한도 내에서 5시간 세션 한도에 도달할 때마다 적용될 수 있습니다. 이 기능은 점진적으로 배포 중이므로 아직 계정에서 사용할 수 없을 수도 있습니다. Claude Code 마무리 허용치에 대해 더 알아보세요.
사용량 한도에 도달하면 필요에 따라 다음 옵션 중에서 선택할 수 있습니다:
Pro 플랜 사용자
- 대규모 저장소를 위해 더 많은 용량이 필요하고 한도에 자주 도달한다면 Max 5x 플랜으로 업그레이드하는 것을 고려하세요.
- 다섯 시간 세션 한도 또는 주간 한도에 도달한 뒤에도 Pro 플랜으로 Claude를 계속 사용하려면 사용량 크레딧을 활성화하세요.
- 집중적인 코딩 스프린트를 위해 Claude Console 계정으로 전환하고 API 사용량 크레딧을 구매하세요.
- 사용량 한도가 초기화될 때까지 기다리세요.
Max 플랜 사용자
- Max 5x 플랜을 사용 중이고 한도에 자주 도달한다면 Max 20x 플랜으로 업그레이드하는 것을 고려하세요.
- 다섯 시간 세션 한도, 일반 주간 한도, 또는 Fable에 대한 별도의 주간 한도에 도달한 뒤에도 Max 플랜으로 Claude를 계속 사용하려면 사용량 크레딧을 활성화하세요.
- 집중적인 코딩 스프린트를 위해 Claude Console 계정으로 전환하고 API 사용량 크레딧을 구매하세요.
- Max 플랜에 포함된 월간 API 크레딧은 사용량 크레딧을 포함해 Claude Code나 Claude 앱에서 사용할 수 없습니다. Max 및 Team 플랜의 월간 API 크레딧에 대해 자세히 알아보세요.
- 사용량 한도가 초기화될 때까지 기다리세요.
효율적인 사용에 대한 자세한 내용은 사용량 한도 모범 사례를 참조하세요.
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 Billing 설정을 검토하세요.
- 자동 크레딧 구매를 피하고 싶다면 Console에서 이 설정을 조정하세요.
- 자동 재충전은 API 크레딧 사용을 선택한 경우에만 적용된다는 점을 기억하세요.
요약
- Claude Code는 요금 관련 결정을 사용자가 엄격하게 통제할 수 있도록 유지합니다.
- 자동 재충전은 Claude Console의 독립적인 기능입니다.
- Pro 또는 Max 플랜 예산을 유지하려면 제공될 때 API 크레딧 옵션을 거절하면 됩니다.
출처
- 원문: https://support.claude.com/en/articles/11145838-using-claude-code-with-your-pro-or-max-plan (2026-10-26 · support.claude.com)