본문으로 건너뛰기

GLM Coding Plan 429 오류 해결: 1308·1302·1113·1305 코드별 원인

같은 429라도 1308·1310이면 재설정 시각까지 기다리고, 1302면 병렬 세션을 줄이고, 플랜이 있는데 1113이면 10월 16일 이후 만든 키가 Standard 키인지부터 확인합니다.

••12 분 분량•문제 해결
HTTP 429 응답 카드에서 1308 재설정 시각까지 대기, 1302 병렬 세션 줄이기, 1113 키·Base URL 점검, 1305 간격 두고 재시도의 네 갈래로 나뉘는 GLM Coding Plan 429 오류 진단 표지

GLM Coding Plan에서 나는 한도·속도·정책 거부는 거의 모두 HTTP 429 하나로 돌아옵니다. 그래서 "429가 떴다"만으로는 기다려야 하는지, 설정을 고쳐야 하는지, 재시도해 봐야 소용없는지 알 수 없습니다. 원인은 응답 본문 JSON의 error.code와 message에 있습니다.

먼저 코드 번호를 확인하고 아래처럼 나누면 대부분 바로 방향이 잡힙니다(2026년 10월 22일 기준, Z.ai 오류 코드 문서).

  • 1308, 1310: 5시간 또는 주간 사용량 한도를 다 썼습니다. 메시지에 찍힌 재설정 시각(next_flush_time)까지 재시도는 소용없습니다.
  • 1302: 요청 속도·동시 실행 제한입니다. 병렬로 띄운 터미널과 서브에이전트를 줄이면 풀립니다.
  • 1113(플랜이 있는데 '잔액 부족'): 요청이 플랜이 아니라 계정 잔액 쪽으로 가고 있습니다. 2026년 10월 16일 이후 새로 만든 키라면 Standard 키인지, Base URL이 플랜 전용 주소인지부터 확인하세요.
  • 1305: 공식 문구는 일시적 과부하입니다. 잠시 뒤에도 같은 요청만 계속 막힌다면 요청 내용이 걸렸을 가능성을 의심합니다.
  • 1309, 1311, 1313: 플랜 만료, 플랜에 없는 모델, 공정 사용 정책 제한입니다. 기다려도 풀리지 않으니 갱신·모델 변경·해제 신청이 필요합니다.

429 응답 본문에서 error.code 찾는 법

Z.ai의 오류는 두 겹입니다. 바깥은 HTTP 상태 코드, 안쪽은 Z.ai가 정의한 업무 오류 코드입니다. 본문은 항상 아래 모양의 JSON이고, 메시지의 {…} 자리에는 실제 값이 채워집니다.

json
{"error":{"code":"1308","message":"Usage limit reached for {number} {unit}. Your limit will reset at {next_flush_time}"}}

