Claude Code API 키와 구독 결제: 키를 승인하면 API 과금, -p는 항상 키

2026년 10월 10일 기준 Claude Code 인증 문서에 따르면, Pro나 Max 구독으로 로그인해 있어도 ANTHROPIC_API_KEY 환경 변수가 있으면 Claude Code는 그 키를 쓸 수 있고, 그때 사용량은 플랜이 아니라 Claude Console의 API 결제로 잡힙니다. 다만 무조건 덮어쓰는 것은 아닙니다. 대화형 모드에서는 키를 쓸지 처음 한 번 묻고 그 선택을 기억하며, claude -p 같은 비대화형 실행에서는 키가 있으면 묻지 않고 항상 키를 씁니다.

구독과 API는 결제가 따로입니다. Anthropic 도움말은 유료 Claude 구독과 Claude API가 별도로 청구된다고 설명하고, API는 선불 크레딧으로 결제합니다. 그래서 먼저 볼 것은 가입한 플랜 이름이 아니라 지금 세션이 어떤 자격 증명으로 실행되는지이고, 그 답은 /status 가 보여줍니다.

먼저 현재 경로를 확인하기

Claude Code 안에서 /status 를 실행하면 지금 쓰는 인증 방식이 나옵니다. 인증 문서는 로그인과 API 키가 둘 다 설정되어 있을 때 /status 가 쓰이지 않는 쪽 자격 증명을 따로 표시한다고 설명합니다. 즉 구독 로그인이 보이더라도 그 옆에 "사용 안 함" 표시가 붙어 있으면 실제 요청은 API 키로 나가고 있다는 뜻입니다.

같은 셸에 키가 들어 있는지는 값을 출력하지 않고 존재 여부만 확인하면 됩니다.

# 키 값은 출력하지 않고 설정 여부만 확인
if [ -n "$ANTHROPIC_API_KEY" ]; then echo "ANTHROPIC_API_KEY is set"; else echo "ANTHROPIC_API_KEY is not set"; fi

키가 없는데도 API 쪽으로 청구된다면 로그인 방식을 확인하세요. /login 에서 Claude 구독 계정이 아니라 Claude Console 계정으로 로그인하면 키를 직접 만들지 않아도 Console 조직에 토큰 단위로 청구됩니다. Claude Code 비용 문서는 처음 Console 계정으로 인증할 때 Console에 "Claude Code"라는 워크스페이스가 자동으로 생긴다고 설명합니다. 이 워크스페이스가 보인다면 한 번은 Console 경로로 실행된 적이 있다는 신호입니다.

또 하나의 단서는 /usage-credits 명령입니다. 비용 문서에 따르면 이 명령은 /login 으로 구독 계정에 로그인했을 때만 쓸 수 있고 API 키 인증에서는 쓸 수 없습니다.

구독이 있는데 API 결제가 생기는 이유

가장 흔한 원인은 ANTHROPIC_API_KEY 가 실행 환경 어딘가에 남아 있는 것입니다. .zshrc, .bashrc, 프로젝트 .env 를 읽어 들이는 도구, devcontainer, CI secret, 그리고 Claude Code settings.json 의 env 항목까지 모두 후보입니다. 인증 문서는 "활성 구독이 있어도 ANTHROPIC_API_KEY 가 설정되어 있으면 승인한 뒤에는 API 키를 쓴다"고 적고 있습니다. 예전처럼 키가 조용히 구독을 덮어쓴다기보다, 처음 묻는 창에서 승인한 선택이 기억되어 이후 세션이 계속 API로 청구되는 경우가 많습니다.

두 번째 원인은 비대화형 실행입니다. claude -p, 셸 스크립트, cron, GitHub Actions처럼 사람이 응답하지 않는 실행에서는 키가 있으면 묻지 않고 항상 사용합니다. 노트북에서는 구독으로 쓰고 있는데 같은 계정의 자동화 작업이 Console 크레딧을 쓰는 일이 여기서 생깁니다.

