Context Vault

Z.ai DevPack - GLM-5.1 모델 사용 가이드

6 min read

Z.ai DevPack - GLM-5.1 모델 사용 가이드

Claude Code 및 OpenClaw에서 GLM-5.1 모델로 전환하고 설정하는 방법

개요

Z.ai의 DevPack을 사용하여 코딩 에이전트(Claude Code, OpenClaw 등)에서 GLM-5.1 모델을 사용하는 방법을 설명합니다.

주요 포인트:

  • GLM-5.1은 GLM-5의 업그레이드 버전
  • 모든 사용자 계정(Max, Pro, Lite)에서 사용 가능
  • Claude Code 및 OpenClaw에서 모델 전환 지원

GLM-5.1 성능 및 사양

항목값
모델 IDglm-5.1
Context Window204,800 토큰
Max Tokens131,072 토큰
Reasoning✅ 지원
입력 타입Text
비용Z.AI 정책에 따름 (일부 플랜 무료)

1. Claude Code에서 모델 전환

기본 설정 (현재 상태)

Claude Code는 기본적으로 다음과 같은 매핑을 가집니다:

ANTHROPIC_DEFAULT_OPUS_MODEL → GLM-4.7
ANTHROPIC_DEFAULT_SONNET_MODEL → GLM-4.7
ANTHROPIC_DEFAULT_HAIKU_MODEL → GLM-4.5-Air

전환 방법

설정 파일 위치

  • Windows: ~/.claude/settings.json
  • macOS: ~/.claude/settings.json (vim 또는 Finder → Go to Folder)

설정 파일 수정

{
  "env": {
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5.1",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5.1"
  }
}

확인 방법

  1. 새 터미널 창에서 claude 실행
  2. /status 명령어 입력
  3. 현재 모델이 GLM-5.1로 표시되는지 확인

2. OpenClaw에서 모델 전환

OpenClaw는 직접 모델 선택이 불가능한 경우 수동 설정이 필요합니다.

단계 1: 설정 파일 업데이트

파일: ~/.openclaw/openclaw.json

1. models.providers.zai.models에 GLM-5.1 추가

기존 models 배열 끝에 다음 객체 추가:

{
  "id": "glm-5.1",
  "name": "GLM-5.1",
  "reasoning": true,
  "input": ["text"],
  "cost": {
    "input": 0,
    "output": 0,
    "cacheRead": 0,
    "cacheWrite": 0
  },
  "contextWindow": 204800,
  "maxTokens": 131072
}

2. 기본 모델 변경

agents.defaults.model.primary를修改:

"primary": "zai/glm-5.1"

3. agents.defaults.models에 등록

"models": {
  "zai/glm-5": {"alias": "GLM"},
  "zai/glm-4.7": {},
  "zai/glm-5.1": {}
}

단계 2: 전체 설정 예시

models.providers.zai.models 전체 예시:

"models": [
  {
    "id": "glm-5",
    "name": "GLM-5",
    "reasoning": true,
    "input": ["text"],
    "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0},
    "contextWindow": 204800,
    "maxTokens": 131072
  },
  {
    "id": "glm-4.7",
    "name": "GLM-4.7",
    "reasoning": true,
    "input": ["text"],
    "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0},
    "contextWindow": 204800,
    "maxTokens": 131072
  },
  {
    "id": "glm-5.1",
    "name": "GLM-5.1",
    "reasoning": true,
    "input": ["text"],
    "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0},
    "contextWindow": 204800,
    "maxTokens": 131072
  }
]

agents.defaults.model 전체 예시:

"model": {
  "primary": "zai/glm-5.1",
  "fallbacks": ["zai/glm-4.7"]
}

agents.defaults.models 전체 예시:

"models": {
  "zai/glm-5": {"alias": "GLM"},
  "zai/glm-4.7": {},
  "zai/glm-5.1": {}
}

단계 3: 재시작 및 확인

# OpenClaw Gateway 재시작
openclaw gateway restart
 
# 또는 GUI/TUI 실행
openclaw tui
 
# GLM-5.1 모델 선택되었는지 확인

3. 다른 도구에서 사용 (Cline 예시)

Cline 같은 VSCode 확장에서도 GLM-5.1 사용 가능.

설정 방법

  1. API Provider: OpenAI Compatible 선택
  2. Base URL: https://api.z.ai/api/coding/paas/v4
  3. API Key: Z.AI API 키 입력
  4. Model: Custom Model 선택 → glm-5.1 (또는 glm-5)
  5. 추가 설정:
    • ☐ Support Images 해제 (이미지 지원 안함)
    • Context Window Size: 200000
    • Temperature 및 기타 파라미터는 작업에 맞게 조정

4. 주의사항 및 팁

이미지 지원

  • GLM-5.1은 현재 이미지 입력을 지원하지 않음
  • Support Images 옵션은 반드시 해제

컨텍스트 윈도우

  • 최대 204,800 토큰
  • 일반적인 코딩 작업에 충분한 크기

모델 선택 전략

사용 caso추천 모델
복잡한 아키텍처 설계, 리팩토링GLM-5.1
일반적인 코드 작성, 버그 수정GLM-5 또는 GLM-4.7
빠른 코드 완성, 간단한 작업GLM-4.5-Air (Haiku)

비용 고려사항

  • Z.AI 플랜별 무료 할당량 확인 필요
  • GLM-5.1 사용량이 많은 경우 요금제 업그레이드 검토
  • 모델별 비용 차이 확인 (Z.AI 가격 페이지 참고)

5. 트러블슈팅

모델 전환 안됨

  • 설정 파일 JSON 문법 오류 확인 (validators 사용)
  • OpenClaw 재시작 확인 (openclaw gateway restart)
  • API 키 권한 확인 (Z.AI 콘솔에서 glm-5.1 접근 권한)

“Model not found” 에러

  • 모델 ID 정확히 입력: glm-5.1 (대소문자 구분)
  • Z.AI 계정에 GLM-5.1 접근 권한이 있는지 확인

낮은 성능

  • 컨텍스트 윈도우 제한 확인 (너무 많은 파일 동시 열기)
  • reasoning: true 설정 확인
  • fallback 모델이 올바른지 확인

6. 참고사항

  • 이 문서는 Z.ai DevPack 공식 문서를 기반으로 합니다
  • 최신 정보는 Z.AI 공식 문서 참고
  • 모델 성능 및 가격 정책은 변경될 수 있음

관련 노트

그래프 뷰