ZCode: GLM Coding Plan 대신 사용하는 저렴한 GLM 추론

2026년 6월, Z.ai는 자신들을 «GLM-5.2의 공식 하네스(Official Harness)»라고 명명한 데스크톱 에이전트 개발 환경인 ZCode 3.0을 출시했습니다. 자체 에이전트 코어, /goal 명령을 통한 자율 과제 실행, 멀티 에이전트 모드, Telegram을 통한 원격 세션 제어 등으로 큰 주목을 받았습니다. 그러나 리뷰 열풍과 함께 초기 GLM Coding Plan 구독자들로부터 의문이 제기되었습니다. 할당량 계산 기준이 5시간 간격의 «프롬프트»이며, 피크 타임에는 소비량이 3배로 늘어나고, 하위 요금제에서는 단일 병렬 요청만 가능한 데다, Hacker News에서는 작업량이 많은 날 이후 갑작스러운 차단에 대한 불만이 쏟아지고 있습니다.

좋은 소식은 ZCode가 custom provider를 공식 지원한다는 점입니다. 여기에 OpenAI 또는 Anthropic 호환 API를 연결하면 구독 할당량이 아닌 실제 토큰 사용량에 대해서만 비용을 지불할 수 있습니다. 이 가이드에서는 ZCode란 무엇이며 GLM Coding Plan이 어떻게 작동하는지 분석하고, 단계별로 ZCode를 JoinGonka Gateway(GLM-5.2를 지원하는 탈중앙화 Gonka 네트워크 게이트웨이)에 설정하는 방법을 안내합니다. 결과적으로 동일한 도구와 동일한 open-weight 모델을 사용하면서도, 비용은 중앙 집중식 API보다 수백 배 저렴해집니다.

ZCode란 무엇인가: Z.ai의 에이전트 개발 환경

ZCode는 단순한 «채팅 사이드바가 있는 에디터»가 아니라, 텍스트 에디터가 아닌 자율형 AI 에이전트를 중심으로 구축된 ADE입니다. 목표를 입력하면 에이전트가 계획을 세우고, 파일을 수정하고, 테스트를 실행하며 결과가 나올 때까지 반복 작업합니다. macOS와 Windows용 데스크톱 앱으로 작동하며(Linux 버전은 베타 상태), 다음은 주요 기능입니다.

ZCode Agent — GLM-5.2와 깊게 통합된 독자적인 에이전트 코어이며, 다른 제3자 에이전트(Claude Code, Codex, Gemini CLI 등)를 추가로 연결 가능합니다.
Goal 모드 (/goal) — 장시간 자율 과제: 계획 → 실행 → 단계별 검증.
멀티 에이전트 — 프로젝트에서 여러 에이전트가 병렬로 작동.
원격 제어 — Telegram, WeChat, Feishu를 통한 세션 시작 및 제어: 당신의 머신에서 에이전트가 작업하고 사용자는 스마트폰으로 질문에 답변할 수 있습니다.

클라이언트 자체는 무료이며, 신규 사용자에게는 GLM-5.2를 체험할 수 있도록 일일 토큰 할당량을 제공합니다. 그 이후에는 GLM Coding Plan 구독 또는 자체 API 키 사용으로 나뉩니다. 제품의 가장 논쟁적인 부분인 구독 체계에 대해 상세히 알아둘 필요가 있습니다.

GLM Coding Plan: 가격, 제한 및 할당량

GLM Coding Plan은 ZCode 및 여러 서드파티 도구에서 GLM 모델에 접근할 수 있게 해주는 Z.ai의 구독 서비스입니다. 게시 시점(2026년 7월)의 기본 요금제는 다음과 같으며, 가격 및 프로모션은 변경될 수 있으니 z.ai/subscribe 페이지를 확인하세요:

요금제	가격 ($/월)	할당량	병렬 요청수
Lite	$18 (프로모션 시 ~$12.6부터)	5시간 주기 «프롬프트» + 주간 제한	1
Pro	$72	Lite 대비 4배	1
Max	$160	Lite 대비 16배	최대 30

구독자들이 토로하는 불만사항(Hacker News 및 GitHub 스레드):

피크 멀티플라이어: 피크 시간대(14:00—18:00 UTC+8 — 아시아 저녁, 유럽 오전~낮)에는 요청당 할당량 소비가 3배, 그 외 시간대는 2배가 적용됩니다. 베이징 표준시를 기준으로 할당량을 관리해야 합니다.
토큰이 아닌 «프롬프트» 기준 할당량: 남아있는 정확한 토큰 양을 알기 어렵습니다. 스레드에서는 «GLM으로 약 17M 토큰을 사용하고 4일간 차단당했다»는 등의 사례가 공유됩니다.
Lite/Pro 단계의 병렬 요청 제한: 에이전트 환경에서는 매우 불편하며, ZCode 자체 멀티 에이전트 모드나 병렬 하위 에이전트 작업이 큐에서 밀리게 됩니다.
GLM-5.2의 높은 소모율: 플래그십 모델은 자체 멀티플라이어에 의해 할당량을 훨씬 더 빨리 소진합니다.

