핵심 요약9개 절 · 약 8분

클로드 코드가 세션·주간 몫을 다 써 멈췄을 때 — 모델만 바꾸면 되는 경우를 먼저 가르고, 원포트 API 키로 이어 쓴 뒤 리셋이 지나면 구독으로 되돌려요.

읽는 분: Pro·Max 구독으로 Claude Code 를 쓰다 세션·주간 사용량 제한에 막힌 개발자
끝나면: 원포트 키로 바꿔 이어 쓰고, 리셋이 지나면 두 변수를 지워 구독으로 돌아와요.

이 글의 목차 (9개 절)

막혔을 때 고를 수 있는 길

세션·주간 사용량 제한은 리셋 시각까지 구독에 든 몫으로는 풀리지 않아요. 원포트 AI API 크레딧 키가 있으면 Claude Code 를 /exit 로 닫고 변수 두 개를 넣은 뒤 다시 켜서 이어 써요. 그동안은 구독 대신 키의 크레딧을 사용하고, 리셋이 지나 두 변수를 지우면 구독 로그인으로 돌아와요.

키가 아직 없으면 「원포트 AI API 크레딧」을 사요. 바로 써야 하면 카드로 사요. 계좌입금은 입금이 확인된 뒤에 크레딧이 들어가서 리셋보다 늦을 수 있어요. 쓰던 키가 없으면 메일로 「키 받기」 링크가 와요. 세금계산서는 계좌입금 주문에서 받고, 카드 주문은 카드 매출전표가 증빙이에요.

Claude Code 가 사용량 제한에 막혔을 때 고르는 길 — 2026년 10월 17일 확인

Claude Code 가 사용량 제한에 막혔을 때 고르는 길 — 2026년 10월 17일 확인
상황	할 일	그동안 사용하는 곳
리셋 시각까지 기다려도 돼요	할 일/usage 로 리셋 시각을 봐요. 열어 둔 세션은 리셋 뒤 하던 일을 저절로 이어 가요(/config 의 「Continue automatically at usage limit」). 리셋이 24시간 넘게 남았으면 뜨는 메뉴에서 「Wait here, then continue automatically」로 시작하는 줄을 골라요. Claude Code 를 닫으면 기다림도 끝나요.	그동안 사용하는 곳구독
Opus 나 Sonnet 한 계열만 막혔어요	할 일/model 로 다른 계열 모델로 바꿔요.	그동안 사용하는 곳구독
Pro·Max 로 지금 더 써야 해요	할 일/usage-credits 로 추가 사용량을 사요. Team·Enterprise 는 같은 명령으로 관리자에게 요청해요.	그동안 사용하는 곳Anthropic 사용량 크레딧
자주 막혀요	할 일Pro 는 Max 5x 로, Max 5x 는 Max 20x 로 올려요.	그동안 사용하는 곳더 큰 구독
Claude Code 가 API 크레딧으로 이어 갈지 물어요	할 일받으면 Anthropic Console 계정의 API 크레딧을 표준 API 요금으로 사용해요.	그동안 사용하는 곳Anthropic Console API 크레딧
원포트 키가 있거나 원화·세금계산서가 필요해요	할 일변수 두 개를 넣고 다시 켜요(아래 절).	그동안 사용하는 곳원포트 AI API 크레딧

Anthropic 쪽 다섯 줄은 Claude Code 문서와 Claude 도움말 「Use Claude Code with your Pro or Max plan」에서 옮겼어요. 저절로 이어 가기는 claude.ai 구독으로 로그인한 대화형 세션에서만 돼요.

사는 곳·서류 Claude Code 오류 문서

화면에 뜬 문구로 먼저 가르기

키가 필요한지는 Claude Code 가 띄운 문구가 정해요.

Claude Code 사용량 문구별로 막힌 것과 할 일 — 2026년 10월 17일 확인

Claude Code 사용량 문구별로 막힌 것과 할 일 — 2026년 10월 17일 확인
화면 문구	막힌 것	할 일
You've hit your session limit · resets …	막힌 것5시간 세션 몫 · 모든 모델이 같이 써서 모델을 바꿔도 막혀 있어요	할 일리셋을 기다리거나 원포트 키로 이어 가요
You've hit your weekly limit · resets …	막힌 것주간 몫 · 모든 모델이 같이 써요	할 일리셋을 기다리거나 원포트 키로 이어 가요
You've hit your Opus limit · resets …	막힌 것Opus 계열만	할 일/model 로 Opus 밖의 모델로 바꿔요
You've hit your Sonnet limit · resets …	막힌 것Sonnet 계열만	할 일/model 로 Sonnet 밖의 모델로 바꿔요

