ZCode를 쓸지 고민할 때 버전 번호나 월 요금부터 비교하면 판단이 흐려진다. ZCode는 코딩 에이전트를 실행하는 데스크톱 앱이고, GLM은 그 안에서 고르는 모델이며, Coding Plan은 사용량을 제공하는 구독이다. 셋을 분리한 뒤 “새 작업 환경이 필요한가, 기존 도구에 모델만 연결하면 되는가”부터 정해야 중복 결제를 피할 수 있다.
30초 선택표부터 확인한다
| 현재 필요 | 먼저 시험할 경로 | 중단 기준 |
|---|---|---|
| 파일·터미널·브라우저를 한 앱에서 다루고 싶다 | ZCode 무료 설치 후 샘플 폴더 | 현재 도구보다 작업 전환이 줄지 않음 |
| Claude Code 등 기존 도구를 유지하고 싶다 | Coding Plan 연동 가능 여부 확인 | 도구가 공식 지원 목록에 없거나 설정이 불안정함 |
| 일반 API 호출이 목적이다 | Coding Plan이 아닌 일반 API 요금 확인 | 코딩 전용 endpoint만으로 요구를 충족하지 못함 |
| 고객 코드·민감 데이터가 있다 | 사내 보안 기준과 처리 정책 검토 | 외부 전송·기록을 허용할 수 없음 |
ZCode가 꼭 필요한 것은 첫 번째 경우다. 모델만 필요하다면 익숙한 편집기와 에이전트를 유지하는 편이 전환 비용이 낮을 수 있다. 반대로 여러 도구를 오가느라 컨텍스트가 자주 끊긴다면 앱 통합의 가치가 생긴다.
최신 설치본은 공식 페이지에서만 확인한다
2026년 8월 31일 확인 기준 공식 설치 문서는 3.10.1을 최신으로 표시한다. macOS는 Apple Silicon·Intel, Windows는 x64·ARM64, Linux는 x64·ARM64와 AppImage·DEB·RPM 경로를 제공한다. 글에 적힌 과거 버전 번호를 검색해 설치하지 말고 운영체제에 맞는 현재 파일을 받는다.
첫 실행에서는 고객 저장소가 아닌 빈 샘플 폴더를 연다. “파일 목록을 읽고 변경하지 말라”고 요청한 뒤 응답, 모델 연결, 승인 화면을 차례로 확인한다. 이 세 단계가 정상일 때만 실제 저장소로 이동한다. 네트워크 오류가 나면 재설치보다 Settings → General의 프록시 설정을 먼저 본다. ZCode는 해당 칸이 비어 있으면 시스템 프록시를 자동으로 따르지 않는다고 안내한다.
로그인 연결과 API 키 연결을 섞지 않는다
공식 모델 연결 문서에 따르면 Z.ai 계정에 Coding Plan이 있으면 계정 로그인만으로 플랜 quota를 불러온다. 이 경로에서는 API 키나 주소를 손으로 입력하지 않는다. 직접 키를 쓸 때만 코딩 전용 OpenAI 호환 주소를 사용한다.
https://api.z.ai/api/coding/paas/v4일반 API 주소인 /api/paas/v4와 코딩 전용 주소는 서로 바꿔 쓸 수 없다. 또한 현재 플랜은 크레딧과 주간 한도를 함께 사용한다. 공식 구독 페이지는 월간 정가를 Lite 18달러, Pro 72달러, Max 160달러로 표시하지만, 할인·quota·지원 모델은 바뀔 수 있다. 결제 화면에서 갱신 주기와 현재 한도를 다시 확인하고 한 달만 시험한다.
실제 저장소는 권한·데이터 경계를 만든 뒤 연다
ZCode Agent 문서는 사용자 전역 ~/.zcode/AGENTS.md와 현재 작업공간의 AGENTS.md를 읽는다. 첫 규칙에는 수정 허용 경로, 금지 명령, 테스트 명령, 완료 조건만 짧게 적는다. 처음부터 자동 실행 범위를 넓히지 말고 읽기 → 한 파일 수정 → 테스트 순서로 권한을 올린다.
개인정보 처리방침은 대화로 제출한 텍스트·파일·코드와 생성 내용을 수집·기록한다고 밝힌다. 학습·최적화 참여는 기본 꺼짐이지만 서비스 제공을 위한 처리와 대화 기록까지 사라지는 뜻은 아니다. 비밀키는 저장소 밖 환경변수로 옮기고 고객 데이터는 샘플에서 제외한다.
최종 판단은 간단하다. 10분 샘플 작업에서 전환 횟수가 줄고, 권한 경계와 데이터 정책을 수용할 수 있으며, 예상 사용량이 플랜 한도 안에 들어올 때만 도입한다. 셋 중 하나라도 확인되지 않으면 결제보다 현재 도구 유지가 안전하다.