세 번째는 우선순위가 더 높은 다른 자격 증명입니다. ANTHROPIC_AUTH_TOKEN 은 LLM 게이트웨이나 프록시용 토큰이고, CLAUDE_CODE_USE_BEDROCK, CLAUDE_CODE_USE_VERTEX, CLAUDE_CODE_USE_FOUNDRY 가 켜져 있으면 클라우드 제공업체 계정으로 청구됩니다. 이 경우 비용은 Anthropic 청구서가 아니라 게이트웨이 운영자나 클라우드 결제 콘솔에 나타납니다.

마지막으로 API 키와 상관없이 API 단가로 돈이 나가는 경우도 있습니다. 플랜 한도를 다 쓴 뒤 사용 크레딧을 켜 두었다면 그 뒤의 사용량은 표준 API 요금으로 따로 청구됩니다. 이것은 키 문제가 아니라 플랜의 추가 사용량이며, 아래 사용 크레딧 항목에서 따로 다룹니다.

Claude Code 인증 우선순위 7단계와 각 단계의 청구처

자격 증명이 여러 개 있으면 Claude Code는 인증 문서에 적힌 순서대로 하나를 고릅니다. 아래 표는 그 순서를 "무엇을 설정했을 때 어디로 청구되고, 어떻게 구독으로 돌리는가"로 정리한 것입니다.

두 가지를 같이 기억하면 진단이 빨라집니다. 첫째, 2~4단계의 환경 변수와 apiKeyHelper 는 CLI뿐 아니라 CLI를 감싸는 VS Code 확장, Agent SDK, GitHub Actions에도 적용됩니다. VS Code에서만 API로 청구된다면 VS Code가 읽는 셸 환경을 보세요. 둘째, Claude 데스크톱 앱과 클라우드 세션은 이 환경 변수를 읽지 않으며, 클라우드 세션은 클라우드 환경에 키를 넣어도 항상 구독 자격 증명을 씁니다.

settings.json 에 키를 넣는 방법이나 게이트웨이 설정 자체는 Claude Code API 설정: 키, settings.json, 모델, 게이트웨이 확인 순서에서 다룹니다. 여기서 중요한 점은 settings.json 의 env 에 넣은 ANTHROPIC_API_KEY 도 셸에서 넣은 키와 같은 3단계로 취급된다는 것입니다.

/status, /usage, /cost, Console의 역할

이 그림은 2026년 10월 10일 업데이트 이전에 만든 것입니다. 각 화면의 최신 역할은 아래 본문 설명을 따르세요.

화면마다 답하는 질문이 다릅니다.

• /status 는 "지금 어떤 자격 증명으로 실행 중인가"에 답합니다. 결제 경로를 판단하는 첫 화면입니다.
• /usage 는 Pro·Max·Team·Enterprise 플랜에서 플랜 사용량 막대, 활동 통계, 스킬·서브에이전트·MCP 서버별 사용 비중을 보여줍니다. 사용 크레딧을 켜 두었다면 이번 달 크레딧 지출도 한 줄로 나옵니다. 숫자는 이 컴퓨터의 로컬 세션 기록으로 계산하므로 다른 기기나 claude.ai 사용분은 들어가지 않습니다.
• /cost 로 알려진 세션 비용 숫자는 현재 비용 문서에서 /usage 맨 위의 Session 블록으로 설명됩니다. 토큰 수에 정가를 곱해 로컬에서 계산한 추정치이고, 문서는 이 금액이 API 사용자용이며 Pro·Max 구독자에게는 청구와 관련이 없다고 적고 있습니다.
• Claude Console의 Usage 페이지는 API 경로의 실제 청구 기준입니다. Console 조직이라면 워크스페이스별 지출 한도도 여기서 겁니다.
• claude.ai Settings > Usage는 구독 플랜의 포함 사용량과 사용 크레딧 잔액·이번 달 지출·월 지출 한도를 보는 곳입니다.