도구별로 확인할 곳은 다음과 같습니다.

  • 오류 줄에 JSON이 같이 보일 때: code 값만 읽으면 됩니다. 중국판 Zhipu BigModel(open.bigmodel.cn)은 같은 번호에 중국어 메시지를 붙입니다. 예를 들어 1113은 您的账户已欠费,请充值后重试, 1305는 该模型当前访问量过大,请您稍后再试입니다(BigModel 오류 코드).
  • Claude Code처럼 Anthropic 호환 주소(/api/anthropic)를 쓸 때: 사용자 보고에 따르면 같은 1305가 HTTP 529: [1305][The service may be temporarily overloaded, please try again later]처럼 대괄호 형태로, 그리고 429가 아닌 529로 찍히기도 했습니다(hermes-agent #89278). 상태 숫자보다 대괄호 안의 코드를 보세요.
  • 도구가 "retrying…"만 반복할 때: 도구의 디버그 출력이나 요청 로그에서 응답 본문을 찾습니다. 그래도 안 보이면 공식 지원 도구에서 같은 플랜 키·같은 플랜 주소로 새 세션을 열어 한 줄짜리 요청을 보내 봅니다. Claude Code라면 새 터미널에서 claude -p "hi"처럼 짧은 프롬프트 하나만 실행하면 됩니다. 이 요청이 통과하는지, 실패한다면 어떤 코드가 찍히는지가 진단의 출발점입니다.

플랜 키를 curl, SDK, 직접 만든 스크립트에 넣어 원인을 확인하는 방법은 피하세요. 구독 약관은 지원하지 않는 도구(SDK 기반 접근 등)를 통한 사용이 감지되면 구독 혜택 일부가 제한될 수 있다고 밝히고, 이용 규칙 위반은 속도 제한이나 계정 동결로 이어질 수 있습니다(구독 약관 4조).

한 가지 예외가 있습니다. 스트리밍(SSE) 응답이 생성 도중에 비정상 종료되면 위 오류 코드가 오지 않고, 이유가 응답의 finish_reason에 담깁니다. 답이 중간에 끊긴 증상은 아래 진단표가 아니라 finish_reason으로 봐야 합니다.

GLM Coding Plan 429 코드별 원인과 조치 진단표

모든 행의 HTTP 상태는 429입니다. 메시지는 Z.ai 국제판 원문의 핵심 부분입니다.

코드메시지(원문 일부)뜻먼저 할 일그냥 재시도하면
1308Usage limit reached for {number} {unit}5시간 등 기간 사용량 한도 소진next_flush_time 확인 후 대기, 무거운 작업은 비혼잡 시간으로재설정 전에는 실패
1310Weekly/Monthly Limit Exhausted주간(월간) 한도 소진재설정 시각 확인, 업그레이드·종량제 여부 판단재설정 전에는 실패
1302Rate limit reached for requests요청 속도·동시 실행 제한병렬 세션·서브에이전트 줄이기, 간격 두고 재시도간격을 두면 대개 통과
1305The service may be temporarily overloaded서버 과부하. 오래 이어지면 요청 내용 의심잠시 뒤 재시도, 계속되면 새 세션의 짧은 요청과 비교과부하면 통과, 내용 문제면 계속 실패
1113Insufficient balance or no resource package요청이 잔액 과금 경로로 감키 종류·Base URL·모델 점검계속 실패
1309Your GLM Coding Plan package has expired플랜 만료갱신하거나 Standard 키로 전환계속 실패
1311does not yet include access to ${model_name}플랜에 없는 모델 요청모델을 glm-5.3·glm-5.3-flash로계속 실패
1313does not comply with the Fair Usage Policy공정 사용 정책 위반 판정, 요청 빈도 제한Plan Overview에서 알림 확인 후 해제 신청계속 실패
1314Your enterprise package has expired기업용 플랜 만료기업 관리자에게 문의계속 실패
1315This API Key is limited to enterprise coding package scenarios기업용 전용 키를 다른 용도에 사용해당 제품 종류의 키로 교체계속 실패
1316, 1317Insufficient balance for extra usage5시간·7일 한도 소진 + 초과 사용에 쓸 잔액 부족충전 또는 재설정 대기재설정 전에는 실패
1318~1321Extra usage is not available due to monthly spend limit한도 소진 + 월 지출 상한 도달(하위 계정·기업)관리자에게 상한 조정 요청 또는 대기재설정 전에는 실패

1318~1321은 영어 메시지가 두 쌍씩 똑같아 구분이 안 됩니다. 중국어 표에는 1318·1319가 하위 계정 월 소비 상한, 1320·1321이 기업 단위 월 소비 상한으로 나뉘어 있습니다.

재시도가 소용없는 코드에서 도구가 자동 재시도를 계속하면 시간만 버립니다. 1308·1310·1113·1309·1311·1313이 보이면 에이전트를 멈추고 아래 해당 절의 조치로 넘어가세요.

1308·1310 사용량 한도 소진: 재설정 시각과 크레딧 계산

1308과 1310은 플랜의 5시간 한도나 주간 한도를 다 쓴 상태입니다. 공식 지원 도구에서는 한도를 다 써도 계정 잔액에서 자동으로 빠지지 않고, 다음 회복을 기다리는 방식입니다(Z.ai FAQ). 그래서 이 두 코드는 재설정 전까지 몇 번을 다시 보내도 통과하지 않습니다.

5시간 한도는 롤링, 주간 한도는 구독 시점 기준 7일

  • 5시간 한도: 정해진 시각에 한꺼번에 초기화되지 않습니다. 쓴 크레딧이 사용 시점으로부터 5시간 뒤에 차례로 돌아옵니다. 짧은 시간에 몰아 쓴 경우에는 그 시간대가 지나야 크게 회복됩니다.
  • 주간 한도: 구독한 시점부터 시작해 7일마다 재설정됩니다. 날짜는 계정마다 다르므로 콘솔의 Subscription 페이지에서 사용 진행률과 함께 확인합니다.
  • 메시지의 시각: 1308·1310·1316~1321 메시지에는 Your limit will reset at {next_flush_time} 또는 Resets at {next_flush_time}로 다음 재설정 시각이 찍힙니다. 시간대 표기가 없으면 콘솔 화면의 시각과 대조해 판단하세요. Z.ai 공지는 싱가포르 시간(UTC+8)을 기준으로 씁니다.

캠페인 때만 지급되는 Quota Reset Card가 있다면 즉시 한도를 채울 수 있습니다. 카드를 쓰면 해당 한도의 재설정 주기도 그 시점부터 다시 계산됩니다.

새 크레딧 요금제 한도와 GLM-5.3 소모량

2026년 7월 30일 이후 판매되는 개인 플랜의 한도는 다음과 같습니다(Z.ai 플랜 개요). 여기서 크레딧은 돈이 아니라 플랜 사용량 단위입니다.

플랜5시간 크레딧주간 크레딧
Lite2,00010,000
Pro12,00060,000
Max28,000140,000

크레딧 = (입력 토큰 × 입력 계수 + 캐시 입력 토큰 × 캐시 계수 + 출력 토큰 × 출력 계수) ÷ 10,000이고, 계수는 GLM-5.3이 6.9 / 1.7 / 24, GLM-5.3-Flash가 2.3 / 0.56 / 8입니다. 비혼잡 시간에는 모델 사용량이 기본의 50%로 계산됩니다.

예를 들어 캐시되지 않은 입력 4,000토큰, 캐시 입력 36,000토큰, 출력 1,000토큰인 요청 하나를 가정하면 다음과 같습니다.

  • GLM-5.3: (4,000×6.9 + 36,000×1.7 + 1,000×24) ÷ 10,000 = 11.28크레딧(비혼잡 시간 5.64)
  • GLM-5.3-Flash: (4,000×2.3 + 36,000×0.56 + 1,000×8) ÷ 10,000 = 약 3.74크레딧(비혼잡 시간 약 1.87)

같은 요청이라도 GLM-5.3은 Flash의 약 3배를 씁니다. 이 가정이라면 Lite의 5시간 2,000크레딧은 혼잡 시간 GLM-5.3 요청 약 177회 분량입니다. 실제 에이전트 요청은 캐시 비율과 출력 길이가 매번 달라 숫자가 크게 움직이므로, 콘솔의 Charge Type 페이지에서 실제 토큰 사용량으로 다시 계산해 보는 것이 정확합니다.

혼잡 시간은 월금 14:0018:00(UTC+8), 한국 시간으로 평일 15:00~19:00입니다. 오후에 여러 터미널에서 GLM-5.3을 동시에 돌리면 한도가 가장 빨리 줄어듭니다.

평일 한국 시간 15시~19시 혼잡 구간이 표시된 타임라인과, 예시 요청 1회의 크레딧을 GLM-5.3 혼잡 11.28·비혼잡 5.64, GLM-5.3-Flash 약 3.74·약 1.87로 비교한 막대 그래프

이전 플랜(Legacy Plan) 사용자는 기준이 다릅니다

2026년 7월 30일 이전에 가입해 아직 주기가 끝나지 않은 이전 플랜은 크레딧이 아니라 프롬프트 수로 계산합니다(요금제 개편 공지). Legacy Plan V2의 공식 추정치는 Lite 5시간 약 80회·주 약 400회, Pro 약 400회·약 2,000회, Max 약 1,600회·약 8,000회이고, GLM-5.3은 혼잡 시간에 3배로 차감됩니다. 활성 이전 플랜은 주말 사용량이 종일 비혼잡 요율로 계산됩니다. 내 플랜이 어느 쪽인지는 My plan 화면의 "Legacy Plan V1", "Legacy Plan V2" 표시로 확인합니다.

한도를 다 썼을 때 고를 수 있는 것

  • 기다리기: 급하지 않다면 next_flush_time까지 기다리는 것이 추가 비용이 없습니다.
  • 소모 줄이기: Claude Code의 Haiku 매핑이나 서브에이전트를 glm-5.3-flash로 돌리면 같은 작업의 크레딧이 약 3분의 1로 줄어듭니다. 대량 작업은 한국 시간 평일 19시 이후나 오전, 주말로 옮깁니다.
  • 상위 등급 업그레이드: Z.ai는 다른 등급으로 올리면 즉시 적용되고 남은 기간 가치는 잔액으로 환산해 차액에 씁니다. 업그레이드 직후 크레딧이 바로 새 등급만큼 채워지는지는 Z.ai 문서에 적혀 있지 않습니다(BigModel은 업그레이드 즉시 새 등급 크레딧으로 갱신된다고 안내합니다). 구독은 환불되지 않으니, 한도 소진이 일시적인지 반복되는지부터 보고 결정하세요.
  • 종량제로 이어 쓰기: 아래 "재설정을 기다릴 수 없을 때" 절의 Standard 키 방법입니다.

1302와 '동접 리밋': 병렬 터미널과 서브에이전트 줄이기

1302 Rate limit reached for requests는 쓴 양이 아니라 한꺼번에 보내는 요청이 많아서 걸리는 제한입니다. 한도가 넉넉히 남아 있어도 터미널 여러 개에서 Claude Code를 동시에 돌리거나, 한 세션이 서브에이전트를 여러 개 띄우면 나올 수 있습니다.

Z.ai는 동시 실행 한도를 플랜 등급에 묶어 두고 자원 상황에 따라 동적으로 조정한다고만 밝힙니다(Max > Pro > Lite). 공식 권장은 Lite는 한 번에 프로젝트 1개, Pro는 1~2개, Max는 2개 이상이고, 비혼잡 시간에는 동시 실행 한도가 더 높아집니다(Z.ai 사용 정책). 플랜별 동시 접속 수나 RPM 숫자는 2026년 10월 22일 기준 공개되어 있지 않습니다. 올해 초 국내 SNS에서 "Z.ai가 동접 리밋을 1개로 낮췄다"는 체감 글이 돌았지만, 이것도 공식 수치가 아니라 사용자 경험입니다.

숫자가 없으니 실제로 할 수 있는 조치는 다음과 같습니다.

  1. 동시에 도는 세션 수를 권장치까지 줄입니다. Lite에서 여러 프로젝트를 터미널 여러 개로 동시에 돌리는 방식은 권장 범위 밖입니다.
  2. 서브에이전트 병렬 수를 줄이거나 순차 실행으로 바꿉니다. 한 프로젝트 안에서도 서브에이전트마다 요청이 따로 나갑니다.
  3. 병렬 작업은 비혼잡 시간으로 옮깁니다. 한국 시간 평일 15:00~19:00을 피하면 동시 실행 여유도 커지고 크레딧도 절반만 듭니다.
  4. 재시도 간격을 늘립니다. 실패 즉시 반복 재시도하면 같은 제한에 계속 부딪힙니다.

여러 계정을 돌려 쓰거나 키를 나눠 쓰는 방식, 중계·집계 서비스로 요청을 분산하는 방식은 동시 실행 문제를 풀어 주지 않습니다. 계정 공유와 중계는 이용 규칙 위반이라 아래 1313이나 계정 동결로 이어질 수 있습니다.

플랜이 있는데 1113 '잔액 부족': 10월 16일 API 키 분리와 Base URL

플랜을 구독 중인데 Insufficient balance or no resource package. Please recharge.가 나오면, 요청이 플랜 한도가 아니라 계정 잔액으로 과금되는 경로로 들어간 것입니다. Z.ai FAQ는 원인으로 지원하지 않는 도구, 잘못된 Base URL, 플랜에 없는 모델 세 가지를 듭니다. 여기에 2026년 10월 16일부터 키 종류가 한 가지 더 추가됐습니다.

1단계: 키를 어디서 만들었는지 확인

2026년 10월 16일부터 표준 API 키와 Coding Plan 키가 따로 관리됩니다(API 키 관리 안내).

키 종류만드는 곳과금
개인 플랜 키API Keys → Personal Coding Plan 탭개인 플랜 한도 사용
Team Plan 키Team Coding Plan → My Plan팀 플랜·좌석 규칙
Standard API KeyAPI Keys → Standard API Key계정 잔액·리소스 패키지, 플랜 한도 미사용

10월 16일 이후 만든 키는 키 종류가 과금을 결정합니다. 엔드포인트를 플랜 주소로 바꿔도 Standard 키는 플랜 한도를 쓰지 않고 잔액에서 과금됩니다. 최근에 키를 새로 만들었는데 1113이 시작됐다면 이 경우일 가능성이 가장 높습니다. Personal Coding Plan 탭에서 키를 새로 만들어 도구에 넣으세요. 탭이 보이지 않으면 플랜을 구독한 계정으로 로그인했는지 확인합니다.

10월 16일 이전에 만든 키는 자동 분류됐습니다. 플랜을 쓴 적이 있는 계정의 기존 키는 "Compatible"로 표시되고, 예전처럼 엔드포인트가 과금을 결정합니다. 이 키로 https://api.z.ai/api/paas/v4 (표준 API)를 부르면 플랜 한도가 남아 있어도 잔액에서 과금됩니다.

10월 16일 이후 키는 Personal Coding Plan이면 플랜 한도, Standard API Key면 잔액 과금으로, 이전 Compatible 키는 /api/coding/paas/v4면 플랜 한도, /api/paas/v4면 잔액 과금으로 갈리는 판단 흐름도

2단계: Base URL이 플랜 전용 주소인지 확인

용도Z.ai (국제판)BigModel (중국판)
Claude Code, Goose (Anthropic Messages)https://api.z.ai/api/anthropichttps://open.bigmodel.cn/api/anthropic
OpenCode, Cline, Roo Code 등 (OpenAI Chat Completions)https://api.z.ai/api/coding/paas/v4https://open.bigmodel.cn/api/coding/paas/v4
Codex 등 (OpenAI Responses)https://api.z.ai/api/v1https://open.bigmodel.cn/api/v1
표준 API(플랜 아님)https://api.z.ai/api/paas/v4https://open.bigmodel.cn/api/paas/v4

마지막 줄의 /api/paas/v4는 coding이 빠진 표준 API 주소입니다. 한 단어 차이라 가장 흔히 섞입니다. Z.ai와 BigModel은 계정·콘솔·키가 서로 다르므로, Z.ai 키로 open.bigmodel.cn을 부르거나 그 반대로 해도 동작하지 않습니다.

Claude Code는 Z.ai 안내대로 ~/.claude/settings.json의 env에 다음처럼 넣습니다. 수정 후에는 Claude Code 창을 모두 닫고 새 터미널에서 다시 실행해야 반영됩니다.

json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "Personal Coding Plan 탭에서 만든 키",
    "ANTHROPIC_BASE_URL": "https://api.z.ai/api/anthropic",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-5.3-flash[1m]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5.3[1m]",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5.3[1m]",
    "API_TIMEOUT_MS": "3000000"
  }
}

