일하는 ai

GLM-5.1 전환 가이드: Claude Code, OpenClaw, Cline 설정법

6 min read

-

GLM Coding Plan 사용자를 위한 실전 전환 가이드. Claude Code, OpenClaw, Cline에서 5.1 버전으로 설정하는 방법을 상세히 안내합니다.

📝 핵심 내용 한눈에 보기

  • Claude Code: ~/.claude/settings.json의 환경변수 3개만 변경 → 2분
  • OpenClaw: openclaw.json에 모델 정의 + 기본 모델 변경 → Gateway 재시작 필요
  • Cline: OpenAI 호환 방식으로 API 설정 → 별도 앱 재설정 필요
  • 사전 체크: API 권한, GLM Coding Plan 사용 가능 여부 확인

🔍 문제: 왜 GLM-5.1로 전환해야 할까?

GLM-5.1은 그냥 새 버전이 아니라 실질적인 성능 업그레이드입니다:

  • 추론 능력 향상: 복잡한 코드 분석, 아키텍처 설계 시 오류율 ↓
  • 안정성 개선: 긴 문맥(200K 토큰)에서 중간에 끊기는 현상 ↓
  • 코딩 특화: GLM 계열 중 가장 코딩 성능이 우수 (Z.AI 공식 벤치마크)

단, 모든 도구에서 바로 지원되는 건 아니라 수동 설정이 필요합니다. 이 가이드를 따라 하면 3분 안에 전환할 수 있습니다.

🚀 1. Claude Code 전환 (가장 쉬움)

사전 체크

  1. GLM Coding Plan 구독 중인지 확인 (Max, Pro, Lite 모두 가능)
  2. claude 명령어가 동작하는지 터미널에서 테스트

설정 변경

Windows: C:\Users\사용자\.claude\settings.json macOS: 터미널에 vim ~/.claude/settings.json 또는 Finder → 이동 → 폴더 입력

{
  "env": {
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5.1",    // ← 바뀜
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5.1"       // ← 바뀜
  }
}

확인 방법

새 터미널 열고 claude 실행 → /status 입력 → 아래 메시지가 뜨면 성공:

Current model: zai/glm-5.1
Context window: 200K tokens

⚙️ 2. OpenClaw 전환 (필요하면 설정 추가)

문제 진단

만약 OpenClaw에서 Z.AI 선택해도 GLM-5.1이 보이지 않으면, 모델 선언이 누락된 것입니다.

Step 1: 모델 정의 추가

~/.openclaw/openclaw.json 파일의 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        // ← 신규 추가
    }
  ]
}

Step 2: 기본 모델 변경

agents.defaults.model.primary 항목 변경:

// 변경 전
"primary": "zai/glm-5"
 
// 변경 후  
"primary": "zai/glm-5.1"

Step 3: 모델 목록에 추가

agents.defaults.models 항목에 추가:

"zai/glm-5.1": {}  // ← 신규 추가

Step 4: Gateway 재시작

openclaw gateway restart

확인 방법

openclaw tui 실행 → 우측 하단 모델 표시 확인:

Model: zai/glm-5.1
Context: 204K
Status: Ready

🔌 3. Cline 전환 (OpenAI 호환 방식)

설정 절차

  1. API Provider: “OpenAI Compatible” 선택
  2. Base URL: https://api.z.ai/api/coding/paas/v4 입력
  3. API Key: Z.AI 계정에서 발급받은 키 입력
  4. Model: “Custom Model” 선택 → glm-5.1 입력
  5. 기타 설정:
    • ✅ Support Images 체크 해제
    • Context Window Size: 200000
    • Temperature: 0.1~0.3 (코딩에 적합한 값)

전체 설정 예시

{
  "provider": "openai-compatible",
  "baseUrl": "https://api.z.ai/api/coding/paas/v4",
  "apiKey": "your-zai-api-key",
  "model": "glm-5.1",
  "contextSize": 200000,
  "temperature": 0.2
}

🆘 전환 실패 시 해결 팁

문제 1: “GLM-5.1 is not available” 오류

원인: 모델이 존재하지 않는다고 뜨는 경우

해결:

  1. Z.AI 계정에서 GLM Coding Plan 구독 중인지 확인
  2. 최신 버전의 Claude Code/OpenClaw 사용 중인지 확인
  3. API가 일시적으로 다운되었을 수 있음 → 30분 후 재시도

문제 2: OpenClaw에서 새로고침 후에도 안 보임

원인: Gateway 재시작이 필요

해결:

# 완전히 재시작 (강제)
pkill -f openclaw
openclaw start

문제 3: Claude Code에서 변경 안 적용

원인: 환경변수 캐싱

해결:

# macOS/Linux
source ~/.zshrc  # 또는 ~/.bashrc
# 또는 새 터미널 완전히 닫고 다시 열기

📊 비교 표

도구설정 방식재시작 필요예상 소요 시간
Claude Codesettings.json 변경❌1분
OpenClawopenclaw.json + 재시작✅3분
ClineGUI 설정 변경✅2분

🔗 관련 자료

작성일: 2026-03-28 원문: https://docs.z.ai/devpack/using5.1 최신 정보: Z.AI 공식 문서 기준

그래프 뷰

백링크