정리하면 /status 로 청구처를 정하고, 구독이면 /usage 와 Settings > Usage, API면 Console Usage를 봅니다. /usage 의 달러 금액만 보고 구독 청구액이라고 판단하지 마세요. /usage 화면을 읽는 법과 5시간·주간 한도 계획은 Claude Code 토큰 사용량 확인·감사: /usage와 5시간·주간 한도 계획에 정리되어 있습니다.

API 키가 맞는 경우

API 키는 더 고급 옵션이 아니라 작업 자체가 API 운영에 가까울 때 쓰는 결제 방식입니다. 용도별로 나누면 다음과 같습니다.

Claude Code 법률·규정 문서는 OAuth 로그인을 Claude 구독 구매자의 일반적인 Claude Code 사용과 Anthropic 자체 앱을 위한 것으로 규정하고, Agent SDK를 포함해 Claude 기능을 쓰는 제품이나 서비스를 만드는 개발자는 Claude Console 또는 지원되는 클라우드 제공업체의 API 키 인증을 써야 한다고 적고 있습니다. Pro와 Max의 사용 한도도 개인의 일반적인 사용을 전제로 합니다. 그래서 팀 전체가 공유하는 파이프라인은 개인 구독 토큰보다 API 키가 맞습니다.

API로 직접 모델을 호출할지, Claude Code를 쓸지부터 고민 중이라면 Claude API와 Claude Code 차이: 내 작업엔 무엇을 쓸까를 먼저 보세요. 로컬 대화형 코딩에서 한도가 부족한 것이 문제라면 API로 옮기기 전에 Claude Pro vs Max 2026: 가격, Claude Code 제한, Max 손익분기점에서 플랜 차이를 비교하는 편이 빠릅니다.

스크립트에서 구독으로 쓰기: claude setup-token

자동화도 구독 한도로 돌리고 싶다면 API 키 대신 claude setup-token 을 씁니다. 인증 문서에 따르면 이 명령은 유효기간 1년짜리 OAuth 토큰을 화면에 출력할 뿐 어디에도 저장하지 않으므로, 복사해서 CLAUDE_CODE_OAUTH_TOKEN 환경 변수로 넣어야 합니다. 이 토큰은 Claude 구독으로 인증하며 Pro, Max, Team, Enterprise 플랜이 필요합니다.

문서 설명을 바탕으로 하면 흐름은 다음과 같습니다.

# 1. 구독 계정으로 토큰 발급(출력된 토큰을 복사)
claude setup-token

# 2. 자동화 환경에 토큰을 넣고, 같은 환경의 API 키는 비우기
export CLAUDE_CODE_OAUTH_TOKEN="복사한_토큰"
unset ANTHROPIC_API_KEY

# 3. 비대화형 실행
claude -p "테스트 실패 원인을 요약해 줘"

여기서 unset ANTHROPIC_API_KEY 가 중요합니다. 우선순위표에서 CLAUDE_CODE_OAUTH_TOKEN 은 5단계이고 ANTHROPIC_API_KEY 는 3단계라, 두 값이 함께 있으면 -p 실행은 키를 씁니다. 문서는 또 이 토큰이 모델 요청만 할 수 있고, bare 모드는 이 변수를 읽지 않는다고 적고 있습니다. 토큰은 비밀번호처럼 CI secret에 보관하고, 계정을 여러 개 쓴다면 계정마다 CLAUDE_CONFIG_DIR 로 설정 디렉터리를 나누는 방법이 문서에 나와 있습니다.

서드파티 도구와 구독: 도움말·약관·보도가 엇갈리는 지점

OpenClaw 같은 서드파티 도구에서 Claude 구독을 쓸 수 있는지는 한 문장으로 답하기 어렵습니다. 공개된 자료가 서로 다른 범위를 말하고 있기 때문입니다.

