ZCode 출시: GLM-5.2 설치 방법과 기본 구성 가이드

읽는데 5분 소요

Z.ai ZCode 설치와 GLM-5.2 간단 구성

지푸 AI가 GLM-5.2를 전면에 세운 AI 코딩 플랫폼 ZCode를 공개했습니다. 실제 화면 기준으로 설치, 로그인, 모델 선택, API 키 구성을 빠르게 정리합니다.

설치 흐름 모델 구성 FAQ

▲ ZCode 메인 화면. 왼쪽은 작업/검색/스킬, 중앙은 GLM-5.2 에이전트 입력창으로 구성된다. 자료: ZCode 공식 페이지

핵심 요약

무엇인가ZCode는 GLM-5.2를 실제 개발 흐름에 붙이는 데스크톱형 Agentic Development Environment입니다.

왜 주목하나공식 문서는 긴 컨텍스트, 작업 계획, 파일/터미널/Git 상태 유지, 승인 기반 실행을 강조합니다.

어떻게 시작하나앱 설치 후 Z.ai 계정, BigModel 계정, 또는 API 키 중 하나로 모델 공급자를 연결합니다.

AI타임스는 2026년 7월 3일 보도에서 ZCode가 클로드 코드·코덱스류 AI 코딩 도구와 경쟁하는 제품이라고 소개했습니다. 공식 문서 기준으로는 GLM-5.2와 GLM-5-Turbo를 중심으로 쓰며, 외부 서비스는 Anthropic/OpenAI 호환 프로토콜이나 API 키 방식으로 붙이는 구조입니다.

설치 흐름

공식 설치 문서 기준 지원 플랫폼은 macOS Apple Silicon/Intel, Windows, Linux 베타입니다. 2026년 7월 3일 확인한 다운로드 페이지에는 macOS와 Windows 설치 파일, Linux용 .deb 및 .AppImage 항목이 올라와 있습니다.

1. zcode.z.ai/en 접속
2. 운영체제에 맞는 설치 파일 다운로드
3. macOS: DMG 열기 → ZCode.app을 Applications로 이동
4. Windows: EXE 실행 → 설치 마법사 진행
5. 첫 실행 후 Z.ai / BigModel / API Key 중 하나 선택

단계	확인 포인트	내 추천
다운로드	macOS Apple Silicon/Intel, Windows 64-bit/ARM64, Linux 베타 중 선택	본인 칩셋에 맞는 파일을 고르고, 회사 장비라면 보안 정책상 실행 허용 여부를 먼저 확인
첫 로그인	Z.ai, BigModel, API Key 중 하나 선택	한국 사용자라면 글로벌 계정인 Z.ai로 먼저 연결하고, 중국 BigModel 계정은 별도 권한이 있을 때 선택
워크스페이스	프로젝트 폴더를 열고 파일 접근 범위를 확인	처음에는 테스트용 저장소에서 권한 흐름과 변경 리뷰 화면을 익히는 편이 안전

▲ 첫 실행 화면에서는 Z.ai, BigModel, API key 중 하나를 고른다. 해외 사용자는 보통 Z.ai 계정 연결이 가장 단순하다. 자료: Connect Models 문서

▲ Z.ai 로그인은 Google, Email, GitHub, Skip for now 흐름을 제공한다. 계정 연결 후 모델 권한과 사용량이 앱에 반영된다. 자료: Z.ai

모델 구성 2가지

가장 쉬운 방식은 Coding Plan 연결입니다. API 키가 이미 있다면 Provider 설정에서 API Key 모드로 바꿔 Base URL과 키를 넣으면 됩니다.

▲ 입력창의 모델 메뉴에서 GLM-5.2와 GLM-5-Turbo를 전환할 수 있다. 긴 작업은 GLM-5.2, 가벼운 반복은 Turbo가 어울린다. 자료: ZCode Welcome 문서

▲ 추론 강도는 No thinking, High, Max로 조절한다. 처음에는 Max로 시작하고 지연 시간이 부담될 때 High를 시험해볼 만하다. 자료: GLM-5.2 개발자 문서

