ZCode 사용 한도에 도달했을 때: GLM Coding Plan 할당량과 리셋 카드 확인법

ZCode에서 사용 한도에 도달했다는 메시지가 나오면 로컬 토큰 그래프부터 보고 결론 내리지 마세요. Usage Statistics → Coding Plan을 열어 5시간 한도와 주간 한도를 확인하고, 실제로 소진된 항목을 찾는 것이 먼저입니다. Reset이 보이면 카드가 어느 한도에 적용되는지와 만료 시간을 확인한 뒤 사용합니다. 카드가 없다면 ZCode가 올바른 Z.ai 또는 BigModel 계정에 로그인되어 있고 그 계정의 Coding Plan에 연결되어 있는지 확인하세요. 이후 소진된 한도의 회복을 기다리거나, 사용 가능한 카드를 적용하거나, 별도 한도와 요금이 있는 다른 공급자로 의도적으로 전환할 수 있습니다.

핵심 구분은 다음과 같습니다. App Usage는 로컬 사용 기록이고, Coding Plan은 원격 구독 할당량이며, 일반 API Key는 별도 접근 권한과 과금 체계를 가집니다. 하나의 수치가 다른 항목을 자동으로 충전하거나 상태를 증명하지 않습니다.

이 글은 2026년 10월 3일 ZCode와 Z.ai 공식 문서를 기준으로 확인했습니다. 플랜 규칙과 카드 지급 조건은 바뀔 수 있으므로 최종 판단은 본인 계정에 표시되는 잔여량과 버튼을 기준으로 하세요.

60초 확인 순서

1. Usage Statistics에서 App Usage가 아니라 Coding Plan을 선택합니다.
2. 5시간, 주간, 그리고 도구를 사용한 작업이라면 MCP 한도도 확인합니다.
3. 올바른 Z.ai 또는 BigModel Coding Plan과 개인·팀 계정이 선택되어 있는지 확인합니다.
4. Reset이 보이면 대상 한도와 만료 시간을 읽고 사용합니다.
5. 카드가 없으면 소진된 항목에 표시된 회복 시각을 기다리거나 설정된 다른 공급자를 명확히 선택합니다.
6. 긴 에이전트 작업을 다시 시작하기 전에 짧은 테스트 지시를 한 번 보냅니다.

이 순서를 따르면 로컬 통계를 구독 잔액으로 오해하거나, 별도 API 잔액을 Coding Plan의 연장으로 착각하는 일을 피할 수 있습니다.

올바른 사용량 화면을 확인하세요

공식 Usage Stats 문서는 목적이 다른 두 화면을 구분합니다.

화면 또는 한도	알 수 있는 내용	알 수 없는 내용
App Usage	현재 기기에 저장된 ZCode 세션, 토큰, 메시지, 활동일, 모델 분포	원격 GLM Coding Plan에 할당량이 남았는지
Coding Plan: 5-hour	현재 단기 창의 잔여량	주간 한도가 남았는지
Coding Plan: weekly	현재 주간 주기의 잔여량	5시간 한도가 이미 회복됐는지
MCP quota	플랜에 포함된 도구 호출의 잔여량	일반 모델 생성도 모두 소진됐는지
별도 API-Key 공급자	해당 공급자의 가용성과 잔액	Z.ai 또는 BigModel Coding Plan이 충전됐는지

App Usage가 높다는 것은 이 기기에서 사용량이 많았다는 뜻일 뿐입니다. 반대로 낮더라도 다른 기기, 지원 도구, 팀 연결에서 같은 플랜을 사용했다면 원격 한도는 줄어들 수 있습니다.

어떤 한도가 요청을 막는지 찾으세요

Coding Plan에는 여러 제한이 함께 적용됩니다. 다음 행동을 정하기 전에 화면에 보이는 모든 카운터를 확인하세요.

5시간 한도는 0이고 주간 한도는 남아 있는 경우

즉시 막는 항목은 단기 창입니다. ZCode가 5시간용 카드를 표시하면 사용하고, 없다면 계정에 표시된 회복 시각까지 기다립니다. 현재 개인 플랜 문서는 5시간 크레딧이 사용 후 동적으로 회복된다고 설명하지만 정확한 시각은 계정 화면을 우선해야 합니다.

주간 한도가 0인 경우

5시간 한도에 잔량이 있어도 소진된 주간 한도를 우회할 수 없습니다. 주간 리셋 카드가 있는지 확인하고, 없다면 계정에 표시되는 다음 주간 회복까지 기다립니다. 현행 플랜은 7일 주기를 안내하지만 구형 플랜이나 팀 플랜은 별도 조건을 표시할 수 있습니다.