• Anthropic 도움말(2026년 10월 7일 업데이트)은 "Claude Agent SDK, claude -p, 서드파티 앱을 여전히 구독 한도로 쓸 수 있다"고 적고, 6월 15일로 예고했던 Agent SDK 사용 방식 변경은 보류되어 "바뀐 것이 없다"고 설명합니다.
• Claude Code 법률·규정 문서는 서드파티 개발자가 자기 앱에 Claude.ai 로그인을 넣거나, 사용자를 대신해 Free·Pro·Max 플랜 자격 증명으로 요청을 보내는 것을 허용하지 않습니다.
• 2026년 4월 4일 무렵 여러 매체는 OpenClaw류 도구가 구독 한도에서 빠져 종량제·사용량 번들·API 키로 옮겨졌다고 보도했고, 이후 OpenClaw 문서(4월 22일)를 근거로 일부가 되돌려졌다는 보도도 나왔습니다.

따라서 내가 직접 claude -p 나 Agent SDK를 내 구독으로 실행하는 것은 도움말이 허용한다고 적은 범위이고, 남의 구독 자격 증명을 모아 대신 요청을 보내는 서비스는 약관이 금지하는 범위입니다. 그 사이에 있는 개별 서드파티 도구는 도구 자체의 문서와 청구 화면을 기준으로 판단하세요.

Max 월간 API 크레딧(10월 7일~)은 Claude Code에 쓰일까

2026년 10월 7일부터 Max와 Team 플랜에 매달 API 크레딧이 붙습니다. Max 5x는 $100, Max 20x는 $200, Team은 Standard 좌석당 $20, Premium 좌석당 $100이며 Team은 합산해 월 $500이 상한입니다. Free, Pro, Enterprise는 대상이 아닙니다. 가입 후 7일이 지나면 Claude Console 조직 하나를 연결해 받을 수 있고, 매 결제 주기마다 새로 채워지며 남은 금액은 이월되지 않습니다.

이 크레딧이 쓰이는 곳은 Claude API, Managed Agents, Agent SDK, Console 플레이그라운드입니다. 대화형 Claude Code와 사용 크레딧(추가 사용량)에는 쓰이지 않습니다. claude -p 와 Agent SDK도 연결한 Console 조직에서 만든 API 키로 인증했을 때만 이 크레딧에서 빠집니다.

Max 사용자라면 선택지가 하나 늘어난 셈입니다. 사람이 하는 대화형 작업은 계속 구독 로그인으로 두고, 스크립트나 CI는 연결한 Console 조직의 API 키로 돌리면 그 사용량이 월간 API 크레딧에서 먼저 빠집니다. 반대로 사용 크레딧이 부족하다고 이 API 크레딧이 대신 쓰이지는 않습니다.

Usage credits와 가격 경계

사용 크레딧(usage credits, 예전 이름 extra usage)은 Pro, Max 5x, Max 20x에서 플랜 포함 사용량을 다 쓴 뒤에도 계속 일하기 위한 유료 추가 사용량입니다. 표준 API 요금으로 청구되고, claude.ai Settings > Usage에서 켜고 월 지출 한도를 정합니다. Anthropic 도움말은 사용 크레딧이 Claude 대화와 Claude Code 터미널 사용 모두에 적용된다고 설명합니다. Console의 API 크레딧이나 위의 Max 월간 API 크레딧과는 다른 잔액입니다.

미리 사 두면 할인되는 사용량 번들도 있습니다. $45에 $50, $200에 $250, $700에 $1,000어치이며 각각 10%, 20%, 30% 할인입니다. 개인은 할인 번들을 월 $2,000까지 살 수 있습니다. 비용 문서는 사용 크레딧을 쓰는 동안 Claude Code의 프롬프트 캐시 유지 시간이 구독 기준 1시간에서 5분으로 줄어든다고 적고 있으니, 긴 휴식 뒤 첫 요청이 캐시를 놓쳐 비싸질 수 있습니다. API 키나 클라우드 제공업체로 실행할 때의 기본값도 5분입니다.

2026년 10월 10일 기준 공식 가격은 다음과 같습니다.