구성 방식	추천 상황	확인할 값
Coding Plan	처음 ZCode를 써보거나 구독/무료 체험 쿼터를 바로 쓰고 싶을 때	Z.ai 로그인, Enable 상태, 모델 목록, 오늘의 잔여량
API Key	팀 계정, 별도 과금 채널, OpenAI/Anthropic 호환 라우팅을 쓰고 싶을 때	Connection mode, Base URL, API key, 모델명

설정에서 봐야 할 것

▲ Coding Plan 모드에서는 GLM-5.2와 GLM-5-Turbo 잔여량이 카드 형태로 보인다. 신규 사용자는 무료 체험 쿼터 확인이 먼저다. 자료: Connect Models 문서

▲ API Key 모드에서는 Base URL과 키를 직접 넣는다. Coding Plan용 엔드포인트와 일반 API 엔드포인트가 다르므로 문서값을 그대로 확인해야 한다. 자료: Connect Models 문서

# Z.ai Coding Plan용 OpenAI 호환 엔드포인트
https://api.z.ai/api/coding/paas/v4

# Z.ai Anthropic 호환 엔드포인트
https://api.z.ai/api/anthropic

# Z.ai 일반 OpenAI 호환 엔드포인트
https://api.z.ai/api/paas/v4

공식 문서가 특히 강조하는 부분은 Coding Plan 전용 엔드포인트입니다. 코딩 플랜을 API 키로 쓸 때는 일반 /api/paas/v4가 아니라 /api/coding/paas/v4 계열을 써야 쿼터와 용도가 맞습니다.

처음 켜고 바로 맞출 설정

처음부터 큰 저장소를 맡기기보다는 “작게 열고, 승인 정책을 확인하고, 모델 반응을 본 뒤 범위를 넓히는” 순서가 좋습니다. ZCode는 코딩 에이전트형 도구라서 채팅 답변만 보는 앱보다 파일 접근, 명령 실행, 변경 검토의 영향이 큽니다.

설정	추천값	이유
Permission	Ask before changes	초반에는 파일 수정과 명령 실행을 직접 확인해야 예상 밖 변경을 줄일 수 있다.
Model	GLM-5.2	설치 직후 성능을 체감하려면 긴 문맥과 계획 능력이 필요한 작업을 주는 편이 좋다.
Thinking	Max	리팩터링, 테스트 수정, 원인 분석처럼 단계가 긴 요청은 Max로 시작하는 것이 안정적이다.
Preview	필요할 때 켜기	웹 프로젝트라면 결과 화면을 같이 보며 수정 루프를 짧게 만들 수 있다.

첫 요청은 추상적인 “이 프로젝트 개선해줘”보다 경계가 있는 문장이 좋습니다. 예를 들어 README를 읽고 실행 방법을 확인한 뒤, 테스트가 실패하면 원인만 요약해줘처럼 읽기 중심 요청으로 시작하면 도구 호출 방식과 승인 화면을 부담 없이 확인할 수 있습니다. 그 다음 작은 버그 1개를 수정하고 변경 파일을 설명해줘처럼 수정 범위를 1개 이슈로 좁히면 ZCode가 계획, 편집, 검증, 리뷰를 어떻게 이어가는지 보기 쉽습니다.

내가 본 포인트

다운로드

계정 연결

모델 선택

추론 강도 조절

작업 실행

ZCode의 첫인상은 “모델 데모”보다 “작업 환경”에 가깝습니다. 작업 목록, 프로젝트, 스킬, MCP, 코드 미리보기, 마이그레이션까지 한 화면 계열에 모아 두었기 때문입니다. GLM-5.2의 1M 컨텍스트가 강점이라면, ZCode는 그 긴 문맥을 파일·터미널·Git 상태와 연결해 실제 개발 루프로 끌고 오는 껍데기 역할을 합니다.

▲ Skills 메뉴에서는 플러그인 스킬과 외부 에이전트에서 가져온 스킬을 관리한다. Claude/Codex류 사용자에게 익숙한 확장 포인트다. 자료: ZCode Skill 문서

▲ 마이그레이션 가이드는 세션, 스킬, MCP 서버, 명령, AGENTS.md를 가져오는 흐름을 제공한다. 기존 에이전트 사용자 전환을 의식한 부분이다. 자료: ZCode 공식 문서

