클로드 코드 Pro·Max로 쓰는 법, 설치부터 한도 대처까지

클로드 코드(Claude Code)는 터미널이나 코드 편집기에서 클로드에게 코딩 작업을 맡기는 도구입니다. Pro나 Max를 구독 중이라면 추가 결제 없이 같은 구독으로 쓸 수 있습니다.

다만 설정을 잘못하면 구독과 별개로 API 요금이 나갈 수 있습니다. 공식 안내를 기준으로 연결 방법과 과금 주의점을 정리했습니다.

구독 하나로 두 가지

Pro와 Max 구독에는 웹·데스크톱·모바일의 클로드와 터미널의 클로드 코드가 모두 포함됩니다. 글쓰기, 조사, 분석은 클로드로, 터미널 기반 코딩은 클로드 코드로 하는 구조입니다. 팀·엔터프라이즈는 별도 안내를 따릅니다.

연결하는 법

1. Pro나 Max 구독이 활성 상태인지 확인합니다(없다면 claude.ai/upgrade)
2. 클로드 코드 문서의 안내대로 운영체제에 맞게 설치합니다
3. 처음 실행할 때 클로드와 같은 계정으로 로그인합니다

이미 콘솔(종량제) 계정으로 로그인해 쓰고 있었다면, 클로드 코드 안에서 /login을 실행해 구독 계정으로 바꾸면 됩니다.

구독 계정 선택지가 안 보이면

1. /logout으로 완전히 로그아웃합니다
2. claude update를 실행합니다
3. 터미널을 완전히 다시 시작합니다
4. claude를 실행하고 올바른 계정을 고릅니다

가장 흔한 실수 — API 키 환경 변수

공식 안내가 “중요”로 표시한 부분입니다. 시스템에 ANTHROPIC_API_KEY 환경 변수가 설정돼 있으면, 클로드 코드는 구독 대신 이 API 키로 인증합니다. 그러면 구독 사용량이 아니라 API 요금이 청구됩니다.

예전에 API를 써 본 적이 있다면 환경 변수가 남아 있지 않은지 꼭 확인하시기 바랍니다. 구독이 있는데 요금이 따로 나왔다면 대부분 이 때문입니다.

자주 쓰는 명령 정리

명령	용도
/login	클로드 코드 안에서 구독 계정으로 로그인 전환
/logout	현재 세션 로그아웃
claude update	클로드 코드 업데이트
/status	남은 사용량 확인
claude logout → claude login	Pro·Max 계정만으로 다시 인증

코드 편집기에서도

구독은 지원되는 IDE도 포함합니다. VS Code, 커서 등 VS Code 계열, 인텔리제이·파이참 같은 JetBrains IDE에서 터미널과 같은 계정으로 로그인하면 됩니다. IDE 사용량도 클로드와 클로드 코드가 함께 쓰는 한도에서 차감됩니다.

한도는 하나로 공유됩니다

Pro와 Max의 사용 한도는 클로드와 클로드 코드가 함께 씁니다. 코딩을 많이 한 날은 채팅 한도도 함께 줄어듭니다. 남은 양이 적어지면 경고가 뜨고, 터미널에서 /status로 확인할 수 있습니다.

한도에 닿았을 때

선택지	내용
요금제 올리기	Pro → Max 5x, Max 5x → Max 20x
사용 크레딧	한도 이후에도 이어서 쓰기
콘솔 계정의 API 크레딧	집중 코딩 기간에 별도 구매
기다리기	한도 초기화까지

모르는 새 과금되지 않게

한도에 닿으면 클로드 코드가 API 크레딧으로 계속할지 묻습니다. 모든 전환은 명시적 동의가 필요하고, API 크레딧을 쓰면 표준 API 요금으로 청구됩니다. 콘솔 계정에 자동 충전이 켜져 있으면 잔액이 줄 때 자동으로 충전됩니다.

구독 안에서만 쓰려면

• API 크레딧 제안이 뜨면 거절하기
• 초기화될 때까지 기다렸다가 다시 쓰기
• /status로 남은 양 확인하기

API 크레딧 제안 자체를 없애려면

1. 터미널에서 claude logout을 실행합니다
2. claude login으로 Pro·Max 계정만 인증합니다
3. 로그인 과정에서 콘솔 계정 정보를 추가하지 않습니다

자동 충전 설정은 클로드 코드가 아니라 콘솔의 결제 설정에서 관리합니다. 원치 않는 자동 구매가 걱정되면 그쪽을 확인하시기 바랍니다.

요금이 따로 나왔다면 점검할 것

1. ANTHROPIC_API_KEY 환경 변수가 설정돼 있는지 확인합니다
2. 클로드 코드에 콘솔(종량제) 계정으로 로그인돼 있지 않은지 봅니다
3. 한도 도달 시 API 크레딧 사용에 동의한 적이 있는지 떠올려 봅니다
4. 콘솔 결제 설정에서 자동 충전이 켜져 있는지 확인합니다

네 가지를 정리한 뒤 claude logout과 claude login으로 구독 계정만 다시 인증하면, 이후에는 구독 한도 안에서만 쓰게 됩니다.

팀·엔터프라이즈라면

이 글은 Pro·Max 개인 구독 기준입니다. 팀이나 엔터프라이즈 조직의 구성원은 조직 관리 방식이 달라서 별도 안내를 따라야 합니다. 조직에서 받은 계정이라면 관리자에게 클로드 코드 사용 범위를 먼저 확인하시기 바랍니다.

정리

클로드 코드는 Pro·Max 구독에 포함된 코딩 에이전트입니다. 같은 계정으로 로그인하면 되고, IDE에서도 씁니다. ANTHROPIC_API_KEY 환경 변수가 남아 있으면 API 요금이 나간다는 점, 한도는 채팅과 공유된다는 점 두 가지만 기억하면 됩니다.

※ 이 글은 2026년 9월 기준 Anthropic(클로드) 고객센터 공식 안내를 참고했습니다. 메뉴 이름과 한도는 바뀔 수 있으니 최신 내용은 공식 페이지에서 확인하시기 바랍니다.