API 키든 사용 크레딧이든 단가는 같습니다. 예를 들어 Claude Code 한 턴이 캐시 없이 입력 20만 토큰을 읽고 출력 2만 토큰을 쓴다고 가정하면, Opus 5.5에서는 200,000 × $4 ÷ 1,000,000 = $0.80에 20,000 × $20 ÷ 1,000,000 = $0.40을 더해 $1.20입니다. 같은 턴을 Sonnet 5.5로 돌리면 $0.40 + $0.20 = $0.60입니다. 실제 턴의 토큰 수는 작업마다 크게 달라지므로 이 숫자는 규모를 가늠하는 용도로만 쓰세요.

판단 기준은 "API가 항상 싸다"가 아닙니다. 사람이 오래 대화형으로 코딩하면 구독이 예측하기 쉽고, CI나 배치 작업은 API 쪽이 관리하기 쉽습니다. 추가 사용량이 매달 얼마나 나와야 Max가 나은지는 Claude 추가 사용량 요금: 사용 크레딧 계산, 월 $80 넘으면 Max 5x에서, 연간 결제와 번들로 비용을 줄이는 방법은 Claude Code 할인 2026년 10월: 연간 결제·사용량 번들·7일 체험·쿠폰 검증에서 계산합니다. API 키를 처음 만들고 결제하는 절차는 Claude API 키 구매 가이드: 공식 결제·키 발급·무료 크레딧 확인법을 참고하세요.

구독 로그인으로 되돌리는 방법

구독으로 쓰려 했는데 API 비용이 보인다면, 인증 문서가 안내하는 순서는 현재 셸에서 키를 지우고 /status 로 확인하는 것입니다.

unset ANTHROPIC_API_KEY
claude
# Claude Code 안에서 실행
/status

상황에 따라 다음 중 필요한 것을 더합니다.

1. 키를 셸에 남겨 둬야 한다면 /config 에서 "Use custom API key" 토글을 끕니다. 문서에 따르면 이 토글은 ANTHROPIC_API_KEY 가 환경에 있을 때만 보입니다.
2. Console 계정으로 로그인되어 있었다면 Claude Code 안에서 /logout 한 뒤 /login 으로 구독 계정을 다시 고릅니다.
3. ANTHROPIC_AUTH_TOKEN 이나 클라우드 제공업체 변수가 있다면 그것도 지웁니다. 키보다 우선순위가 높습니다.
4. 새 터미널을 열 때마다 키가 돌아온다면 셸 설정 파일, 프로젝트 .env, settings.json 의 env 와 apiKeyHelper, devcontainer, IDE 실행 설정에서 지속 설정을 지웁니다.

이 과정은 Claude Console에 있는 API 키를 삭제하지 않습니다. 현재 실행 환경에서 키가 전달되지 않게 할 뿐입니다. 참고로 문서는 비활성화되었거나 만료된 조직의 키가 남아 있으면 구독이 있어도 인증 오류가 날 수 있다고 적고 있으니, 로그인 오류가 반복될 때도 같은 순서로 확인하면 됩니다.

이 그림은 2026년 10월 10일 업데이트 이전에 만든 것입니다. 로그아웃·재로그인은 Claude Code 안의 /logout·/login 이며, /config 토글을 포함한 최신 순서는 위 본문을 따르세요.

혼동하지 말아야 할 것

Pro나 Max를 결제해도 API 키나 API 사용량이 따라오지 않습니다. Claude Code에 구독으로 로그인할 수 있다는 것과 일반 API 호출이 구독에 포함된다는 것은 다른 이야기입니다. Max의 월간 API 크레딧이 생겼지만 그것도 연결한 Console 조직에 따로 쌓이는 API 잔액입니다.

"크레딧"이라는 단어가 붙은 것은 적어도 세 가지입니다. 플랜 한도 이후의 사용 크레딧, Console 조직의 선불 API 크레딧, Max·Team의 월간 API 크레딧입니다. 이미 마감된 클라우드 세션 크레딧까지 섞여 헷갈린다면 Claude 클라우드 세션 크레딧·사용 크레딧·한도 초기화 차이를 보세요.