세션 몫과 주간 몫은 같이 줄어요. 둘의 리셋 시각은 /usage 에서 봐요.

변수 두 개를 넣고 다시 켜기

주소는 https://oneport.kr 까지만 적어요. Claude Code 가 /v1/messages 를 스스로 붙여요.

키는 ANTHROPIC_API_KEY 가 아니라 ANTHROPIC_AUTH_TOKEN 에 넣어요. AUTH_TOKEN 은 넣는 즉시 구독 로그인보다 앞서고, API_KEY 는 처음에 한 번 승인을 물어요.

이 변수는 이 터미널에서만 살아요. ~/.claude/settings.json 의 env 블록에 넣으면 모든 터미널에 남아서, 리셋 뒤 지우는 걸 잊으면 계속 키의 크레딧을 사용해요. VS Code 확장은 넣는 자리가 달라서 팀 글에 따로 적어 두었어요.

막힌 세션에서 /exit 로 Claude Code 를 닫아요. 켜져 있는 세션은 새로 넣은 변수를 읽지 않아요.
아래 상자를 복사해 sk-so-내_키 자리에 원포트 키를 넣고, 같은 터미널에 붙여 넣어요.
마지막 curl 줄이 잔액을 돌려주면 키가 살아 있어요. 이 확인은 모델을 부르지 않아 크레딧을 사용하지 않아요.
잔액이 보이면 claude --continue 를 쳐서 이 폴더에서 하던 대화를 다시 열어요.

CLI · 설정

지금 터미널에서

export ANTHROPIC_BASE_URL="https://oneport.kr"
export ANTHROPIC_AUTH_TOKEN="sk-so-내_키"
curl "$ANTHROPIC_BASE_URL/v1/credits" -H "x-api-key: $ANTHROPIC_AUTH_TOKEN"

VS Code 에 넣는 자리

넘어갔는지 확인하기

켤 때 「auth may not work as expected」로 끝나는 경고가 떠도 요청은 키로 가요.

「Anthropic base URL」 줄이 없거나 「Login method」 줄에 claude.ai 계정이 보이면 변수가 세션에 닿지 않았어요. /exit 하고 변수를 넣은 그 터미널에서 다시 켜요.

세션이 열리면 /status 를 쳐요.
「Anthropic base URL」 줄에 https://oneport.kr 이 보이는지 봐요.
「Auth token」 줄에 ANTHROPIC_AUTH_TOKEN 이 적혀 있는지 봐요.
짧은 메시지를 하나 보내 답이 오는지 봐요.

이어 쓰는 동안 달라지는 것

변수가 켜져 있는 동안은 구독 사용량 제한이 적용되지 않고, 쓴 토큰만큼 키의 크레딧을 사용해요. 1 크레딧 = 부가세 포함 2원어치예요.

이 길로는 Claude 모델만 불러요. Remote Control 과 음성 받아쓰기는 이 동안 쓸 수 없어요.

/context 의 토큰 수는 어림이에요. 원포트에 토큰 세기 주소가 없어 Claude Code 가 글자 수로 짐작해요.

프롬프트와 코드는 원포트를 거쳐 Anthropic 으로 가요. Anthropic 은 원포트 같은 제3자 게이트웨이를 보증하거나 관리하지 않아요.

데이터가 가는 곳 클로드 코드 가격

리셋 뒤 구독으로 돌아가기

Claude Code 가 알려 준 리셋 시각이 지나면 /exit 로 닫아요.
~/.claude/settings.json 의 env 블록이나 ~/.zshrc 같은 셸 설정 파일에 두 값을 넣었다면 거기서도 지워요. settings.json 값은 셸보다 앞서요.
아래 상자를 붙여 넣어 두 변수를 지우고 하던 대화를 다시 열어요.
/status 의 「Login method」 줄에 claude.ai 계정이 보이면 구독으로 돌아왔어요. 이어 쓰는 동안 /logout 했다면 /login 으로 다시 로그인해요.

CLI · 설정

리셋 뒤 구독으로

unset ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN
claude --continue

안 될 때

404 가 나요

원인·확인: ANTHROPIC_BASE_URL 끝에 /v1 을 붙였는지 봐요. Claude Code 가 /v1/messages 를 붙여서 두 번 붙어요.
해결 방법: https://oneport.kr 까지만 남기고 다시 켜요.

「유효하지 않거나 폐기됐거나 기한이 지난 키예요.」가 떠요