이 마이그레이션 화면은 꽤 상징적입니다. ZCode가 단순히 새 채팅창을 하나 더 만든 것이 아니라, 기존 에이전트 사용자들이 쌓아둔 스킬, MCP 서버, 프로젝트 규칙을 가져와 “바로 작업 가능한 환경”으로 옮기려는 의도가 보입니다. 다만 자동 가져오기는 편한 만큼 충돌 가능성도 있습니다. 전역 설정과 프로젝트 설정 중 어디에 넣을지, 심볼릭 링크 방식이 괜찮은지, 기존 AGENTS.md가 덮어써지지 않는지 정도는 한 번 확인하는 편이 좋습니다.

주의할 점

체크	왜 중요한가
요금/쿼터	공식 페이지에는 Lite 월 $16.2, Pro 월 $64.8, Max 월 $144가 표시되지만 가격은 바뀔 수 있다.
승인 정책	파일 수정과 시스템 명령은 승인 절차를 거친다. 자동 실행 범위를 먼저 확인하자.
API 엔드포인트	Coding Plan과 일반 API의 Base URL이 다르다. 잘못 넣으면 모델 호출이나 쿼터 계산이 어긋날 수 있다.
모델 선택	GLM-5.2는 긴 작업, GLM-5-Turbo는 가벼운 반복에 맞춰 쓰는 식으로 시작하면 무난하다.

특히 회사 저장소에서 바로 쓰려면 더 보수적으로 접근하는 것이 좋습니다. 첫날에는 읽기 요청, 테스트 실행, 작은 문서 수정 정도로 제한하고, 파일 삭제나 의존성 업데이트처럼 되돌리기 어려운 작업은 변경 계획을 먼저 받아보세요. ZCode가 잘 맞는지는 “답변이 멋진가”보다 “변경 근거를 설명하고 검증 결과를 남기는가”로 판단하는 편이 실전적입니다.

개인적으로는 설치 직후 성능 평가를 큰 과제로 시작하지 않는 편을 권합니다. 작은 저장소에서 모델 선택, 권한 승인, 코드 미리보기, 변경 리뷰까지 한 바퀴 돌려보면 이 도구가 내 작업 습관과 맞는지 훨씬 빨리 보입니다. 익숙해진 뒤에야 실제 업무 저장소로 옮기는 순서가 가장 편합니다. 처음에는 충분히 조심하고 꼭 확인하세요.

FAQ

Q1. ZCode는 무료인가요?+

앱 다운로드 자체는 무료로 안내됩니다. 다만 GLM 모델 사용은 Z.ai/BigModel 계정의 무료 체험, Coding Plan, API 키 권한에 따라 달라집니다.

Q2. macOS에서는 어떻게 설치하나요?+

공식 DMG를 내려받아 열고 ZCode.app을 Applications 폴더로 옮긴 뒤 실행하면 됩니다. Apple Silicon과 Intel 빌드가 따로 제공됩니다.

Q3. GLM-5.2와 GLM-5-Turbo 중 무엇을 고르면 좋나요?+

긴 리팩터링, 다중 파일 변경, 검증까지 이어지는 작업은 GLM-5.2가 어울립니다. 짧은 수정과 빠른 질의는 GLM-5-Turbo로 시작해도 충분합니다.

Q4. API 키만으로도 쓸 수 있나요?+

가능합니다. Settings의 Model settings에서 Z.ai를 선택하고 Connection mode를 API key로 바꾼 뒤 Base URL과 키를 입력하면 됩니다.

Q5. 기존 Claude Code나 Codex 설정을 가져올 수 있나요?+

화면상 마이그레이션 가이드가 세션, 스킬, MCP 서버, 명령, AGENTS.md 항목을 다룹니다. 다만 실제 가져오기 범위는 로컬 설정 구조와 선택한 Import target에 따라 달라집니다.

출처

• AI타임스: 지푸, AI 코딩 플랫폼 Z코드 출시
• ZCode 공식 페이지
• ZCode 설치 문서
• ZCode 모델 연결 문서
• Z.ai GLM-5.2 개발자 문서
• Hugging Face GLM-5.2 모델 카드