MCP만 0인 경우

MCP는 도구용 별도 한도입니다. 웹 검색, 페이지 읽기 또는 다른 포함 도구가 필요한 작업은 모델 한도가 남아 있어도 실패할 수 있습니다. 문제를 구분하려면 해당 도구가 필요 없는 짧은 요청을 보내세요. 이 테스트는 한도를 늘리지 않고 모델 경로가 여전히 동작하는지만 확인합니다.

Coding Plan 화면이 없거나 계속 로딩되는 경우

한도 소진으로 단정하지 말고 연결부터 확인하세요. 로그인 계정, 공급자, 선택 플랜, 네트워크 접근성을 점검해야 합니다.

계정과 플랜 연결을 확인하세요

채팅 입력창의 모델 이름을 클릭하고 Manage Models를 선택한 뒤 Settings → Model Settings로 이동합니다. 공식 Connect Models & Plans 안내는 활성 GLM Coding Plan이 있는 Z.ai 계정을 인증하면 ZCode가 그 계정의 플랜과 한도를 직접 사용한다고 설명합니다.

다음 순서로 확인하세요.

1. 공급자: Z.ai 또는 BigModel이 활성화되어 있습니다.
2. 계정: 구독을 보유한 계정이 표시됩니다.
3. 연결 방식: 의도한 Coding Plan을 사용하며 무관한 API Key가 선택되지 않았습니다.
4. 플랜 범위: 개인과 팀 플랜이 모두 있으면 올바른 항목을 선택했습니다. 좌석이 배정되지 않은 팀 항목은 팀 한도를 제공하지 않습니다.
5. 현재 채널: 현재 대화가 실제로 같은 공급자와 플랜을 사용합니다.

이 연결은 리셋 카드 자격에도 영향을 줍니다. 공식 문서에 따르면 ZCode에 로그인하고 그 계정의 Coding Plan에 연결된 사용자에게만 카드가 지급됩니다. API Key만 쓰거나, 로그인한 계정에 Coding Plan이 없으면 카드 대상이 아닙니다.

Connect가 Loading에 머문다면 공식 FAQ에 따라 모델 서비스로의 네트워크 연결과 계정 또는 API Key의 한도·모델 권한을 모두 확인하세요.

ZCode가 표시한 카드만 사용하세요

ZCode 3.8.1 이상에서는 공급자 패널과 Coding Plan 탭에 사용 가능한 5시간 또는 주간 리셋 기회가 나타날 수 있습니다. 카드가 있으면 다음과 같이 진행합니다.

1. Reset을 클릭합니다.
2. Resettable quota에서 적용 대상 한도를 확인합니다.
3. 만료 시간을 확인합니다.
4. 유효 기간 안에 사용합니다.
5. Coding Plan을 다시 열어 대상 카운터가 100%가 되고 카드가 사용 완료로 표시되는지 확인합니다.

카드에는 만료 시간이 있습니다. 여러 장이 있으면 공식 문서상 가장 먼저 받은 카드부터 사용됩니다.

카드가 나타나지 않을 수 있는 이유

버튼이 없다고 해서 오류는 아닙니다. 자동 5시간 카드는 조건부입니다. 해당 비혼잡 시간대여야 하고, 사용량이 임계값을 넘어야 하며, 하루 지급 상한에 도달하지 않아야 합니다. 시간대와 임계값은 동적으로 조정되며, 카드용 비혼잡 시간대는 idle-time tasks의 시간대와도 다릅니다.

다른 사용자의 화면에 나온 특정 시각이나 비율을 고정 규칙으로 받아들이지 마세요. 본인 앱에 카드가 표시될 때만 사용할 수 있습니다. 카드가 없다면 연결을 한 번 확인하고 일반 회복 시각을 기준으로 작업을 계획하세요.

작업 재개 방법을 선택하세요

방법 1: 막힌 한도가 회복될 때까지 기다리기

작업을 멈출 수 있다면 가장 예측 가능한 방법입니다. 5시간 또는 주간 중 어느 항목이 소진됐는지 기록하고 화면의 시각을 따르세요. 롤링 5시간 창이 자정에 초기화된다고 가정하면 안 되며, 단기 한도가 돌아와도 주간 한도가 0이면 사용할 수 없습니다.