3단계: 모델과 도구가 설정대로 동작하는지 확인

  • 모델: 플랜이 지원하는 모델은 GLM-5.3과 GLM-5.3-Flash입니다. GLM-5.2·5.1 요청은 GLM-5.3으로, GLM-4.7은 GLM-5.3-Flash로 자동 전환됩니다. 그 밖의 모델 이름은 1311로 거부됩니다.
  • 도구: 플랜 한도는 Claude Code, Codex, OpenCode, Cline, Roo Code, Kilo Code, Cursor, TRAE, Hermes Agent, OpenClaw 등 공식 지원 도구에서만 쓸 수 있습니다. 직접 만든 앱이나 SDK 호출은 플랜 범위 밖입니다.
  • 도구가 Base URL을 무시하는 경우: Hermes Agent 사용자 보고에서는 설정 파일의 base_url을 고쳐도 일부 기능이 /api/paas/v4를 직접 써서 1113이 반복됐습니다(hermes-agent #18302). 설정을 고쳤는데도 그대로라면 도구 로그에서 실제 요청 주소를 확인하세요.

Claude Code가 지정한 주소를 실제로 쓰고 있는지 확인하는 방법은 Claude Code ANTHROPIC_BASE_URL 안 될 때: 증상별 진단과 2.1.299 수정에 따로 정리되어 있습니다.

1305 '일시적 과부하'가 계속될 때: 과부하인지 요청 내용인지

1305의 공식 메시지는 The service may be temporarily overloaded, please try again later입니다. 속도 제한이 아니라 서버 쪽 과부하를 뜻하므로, 기본 대응은 몇 분 간격을 두고 다시 보내는 것입니다. 혼잡 시간대(한국 시간 평일 15:00~19:00)라면 그 시간을 피하는 것도 방법입니다.

판단이 달라지는 것은 같은 작업에서만 1305가 끝없이 반복될 때입니다. hermes-agent 사용자들은 2026년 7~8월 GitHub 이슈에서 실제 과부하가 아닌 1305를 보고했습니다.

  • 시스템 프롬프트에 "Hermes Agent"라는 문구가 들어 있으면 매번 1305로 거부되고, "Hermes"로 바꾸면 같은 키·같은 주소에서 200이 나왔다는 이분 탐색 결과(#89278).
  • 시스템 프롬프트에 함수 호출 형태의 텍스트 skill_view(name='hermes-agent')가 있으면 거부되고, 같은 길이의 다른 문장으로 바꾸면 통과했다는 보고(#56816). 이때 5시간 한도는 1%만 쓴 상태였고 동시 실행도 원인에서 배제됐습니다.

Z.ai가 이런 필터를 공식 확인한 적은 없고, 2026년 10월 22일 기준 두 이슈는 열려 있습니다. Hermes Agent는 공식 지원 도구 목록에 있으므로 정책 위반이 아니라 요청 내용에 반응하는 동작으로 보는 것이 맞습니다.

여기서 나오는 판단 기준은 이렇습니다. 1305가 계속되는데, 같은 키·같은 주소로 연 새 세션의 짧은 요청은 성공한다면 서버 과부하보다 요청 내용을 먼저 의심합니다. 이 경우 확인할 순서는 다음과 같습니다.

  1. 같은 도구에서 새 세션을 열고 한 줄 프롬프트로 응답이 오는지 봅니다(Claude Code라면 claude -p "hi").
  2. 도구를 최신 버전으로 올립니다. 문제 문구를 바꾼 수정이 들어갔을 수 있습니다.
  3. 직접 넣은 시스템 프롬프트나 규칙 파일이 있다면 절반씩 빼 가며 어느 부분에서 막히는지 좁힙니다.
  4. 원인을 좁히지 못하면 오류 내용과 요청 ID를 붙여 Z.ai 기술 지원에 문의합니다.

재시도로 풀리지 않는 429: 1309·1311·1313과 기업용 코드

  • 1309 플랜 만료: z.ai/subscribe에서 갱신하면 다시 쓸 수 있습니다. 만료 뒤 기존 Compatible 키로 플랜 주소를 부르면 자동으로 종량제로 넘어가지 않고 그냥 멈춥니다. 갱신 대신 종량제로 이어 쓰려면 Standard API Key를 새로 만들어 교체해야 합니다(엔드포인트는 그대로 둬도 됩니다).
  • 1311 플랜에 없는 모델: 도구의 모델 설정을 glm-5.3 또는 glm-5.3-flash로 바꿉니다. 오래된 설정 파일에 남은 예전 모델 이름이 흔한 원인입니다.
  • 1313 공정 사용 정책: 계정의 사용 패턴이 정책에 맞지 않는다고 판정되어 요청 빈도가 제한된 상태입니다. 콘솔의 Plan Overview 페이지에서 위험 알림을 확인하고 해제를 신청합니다(BigModel은 개인 센터 → 编程套餐总览 상단의 해제 신청). 판정 기준은 공개되어 있지 않습니다. 다만 이용 규칙은 지원하지 않는 도구·자체 앱·봇에서의 사용, 계정 공유, 재판매, 중계·집계를 금지하고, 위반 시 속도 제한이나 동결, 3회를 넘으면 정지까지 가능하다고 밝힙니다. 해당하는 사용 방식이 있다면 신청 전에 정리하는 것이 순서입니다.
  • 1314·1315 기업용 플랜: 1314는 기업 플랜 만료이므로 기업 관리자에게 문의합니다. 1315는 기업용 코딩 플랜 전용 키를 다른 용도로 쓴 경우라, 사용하려는 제품 종류에 맞는 키로 바꿉니다.
  • 1316~1321 초과 사용 실패: 한도를 넘긴 뒤 초과 사용(extra usage)으로 이어 쓰려 했지만 잔액이 부족하거나(1316·1317) 월 지출 상한에 걸린 것입니다(1318~1321). 팀 플랜은 관리자가 미리 초과 사용을 켜고 구성원별 지출 상한을 정할 수 있으니 관리자에게 충전이나 상한 조정을 요청합니다. 개인 플랜에서 초과 사용을 켜는 방법은 공개 문서에 없습니다.

재설정을 기다릴 수 없을 때: Standard 키 종량제로 이어 쓰기

작업을 지금 끝내야 하는데 1308·1310으로 막혔다면, 공식 경로는 Standard API Key를 만들어 종량제로 쓰는 것입니다. API Keys 페이지에서 Standard API Key를 만들고 계정에 잔액을 넣은 뒤 도구의 키를 바꾸면 플랜 한도와 상관없이 잔액에서 과금됩니다. 재설정 뒤 플랜으로 돌아갈 때는 키만 다시 플랜 키로 바꾸면 됩니다.

Z.ai 표준 API 가격은 100만 토큰당 다음과 같습니다(Z.ai 가격).

모델입력캐시 입력출력
GLM-5.3$1.4$0.26$4.4
GLM-5.3-Flash$0.15$0.03$0.50

앞의 예시 요청(캐시되지 않은 입력 4,000, 캐시 입력 36,000, 출력 1,000토큰)을 GLM-5.3 종량제로 보내면 0.0056 + 0.00936 + 0.0044 = 약 $0.019입니다. 에이전트 작업은 요청 수가 많으니, 잠깐 이어 쓰는 용도인지 계속 쓰는 용도인지에 따라 업그레이드와 비교해 보세요. GLM-5.3과 GLM-5.3-Flash의 이용 경로와 API 비용은 GLM-5.3-Flash 도입 가이드에, 다른 모델로 바꾸는 선택지는 GLM-5.3 vs DeepSeek V4 Pro: 코딩과 AI 에이전트에는 무엇을 고를까에 있습니다.

Z.ai 외의 종량제 경로로는 laozhang.ai도 있습니다. 2026년 10월 22일 기준 glm-5.2를 100만 토큰당 입력 $1.142, 출력 $3.997에 제공하고, Claude Code에서는 ANTHROPIC_BASE_URL을 https://api.laozhang.ai로 두고 모델을 glm-5.2로 지정합니다(설정 안내). 다만 GLM-5.3이 아니라 한 세대 전 모델이고, Z.ai 플랜 한도와는 무관한 별도 과금·별도 한도입니다. 플랜의 429를 해결하는 방법이 아니라, 재설정을 기다리는 동안 다른 모델로 작업을 이어 가는 선택지입니다.

GLM Coding Plan 429에 관한 자주 묻는 질문

5시간 한도는 정확히 언제 풀리나요?

정해진 시각에 한꺼번에 풀리지 않습니다. 쓴 크레딧이 사용 시점으로부터 5시간 뒤에 차례로 돌아옵니다. 다음 회복 시점은 1308 메시지의 next_flush_time에 찍히고, 진행률은 콘솔의 Subscription 페이지에서 볼 수 있습니다. 주간 한도는 구독 시점부터 7일마다 재설정됩니다.

한도가 남았는데 왜 GLM Coding Plan에서 429가 뜨나요?

사용량 한도 말고도 429를 내는 원인이 여럿이기 때문입니다. 1302면 동시 요청이 많은 것이고, 1113이면 키 종류나 Base URL 때문에 요청이 잔액 과금으로 가고 있으며, 1305면 과부하나 요청 내용 문제입니다. 응답 본문의 코드로 구분하세요.

Claude Code 터미널은 동시에 몇 개까지 돌려도 되나요?

Z.ai는 숫자를 공개하지 않습니다. 공식 권장은 Lite 1개 프로젝트, Pro 1~2개, Max 2개 이상이고, 비혼잡 시간에는 동시 실행 한도가 올라갑니다. 1302가 나오면 세션과 서브에이전트 수를 그 범위로 줄이세요.

한도를 다 쓰면 계정 잔액에서 자동으로 빠지나요?

지원 도구에서 플랜 키로 쓰는 한 빠지지 않습니다. 한도가 바닥나면 다음 회복까지 멈춥니다. 반대로 플랜이 남아 있는데 잔액이 줄고 있다면 Standard 키를 쓰고 있거나, Compatible 키로 /api/paas/v4를 부르고 있는 것입니다.

NVIDIA에서 쓰는 GLM의 429도 같은 문제인가요?

아닙니다. build.nvidia.com 같은 NVIDIA 호스팅 GLM 엔드포인트는 자체 요청 제한을 두는 별개 제품입니다. 그쪽 429는 Z.ai 플랜 한도나 위 코드표와 관계가 없습니다.

내용에 오류가 있거나 글에서 다루지 않은 문제를 만났다면 글 주소와 상황을 hi@laozhang.ai로 보내 주세요. 확인 후 글을 수정합니다.