Qwen Code 사용 한도 도달 시: 할당량 출처를 확인하고 작업 계속하기
Qwen Code에는 하나의 공통 할당량이 없습니다. 이 가이드는 현재 인증 출처를 식별하고 Coding Plan, Token Plan, 표준 API Key, 외부 Provider의 한도를 구분해 확인한 뒤 지원되는 방식으로 작업을 계속하는 방법을 설명합니다.
목차
Qwen Code가 사용량 소진을 알리더라도 공통 재설정을 기다리거나 Qwen3.8 Max API 가격부터 찾지 마세요. Qwen Code는 클라이언트이며, 실제 할당량과 과금 규칙은 현재 인증 방식과 Provider가 결정합니다.
Qwen Code 안에서 /doctor를 실행한 뒤, 비밀값을 표시하지 말고 키의 환경 변수 이름, baseUrl, 모델, 리전을 확인하세요. 이전 Qwen OAuth, Alibaba Cloud Coding Plan, Token Plan, 표준 API Key, 외부/사용자 지정 Provider 중 무엇을 쓰는지 확정해야 올바른 한도와 복구 방법을 찾을 수 있습니다. qwen auth status는 제거되었고, 현재 문서는 확인에 /doctor, 변경에 /auth를 안내합니다.
실제로 어떤 할당량이 소진되었나
| 인증 출처 | 설정 단서 | “소진”의 의미 | 계속하는 방법 |
|---|---|---|---|
| Qwen OAuth | 과거 브라우저 로그인 정보 | 무료 등급이 종료된 것이며 재설정 대기가 아님 | /auth에서 현재 방식을 선택 |
| Coding Plan | 전용 키와 coding...dashscope.aliyuncs.com | 요금제 한도 중 하나 또는 별도 기술 제한 | 해당 한도 회복을 기다리거나 별도 과금 인증으로 전환 |
| Token Plan | 전용 키와 token-plan...maas.aliyuncs.com | 에디션, Seat 또는 공유 Pack의 Credits | 다음 주기, 허용된 추가 할당량, 또는 인증 전환 |
| 표준 API Key | 일반 지역별 Model Studio Endpoint | 잔액, 모델 무료 할당량, Token 과금 또는 Rate Limit | 과금 활성화/충전, 제한 해제 대기, Provider 변경 |
| 외부/Custom Provider | Provider의 baseUrl, 프로토콜, 모델 | 해당 Provider의 잔액, 구독 또는 제한 | Provider 콘솔 처리 또는 /auth 전환 |
모델 이름만으로는 알 수 없습니다. 같은 모델도 서로 다른 플랜과 Endpoint를 통하면 할당량과 청구가 분리됩니다.
5분 안전 진단
1. 오류 원문을 보관하기
오류 문구, 시간, 선택 모델, 요청 시작 직후인지 장기 작업 중인지 기록하세요. API Key를 스크린샷이나 문의에 넣지 마세요. 명시적인 플랜 한도 메시지가 일반 401, 403, 429, timeout, model not found보다 강한 증거입니다.
2. /doctor 실행하기
공식 인증 가이드는 현재 인증 확인 방법으로 /doctor를 제시합니다. 인증 유형, Provider, Endpoint 범주를 기록하세요. 아직 Qwen OAuth라면 돌아올 무료 할당량은 없습니다.
인증을 바꿀 때는 /auth를 사용합니다. /model은 이미 구성된 모델을 선택할 뿐, 계정·플랜·청구 출처를 반드시 바꾸는 것은 아닙니다.
3. 두 설정 범위 확인하기
사용자 ~/.qwen/settings.json과 프로젝트 .qwen/settings.json을 모두 확인하세요. 프로젝트 설정은 사용자 설정을 덮어쓸 수 있고, 환경 변수와 실행 인자는 더 높은 우선순위를 가집니다. 오래된 변수가 JSON 수정 뒤에도 이전 Provider로 보낼 수 있습니다.
프로토콜, 변수의 이름, baseUrl, 모델 ID, 리전만 확인하고 키 값은 출력하지 마세요. JSON에 직접 저장된 비밀은 가능하면 보호된 저장소로 옮기세요.
4. Endpoint와 플랜 맞추기
국제 Coding Plan은 coding-intl.dashscope.aliyuncs.com을 포함한 Endpoint를 사용합니다. 국제 Token Plan은 token-plan.ap-southeast-1.maas.aliyuncs.com을 사용합니다. 표준 pay-as-you-go는 다른 지역별 Endpoint를 사용합니다.
Coding Plan 전용 키와 일반 Model Studio 키는 서로 바꿀 수 없습니다. 잘못된 조합은 인증 오류를 만들 수 있고, 일반 키와 pay-as-you-go Endpoint 조합은 Coding Plan 대신 별도 청구를 발생시킬 수 있습니다.
5. 맞는 콘솔 열기
확인한 계정, 리전, 플랜에서 남은 사용량, 도달한 한도, 재설정 시간, 구독, 과금, 장애 또는 throttling 공지를 확인하세요.
Coding Plan을 사용하는 경우
2026년 10월 1일 기준 국제 공식 페이지의 Pro는 월 50 USD이며 세 한도가 동시에 적용됩니다.
- 5시간당 6,000 요청
- 주당 45,000 요청
- 월당 90,000 요청
먼저 도달한 한도가 호출을 중지합니다. 사용자 지시 하나가 여러 모델 호출을 만들 수 있으므로 복잡한 Agent 작업은 짧은 질문보다 빠르게 소모합니다.
5시간 한도는 롤링 방식으로 회복되고, 주간 한도는 매주 월요일 00:00(UTC+08:00), 월간 한도는 구독 갱신일 00:00(UTC+08:00)에 재설정됩니다. 주간/월간 한도라면 5시간을 기다려도 해결되지 않습니다. 콘솔에서 실제 한도를 확인하세요. 다른 리전은 가격, 통화, 판매 여부가 다를 수 있습니다.
재설정 전에 계속하려면 /auth로 표준 API Key, Token Plan, 다른 Provider로 이동할 수 있습니다. 이는 별도 할당량과 과금 경로이며 Coding Plan을 늘리지 않습니다. 키와 Endpoint는 항상 맞는 조합으로 변경하세요.
Coding Plan은 지원 도구의 대화형 사용용입니다. 공식 페이지는 자동 스크립트나 애플리케이션 Backend 사용을 금지합니다.
Token Plan을 사용하는 경우
Token Plan은 Coding Plan 요청 카운터를 공유하지 않습니다. 현재 국제 문서는 Credits로 설명하며 에디션과 할당량은 계정에 따라 다를 수 있습니다. 소비량은 모델, Token 수, 추론 모드, Tool 호출에 따라 달라집니다.
문서화된 Team Edition에서는 Seat Credits를 먼저 쓰고 공유 Pack을 사용합니다. 모든 Credits가 끝나면 다음 청구 주기 또는 허용된 Pack 추가 전까지 중지됩니다. 콘솔에서 사용률, 재설정, Seat, Pack을 확인할 수 있습니다.
에디션, 리전, Credits, 전용 Endpoint를 확인하세요. Coding Plan 재설정 규칙을 적용하지 마세요. 과금 출처를 바꾸려면 /auth로 명시적으로 전환합니다.
표준 API Key를 사용하는 경우
표준 Model Studio API는 pay-as-you-go입니다. 실제 제한은 잔액과 과금 상태, 모델/리전별 무료 할당량, Rate Limit, 용량 제어에 따라 정해집니다. 공통 “Qwen Code 주간 재설정”은 없습니다.
올바른 계정과 리전의 Usage/Billing을 확인하세요. 무료 할당량 종료나 잔액 부족이면 현재 규칙에 따라 과금을 활성화하거나 충전합니다. Rate Limit이면 안내된 창을 기다립니다.
401/403은 먼저 키, 권한, 리전, Endpoint를 점검해야 합니다. 429는 할당량, Rate Limit, 일시 throttling일 수 있습니다. 응답 본문과 콘솔을 확인하세요.
외부 Provider를 사용하는 경우
상업적 할당량은 Provider가 정합니다. 잔액, 구독, 모델 권한, 분당/동시 제한, 갱신 시간, Endpoint, Model ID를 확인하세요. 같은 Provider에서 모델만 바꾸면 같은 잔액을 쓸 수 있습니다. /auth로 Provider를 바꾸면 청구 경로가 바뀝니다.
할당량 소진인가 설정 오류인가
- Qwen OAuth 종료 명시 메시지: 인증 변경.
- 콘솔에서도 확인된 플랜 한도: 해당 회복 규칙 적용.
401/403: 키, 권한, Endpoint, 리전 확인.model not found: 지원 모델 확인. 할당량 부족 증거가 아님.429, 대기열, 짧은 중단: Rate Limit,Retry-After, 상태, 콘솔 확인.- Timeout/네트워크: 연결과 Provider 상태부터 확인.
복구 확인 방법
- Qwen Code를 재시작해 환경 변수를 다시 읽습니다.
/doctor로 의도한 인증 출처를 확인합니다./model로 지원 모델을 선택합니다.- 파일 하나를 수정하지 않고 요약하는 작은 읽기 전용 요청을 보냅니다.
- 성공과 올바른 콘솔의 사용 기록을 확인합니다.
- 그 뒤 장기 작업을 재개합니다.
작은 성공은 인증, Endpoint, 모델 조합을 확인하지만, 큰 작업에 충분한 잔량을 보장하지는 않습니다.
흔한 실수
- 주간/월간 한도인데 5시간만 기다리기.
- 재시작이 할당량을 복구한다고 생각하기.
- 키나 Endpoint 한쪽만 바꾸기.
- 프로젝트 설정이나 우선 환경 변수를 놓치기.
/model을 과금 전환으로 오해하기.- Qwen3.8 Max Token 가격을 Qwen Code 한도로 혼동하기.
- 같은 빈 계정에서 키만 새로 만들기.
- Coding Plan 키를 자동화에 사용하기.
자주 묻는 질문
공통 무료 할당량이 남아 있나요?
아니요. Qwen OAuth 무료 등급은 2026년 4월 15일 종료되었습니다. Provider별 Credits는 특정 계정, 모델, 리전에 속합니다.
재시작하면 사용량이 복구되나요?
아니요. 재시작은 설정만 다시 읽으며, 할당량은 Provider가 복구합니다.
모델 변경으로 한도를 피할 수 있나요?
새 모델이 실제로 독립 할당량을 사용할 때만 가능합니다. 같은 플랜 모델은 한도나 Credits를 공유할 수 있습니다.
새 키가 필요한가요?
기존 키가 무효, 폐기, 노출된 경우에만 필요합니다. 같은 소진 계정의 새 키는 보통 새 할당량을 만들지 않습니다.