기다리는 동안 다음 프롬프트를 정리하고, 불필요한 컨텍스트를 줄이고, 로컬 테스트를 실행하거나 큰 작업을 검증 가능한 단계로 나눌 수 있습니다. 한도를 늘리지는 않지만 회복 후 불필요한 재시도를 줄여 줍니다.

방법 2: 사용 가능한 리셋 카드 적용하기

만료 전에 표시된 대상에만 사용하세요. 5시간 카드가 주간 한도까지 리셋하는 것은 아니며, 주간 카드도 일반 API 잔액이 아닙니다. 성공 신호는 대상 카운터가 100%로 돌아오는 것입니다.

방법 3: 설정된 다른 공급자로 의도적으로 전환하기

ZCode는 별도 모델 공급자와 API-Key 연결을 지원합니다. 작업을 계속할 수는 있지만, 이는 새로운 접근 경로이지 소진된 Coding Plan의 추가 한도가 아닙니다.

전환하기 전에 다음을 확인하세요.

• 해당 공급자의 자체 한도, 가격, 지원 모델
• 모델 선택기에서 그 공급자를 명확히 선택했는지
• 짧은 테스트 지시에 응답하는지
• 어느 계정에 요금이 청구되는지
• 비밀 API Key를 채팅, 스크린샷, 공개 Issue에 노출하지 않았는지

공식 설정 문서는 Coding Plan과 일반 API 리소스 패키지·선불 잔액을 구분하고, coding 경로와 general 경로가 서로 대체되지 않는다고 경고합니다. 별도 API 잔액은 별도 비용이 발생할 수 있으며 플랜 카운터를 회복시키지 않습니다.

증상별 빠른 진단표

화면 상태	가능성이 높은 의미	다음 행동	성공 신호
App Usage는 높지만 Coding Plan은 정상	로컬 기록이 원격 제한 원인이 아님	선택 채널과 정확한 오류 확인	올바른 플랜에서 짧은 요청 성공
5-hour = 0%, weekly는 남음	단기 창이 막음	5시간 카드 또는 대기	단기 카운터 회복
weekly = 0%	주간 한도가 막음	주간 카드 또는 대기	주간 카운터 회복
MCP = 0, 모델 한도는 남음	특정 도구만 제한됐을 수 있음	도구 없이 테스트 후 MCP 대기	일반 모델 또는 MCP 사용 가능
Reset이 없음	현재 대상 카드가 표시되지 않음	로그인과 플랜 확인, 카드를 권리로 가정하지 않기	나중에 카드가 나타나거나 일반 회복
Connect가 Loading	네트워크, 계정, 권한 가능성	연결과 계정·Key 확인	공급자가 로드되고 테스트 응답
Reset 후에도 같은 오류	다른 한도, 오래된 화면, 다른 채널 가능성	새로고침하고 채널 재확인	대상 카운터와 요청 정상

한도가 회복됐는데도 계속 실패하는 경우

긴 작업을 바로 반복하지 말고 통제된 재확인을 하세요.

1. 공급자 패널과 Usage Statistics → Coding Plan을 새로고침합니다.
2. 회복된 한도가 현재 대화에서 선택한 같은 개인 또는 팀 플랜의 것인지 확인합니다.
3. 새 짧은 대화를 열고 최소 지시를 보냅니다.
4. 성공하면 큰 작업을 체크포인트부터 이어갑니다.
5. 실패하면 정확한 오류, 시간과 시간대, ZCode 버전, 공급자, 플랜 종류, 한도 화면을 기록합니다. API Key와 민감 정보는 가리세요.

공식 Feedback & Support 안내는 사용 맥락, 재현 단계, 스크린샷, 관련 로그를 포함하라고 권장합니다. ZCode에는 앱 내 피드백과 오류 배너의 Feedback 기능도 있습니다.

최종 확인 목록

긴 코딩 세션을 시작하기 전에 다음을 확인하세요.

• App Usage뿐 아니라 Coding Plan을 확인했습니다.
• 5-hour, weekly, MCP 중 무엇이 막는지 알고 있습니다.
• 올바른 계정과 개인·팀 플랜이 연결되어 있습니다.
• 카드가 올바른 한도용이고 만료되지 않았습니다.
• 대체 공급자를 별도 한도와 별도 과금으로 이해했습니다.
• 사용할 채널에서 짧은 테스트가 성공했습니다.

ZCode 한도 문제를 안정적으로 처리하는 방법은 먼저 실제로 적용되는 카운터를 찾고, 본인 계정에 표시된 리셋 기회만 사용하며, 모든 대체 공급자를 Coding Plan의 숨은 추가 한도가 아닌 별도 서비스로 다루는 것입니다.