원인·확인: 키를 sk-so- 부터 끝까지 넣었는지, 「AI API」 화면 「키 관리」의 그 키 줄에 「기한 지남」이 떠 있지 않은지 봐요.
해결 방법: 기한이 지났으면 그 줄의 「한도 수정」에서 「이 날까지 사용」 날짜를 뒤로 미루거나 비우고 「저장」해요. 잃어버린 키면 그 줄의 「새로 받기」로, 폐기한 키면 「새 키 발급」의 「키 만들기」로 새 키를 받아 바꿔 넣어요.

--continue 로 다시 연 대화가 오류로 막혀요

원인·확인: 구독으로 쓰던 대화를 키로 다시 열었거나, 그 반대예요.
해결 방법: claude 로 새 세션을 열어 이어 가요.

/status 에 「Auth token」 대신 「API key」 줄이 보여요

원인·확인: ANTHROPIC_AUTH_TOKEN 이 세션에 닿지 않아 예전 ANTHROPIC_API_KEY 가 쓰이고 있어요. 셸 설정 파일이나 ~/.claude/settings.json 에 남아 있기도 해요.
해결 방법: unset ANTHROPIC_API_KEY 하고 설정 파일의 그 줄도 지운 뒤, 위 상자를 다시 붙여 넣고 켜요.

ANTHROPIC_API_KEY 에 원포트 키를 넣었는데 묻지도 않고 무시돼요

원인·확인: 이 변수는 대화형 세션에서 한 번 승인을 받아야 하고, 예전에 거절한 키는 다시 묻지 않고 무시해요.
해결 방법: 원포트 키는 ANTHROPIC_AUTH_TOKEN 에 넣어요. ANTHROPIC_API_KEY 로 쓰려면 /config 의 「Use custom API key」를 켜요.

로그인 수단 두 개를 말하는 경고 뒤로 로그인이 꼬여요

원인·확인: 구독 로그인과 원포트 키가 함께 켜져 있어요. 남은 로그인이 엉뚱하게 움직일 수 있어요.
해결 방법: 키로 이어 쓰려면 /logout 해요. 리셋 뒤 두 변수를 지우고 /login 으로 구독에 다시 로그인해요.

429 key_limit_exceeded 가 나요

원인·확인: 그 키의 이번 달 한도나 오늘 한도에 닿았어요. 원포트는 분당 제한을 두지 않아요.
해결 방법: 지갑 주인이 「키 관리」의 「한도 수정」에서 올리면 바로 풀려요. 오늘 한도는 한국 시간 0시에 다시 열려요.

긴 답을 받다가 끊겨요

원인·확인: 원포트는 한 호출을 5분까지 기다려요.
해결 방법: 긴 답을 한 번에 받지 말고 나눠 물어요.

curl 확인은 되는데 Claude Code 가 로그인하래요

원인·확인: 주소만으로는 로그인이 되지 않아요. 변수를 넣지 않은 터미널에서 켰거나, 프로젝트의 .claude/settings.json 에만 넣었을 수 있어요.
해결 방법: 변수를 넣은 그 터미널에서 claude --continue 로 켜요.

팀이 같은 날 막힌다면

Team·Enterprise 좌석이거나 회사가 Claude Code 관리 설정을 배포했다면 회사 방침부터 봐요. 관리 설정에 forceLoginMethod 나 forceLoginOrgUUID 가 있으면 게이트웨이 키를 함께 쓸 수 없어요.

팀원 여럿이 같은 날 막힌다면 사람마다 키를 나누고 키별 월·하루 한도를 걸어요. 팀 한도 설계와 견적서·세금계산서가 필요하면 도입 문의로 알려 주세요.

도입 문의 개발자마다 키 나누기 사는 곳·서류

더 자주 묻는 것

길게 이어 온 대화를 키로 다시 열면 한 번에 많이 사용하나요? — 네. Claude Code 는 요청마다 앞 대화를 함께 보내서, 대화가 길수록 한 번에 사용하는 크레딧도 커요. 길다면 /compact 로 줄이거나 새 세션으로 시작해요.

구독에 딸려 오는 월 API 몫으로도 이어 쓸 수 있나요? — 아니요. Anthropic 도움말은 Max 플랜에 딸린 월 API 크레딧을 Claude Code 와 Claude 앱에서 쓸 수 없다고 적어요(2026년 10월 17일 확인).

출처와 확인일

Anthropic Pro·Max 사용량 제한 공식 안내 · 2026년 10월 17일 확인
Claude Code LLM Gateway 연결 공식 가이드 · 2026년 10월 17일 확인
Claude Code CLI 레퍼런스 · 2026년 10월 17일 확인

함께 보면 좋은 글과 도움말

← 블로그 전체 목록 보기

클로드 코드가 멈췄을 때 — 내 API 키로 이어 쓰고 되돌리기