/usage 의 세션 달러 금액은 정가로 계산한 추정치입니다. 구독자의 청구액도, API 청구서도 아닙니다. 청구는 claude.ai Settings > Usage와 Console Usage에서 확인합니다.

실제 API 키를 티켓, 채팅, 스크린샷, 오류 문의에 붙여 넣지 마세요. 공유할 것은 키 값이 아니라 변수가 설정되어 있는지와 /status 가 보여주는 인증 방식입니다.

팀에서 정해 두면 좋은 운영 규칙

팀에서 Claude Code를 쓴다면 규칙 한 줄을 문서로 남겨 두는 편이 낫습니다. 사람이 하는 대화형 코딩은 구독 로그인(Team 플랜이면 좌석 한도), CI와 서버 쪽 에이전트는 Console 조직의 API 키, 플랜 한도 이후의 계속 사용은 사용 크레딧이라고 정해 두면 비용이 보였을 때 먼저 "어느 경로였나"를 묻게 됩니다.

비용 문서는 조직이 로그인 방식을 섞어 쓰면 개발자마다 인증한 방식대로 계량된다고 설명합니다. Team·Enterprise 플랜은 claude.ai 관리자 설정에서 지출 한도를 걸고, Console 조직은 워크스페이스 지출 한도를 겁니다. Console로 처음 인증할 때 생기는 "Claude Code" 워크스페이스는 Claude Code 사용 전용이라 이 워크스페이스로는 API 키를 만들 수 없습니다.

문제를 공유할 때는 /status 화면, 같은 셸에서 ANTHROPIC_API_KEY 가 비어 있는지, Settings > Usage 또는 Console Usage의 기간별 기록 정도면 충분합니다. 전체 .env, 다른 프로젝트가 보이는 Console 캡처, 청구 상세 화면 전체는 공유하지 않는 것이 안전합니다.

"더 써야 한다"는 요구도 셋으로 나누세요. 사람이 오래 대화형으로 작업해야 하면 Max 업그레이드, 프로그램이 실행 주체라면 API 키, 지금 당장 한도를 넘겨 계속해야 하면 사용 크레딧입니다. 플랜별 한도가 정확히 몇 배인지는 Claude 요금제별 사용량 한도: 5시간·주간 한도, Max 20배는 세션 기준에서 확인할 수 있습니다.

Claude Code 인증·결제 공식 문서(2026년 10월 10일 기준)

위 내용의 근거가 된 공식 페이지입니다. 동작은 Claude Code 버전에 따라 바뀌므로 설정을 바꾸기 전에 원문을 한 번 더 보세요. 본문의 명령어는 이 문서들이 안내하는 것이며, 실행 결과는 계정과 버전에 따라 다를 수 있습니다.

• Claude Code 인증 문서(우선순위, setup-token, /status)
• Claude Code 비용 관리 문서(/usage, Console 워크스페이스, 캐시 유지 시간)
• Claude Code 법률·규정 문서의 인증·자격 증명 사용 조항
• Anthropic 도움말: 유료 플랜의 사용 크레딧 관리
• Anthropic 도움말: 사용량 번들 구매
• Anthropic 도움말: Agent SDK·claude -p·서드파티 앱과 구독 한도
• Claude 요금제와 API 가격 페이지

자주 묻는 질문

Claude Code에 API 키가 꼭 필요한가요?

일반적인 대화형 사용에는 필요하지 않습니다. Pro, Max, Team, Enterprise 계정으로 /login 하면 플랜 사용량으로 씁니다. API 키는 다른 사람에게 제공하는 제품, 팀 공용 CI, Console 조직 단위의 예산 관리가 필요할 때 씁니다. 개인 스크립트를 구독으로 돌리고 싶다면 claude setup-token 이 문서에 나온 방법입니다.

Pro나 Max가 있는데 API 결제가 생기는 이유는 무엇인가요?