결론은 간단합니다. 일반적인 1인 개발에는 구독 모델이 무리 없이 작동합니다. 하지만 병렬 작업, 장시간 자동 세션, 야간 실행 등 «에이전트 모드»를 활발히 사용할수록 할당량 모델은 복불복이 됩니다. 이에 대한 대안은 실제 사용량만큼만 지불하는 것입니다. 시간 창(window), 멀티플라이어, 대기열 없이 에이전트가 소비한 만큼만 지불합니다. 이는 ZCode에 내장된 custom provider 메커니즘을 통해 실현 가능하며, 5분이면 설정이 끝납니다.

ZCode에서의 BYOK: 자체 API 키와 custom provider

ZCode는 BYOK을 공식적으로 지원합니다. 문서를 통해 "OpenAI 또는 Anthropic 프로토콜과 호환되는 서비스"(공용 API, 기업 채널, 심지어 self-hosted 설치본까지)를 추가하는 것이 명시적으로 허용됩니다. 설정 방법은 세 가지입니다:

시작 화면의 Connect 버튼 → "Set Your API Key";
모델 선택기의 Manage Models;
톱니바퀴 아이콘 → Settings → Model Settings → Add Provider.

공급자에게 OpenAI Base URL 및/또는 Anthropic Base URL과 API Key를 지정하면 ZCode가 이용 가능한 모델 목록을 자동으로 불러옵니다.

가장 자주 발생하는 세 가지 실수:

Z.ai의 Endpoint는 서로 다릅니다. Coding Plan 구독은 오직 코딩 전용 엔드포인트 https://api.z.ai/api/coding/paas/v4 를 통해서만 작동합니다. 구독 키로 범용 /api/paas/v4 에 접근하면 오류가 발생하며, 이것이 "플랜을 결제했는데 왜 401/429 오류가 발생하는가"에 대한 고전적인 원인입니다.
"Claude Code에서 작동함 ≠ ZCode에서 작동함". Claude Code를 구성할 때 사용하는 ANTHROPIC_BASE_URL 같은 환경 변수는 ZCode에서 읽지 않습니다. ZCode는 자체적인 공급자 설정 저장소를 가지고 있으므로, 반드시 Settings를 통해 구성하십시오.
"모델이 선택기에 보임 ≠ 키에 할당량이 있음". 모델 목록은 공급자의 API에서 직접 가져오지만, 실제 사용 가능 여부는 해당 키의 잔액과 한도에 따라 달라집니다.

이제 실전으로 들어가서, ZCode와 JoinGonka 게이트웨이를 연결하여 토큰 기반으로 GLM 스택을 사용해 보겠습니다.

ZCode에서 JoinGonka Gateway 설정하기: GLM 토큰 과금

JoinGonka Gateway는 두 가지 기본 프로토콜(OpenAI 호환 /v1/chat/completions 및 Anthropic Messages /v1/messages)을 지원하는 분산형 Gonka 네트워크의 게이트웨이입니다. ZCode의 경우, 프록시 계층 없이 맞춤형 공급자 필드 양쪽에 직접 연결됩니다. 경제 모델은 pay-per-token(토큰 종량제) 방식이며, 5시간 시간제한, 피크 시 3배 배수, 동시 요청 제한 같은 것은 없습니다. 소비량은 대시보드에서 실시간으로 확인 가능하며 게이트웨이는 프롬프트 내용을 저장하지 않습니다.

단계별 안내:

단계	작업
1. 키	gate.joingonka.ai/register 에 가입하고(신규 계정은 10M 무료 토큰 증정), Keys 섹션에서 API 키를 만드십시오. 키 활용 및 첫 번째 요청에 관한 자세한 내용은 API Quick Start 를 참고하세요.
2. 공급자	ZCode → Settings → Model Settings → Add Provider (또는 시작 화면의 Connect → "Set Your API Key").
3. OpenAI Base URL	`https://gate.joingonka.ai/v1`
4. Anthropic Base URL	`https://gate.joingonka.ai` (클라이언트가 자동으로 `/v1/messages` 엔드포인트를 추가함)
5. API Key	`jg-…` 형식의 본인 키
6. 모델	불러온 목록에서 선택하십시오: 현재는 `moonshotai/Kimi-K2.6` 및 `MiniMaxAI/MiniMax-M2.7` 이며, GLM-5.2가 활성화되면 `zai-org/GLM-5.2-FP8` 이 목록에 나타납니다.

확인: 에이전트에게 질문을 던져보십시오. 답변이 오면 성공입니다. 401 오류가 발생하면 키를 확인하고, 402 오류가 발생하면 계정 잔액을 확인하십시오.

가격 비교: Coding Plan, Z.ai API, OpenRouter, Gonka

각 채널별 GLM 추론 비용(1M 토큰당 가격. 경쟁사 가격은 2026년 7월 기준으로 고정되어 있으며, JoinGonka의 가격은 게이트웨이 API에서 실시간으로 대입됩니다):