대개 ANTHROPIC_API_KEY 가 실행 환경에 있고, 대화형에서 키 사용을 승인했거나 claude -p 로 실행했기 때문입니다. /login 에서 Console 계정을 골랐거나 플랜 한도 이후 사용 크레딧을 켠 경우도 있습니다. /status 에서 사용 중이 아닌 자격 증명 표시를 먼저 확인하세요.

Claude Pro를 결제하면 API 키나 API 사용량도 받나요?

아닙니다. 구독과 Claude API는 따로 청구되고, API는 Console에서 선불 크레딧으로 결제합니다. 2026년 10월 7일부터 Max(5x $100, 20x $200)와 Team에는 월간 API 크레딧이 붙지만 Pro는 대상이 아니며, 이 크레딧도 대화형 Claude Code에는 쓰이지 않습니다.

Claude Code settings.json에 API 키를 넣으면 API로 청구되나요?

네, 그럴 수 있습니다. settings.json 의 env 에 넣은 ANTHROPIC_API_KEY 는 셸 환경 변수와 같은 우선순위로 쓰이고, apiKeyHelper 를 설정했다면 그 스크립트가 내주는 키가 구독 로그인보다 먼저 쓰입니다. 구독으로 돌아가려면 해당 항목을 지우고 /status 로 확인하세요.

Usage credits는 구독 잔액인가요?

아닙니다. 사용 크레딧은 플랜 포함 사용량을 다 쓴 뒤 계속 쓰기 위한 유료 추가 사용량이며 표준 API 요금으로 청구됩니다. 미리 사 두는 사용량 번들($45에 $50 등)로 최대 30% 할인받을 수 있지만, 구독료 안에 들어 있는 잔액은 아닙니다.

Max로 올리는 대신 API를 써야 하나요?

작업이 CI, SDK, 백엔드, 에이전트처럼 프로그램이 실행하는 형태라면 API 키가 맞고, Max 사용자는 월간 API 크레딧을 그쪽에 먼저 쓸 수 있습니다. 로컬 대화형 코딩의 한도 문제가 핵심이면 Claude Code 토큰 사용량 확인·감사: /usage와 5시간·주간 한도 계획과 Pro·Max 차이를 먼저 확인하세요.

/cost는 구독 청구액을 보여주나요?

아닙니다. 지금은 /usage 맨 위 Session 블록에 나오는 세션 비용이 그 숫자이며, 토큰 수에 정가를 곱한 로컬 추정치입니다. 비용 문서는 Pro·Max 구독자에게는 청구와 관련이 없다고 적고 있습니다. API 청구는 Console Usage에서 확인합니다.

Claude Code가 API 키를 쓰지 않게 하려면 어떻게 하나요?

같은 셸에서 unset ANTHROPIC_API_KEY 를 실행하거나, 키를 남겨 둬야 하면 /config 의 "Use custom API key" 토글을 끄세요. Console 계정으로 로그인했다면 /logout 후 /login 으로 구독 계정을 고르고, 마지막에 /status 로 확인합니다. 키가 계속 돌아오면 셸 설정, .env, settings.json, CI secret을 정리해야 합니다.

한국에서 Claude를 결제할 때 VPN이 필요한가요?

필요하지 않습니다. 한국은 Claude 지원 국가 목록에 들어 있으므로 VPN 없이 가입하고 결제하는 것이 정상 경로입니다. VPN은 결제 국가나 청구 경로를 바꾸지 않으므로 API 과금 문제의 해결책도 아닙니다. 예상 밖 청구가 있다면 /status 와 환경 변수부터 보세요.

"API Error: 500 Internal Server Error"도 결제 문제인가요?

아닙니다. 이 메시지는 Anthropic 서버 쪽의 일시적 오류이고 구독·API 키 선택과는 관계가 없습니다. 재시도와 중단된 작업 이어 가기는 Claude Code API Error 500·529 해결: 끊긴 작업을 중복 없이 재개하기에서 다룹니다.