채널	입력 ($/1M)	출력 ($/1M)	과금 모델
Z.ai API (GLM-5.2)	$1.40 (캐싱 입력 시 — $0.26)	$4.40	토큰 과금
GLM Coding Plan	$18—160/월		구독: "프롬프트" 할당량, 피크 요금 3배, 동시 요청 제한 있음
OpenRouter (z-ai/glm-5.2)	$0.93	$3.00	토큰 과금; GLM-5.2 무료 옵션 없음
JoinGonka Gateway	$0.003	$0.009	토큰 과금, Gonka 네트워크

2~3자릿수의 가격 차이는 마케팅용 수치가 아니라 경제 구조의 차이입니다. 데이터 센터의 마진이 아닌 분산 네트워크 참여자들이 실제 계산을 수행하고 그 대가를 받는 구조입니다. 이 작동 원리와 적용 사례에 대한 자세한 내용은 가장 저렴한 AI API에 관한 게시글을 참고하십시오.

GLM-5.2에 대한 주의사항: 해당 네트워크에서 정확한 모델 가격을 책정하는 시점에 가격이 설정됩니다(위 표는 현재 네트워크의 실시간 가격입니다). 페이지의 숫자는 자동으로 업데이트되므로 직접 다시 계산할 필요가 없습니다.

Gonka 네트워크 내 GLM-5.2: 현황 및 자주 묻는 질문

모델 zai-org/GLM-5.2-FP8 가 Gonka 네트워크 on-chain 레지스트리에 추가되었습니다. 설정은 최대 400K 토큰의 컨텍스트 윈도우를 지원하며, 이 모델은 매우 거대한 모델에 속합니다(레플리카당 1TB 이상의 VRAM 필요). 현재 배포가 진행 중이며 네트워크 노드들이 가중치를 로드하고 있습니다. 검증이 완료되면 게이트웨이의 모델 목록에 자동으로 나타나며, base URL 과 키는 변경할 필요 없이 ZCode 에서 선택기만 선택하면 즉시 사용 가능합니다.

모델 정보: MIT 라이선스의 오픈 웨이트 모델, MoE 아키텍처, 약 750B 파라미터(토큰당 약 40B 활성화), 최대 1M 토큰의 네이티브 윈도우 지원. Z.ai 데이터에 따르면 SWE-bench Pro 에서 62.1을 기록하여 GPT-5.5를 능가하며, FrontierSWE 에서는 Claude Opus 4.8에 약 1% 차이로 뒤처져 open-weight 모델 중 코딩 성능 최상위권입니다.

자주 묻는 질문:

모델 활성화 직후에 429 오류가 발생하는 이유는 무엇인가요? — 배포 단계이므로 일부 노드가 아직 가중치를 로드 중입니다. 잠시 후 재시도하면 로드 밸런서가 활성 상태의 노드로 연결해 줍니다.
오늘 바로 사용 가능한 모델은 무엇인가요? — Kimi K2.6 과 MiniMax M2.7 둘 다 ZCode 에서 동일한 custom provider 를 통해 작동하며, 이 가이드의 설정은 지금 바로 적용 가능합니다.
개인정보 보호는 어떻게 관리되나요? — 게이트웨이는 프롬프트나 응답 내용을 저장하지 않으며, 통계에는 소비량 집계 데이터만 포함됩니다.
언제 Coding Plan 이 유리한가요? — 혼자 작업하고 Lite 할당량을 초과하지 않으며 병렬 에이전트를 실행하지 않는 경우 고정 비용의 구독이 편리하고 예측 가능합니다. 본인의 사용 패턴에 맞춰 계산해 보세요. 에이전트를 활발하게 사용한다면 네트워크를 통한 토큰 기반 결제가 훨씬 저렴할 수 있지만, 하루에 몇 번 가벼운 코드 수정만 한다면 체감 차이는 적을 수 있습니다.
다른 도구에서도 사용할 수 있나요? — 네. 동일한 endpoint 가 Claude Code, Cursor, Cline 및 모든 OpenAI/Anthropic 호환 클라이언트에서 작동합니다.

ZCode 3.0은 뛰어난 에이전트형 IDE이지만, 기본 GLM Coding Plan 구독은 5시간 윈도우당 프롬프트 제한, 피크 시간대 ×3 배율, 하위 플랜의 병렬 요청 제한 등 할당량 기반입니다. 에이전트 부하가 높을수록 비용이 늘어나고 예측이 어려워집니다. 공식 BYOK가 해결책입니다. JoinGonka Gateway를 custom provider로 연결하면 Gonka 탈중앙화 네트워크의 가격으로 사용한 토큰만큼만 지불하면 되며, 중앙 집중형 API보다 수백 배 저렴합니다. GLM-5.2는 이미 네트워크 레지스트리에 등록되어 자동으로 모델 선택기에 나타나며, Kimi K2.6과 MiniMax M2.7은 오늘 바로 사용할 수 있습니다. 10M 무료 토큰으로 시작해 보세요.

← 2026년 AI 에이전트를 위한 가장 저렴한 API

더 자세히 알고 싶으세요?

다른 섹션을 탐색하거나 지금 GNK를 얻기 시작하세요.

10M 무료 토큰 받기 →