Claude Code MAX 200을 사용하고 있는데 일주일 한도를 다 쓰고야맘. 꼭 2,3일전에 다 소모함.

그런 이유로 징징 거렸더니, 지인이 Z.ai 를 추천함.

레딧 등을 찾아보니 굉장히 훌륭하다는 사람도 있고, 좀 불만이다란 사람이 있는데 가성비로는 모두 칭찬중.

한달에 200달러를 내다가, 프로모션 가격을 보니 288달러. 이정도 내고 1년을 잘 쓸수 있다면......

이라는 생각으로 지름.

https://z.ai/subscribe?ic=CG6U1YGH1Z

다음을 이용하면 Claude가 z.ai 를 사용하게 할 수 있음. z 라는 이름으로 사용하게 하고 종료하면 원래 claude로 되돌아가게 한다거나 하는 방법을 사용하면 좋을듯

https://github.com/geoh/z.ai-powered-claude-code

의 내용을 번역하면 다음과 같음.

Z.AI 기반 Claude Code

Claude Code가 Z.AI의 GLM 모델을 사용할 수 있도록 지원하는 래퍼(Wrapper) 스크립트 및 설정 파일 모음입니다. Anthropic의 기본 모델 대신 Z.AI 모델을 사용할 수 있는 대안을 제공하며, 강화된 상태 표시줄(Status Line) 기능을 포함합니다.

1장. 개요

본 프로젝트는 적절한 환경 변수 및 설정을 통해 Claude Code에서 GLM-4.6을 포함한 Z.AI의 GLM 모델을 사용할 수 있게 합니다. 주요 구성 요소는 다음과 같습니다.

1. 래퍼 스크립트: Z.AI 모델로 Claude Code를 실행하기 위한 스크립트입니다.
2. 상태 표시줄 설정: 모델 정보, Git 브랜치, 사용 통계 등을 표시합니다.
3. 교차 플랫폼 지원: Windows, macOS, Linux 환경을 모두 지원합니다.

2장. 사전 요구 사항

1. 시스템에 Claude Code가 설치되어 있어야 합니다.
2. 명령줄 JSON 처리기인 jq가 필요합니다.

• Ubuntu/Debian: sudo apt-get install jq
• macOS: brew install jq
• Windows: choco install jq 또는 scoop install jq

3. Z.AI API 키와 계정이 필요합니다.

3장. 빠른 시작

자동 설치 스크립트를 사용하는 것이 가장 간편한 방법입니다.

3.1. Linux/macOS

복사
bash scripts/install.sh

3.2. Windows (PowerShell)

복사
.\scripts\install.ps1

3.3. Windows (CMD)

복사
scripts\install.bat

설치 프로그램은 다음 과정을 수행합니다.

• 기존 설치 버전 감지 및 업그레이드 제안
• 래퍼 스크립트를 ~/.local/bin (Windows는 %USERPROFILE%\.local\bin)으로 복사
• 해당 디렉토리를 PATH에 추가(선택 사항)
• Claude 상태 표시줄 설정 설치(선택 사항)
• 최초 구성 안내

설치 후 z 또는 glm을 실행하여 대화형 설정 마법사를 시작합니다. API 키를 환경 변수로 저장하면 터미널 재시작 없이 즉시 세션에 적용됩니다.

참고: z와 glm 명령어는 동일하게 작동합니다. glm은 GLM 모델 제품군을 의미하는 대체 명칭입니다.

4장. 설정 관리

4.1. 환경 변수

보안과 유연성을 위해 다음 환경 변수를 지원합니다.

• ZAI_API_KEY: Z.AI API 키 (설정 파일보다 우선순위가 높습니다)
• ZAI_CONFIG_PATH: 사용자 정의 설정 파일 경로
• XDG_CONFIG_HOME: 설정 파일용 XDG 기본 디렉토리 (Linux/macOS 전용)

4.2. 설정 파일 탐색 순서

스크립트는 다음 순서대로 설정 파일을 검색하며, 먼저 발견된 파일을 사용합니다.

4.2.1. Linux/macOS

1. ./.zai.json (프로젝트별 설정)
2. $ZAI_CONFIG_PATH (설정된 경우)
3. $XDG_CONFIG_HOME/zai/config.json
4. ~/.config/zai/config.json (XDG 기본값)
5. ~/.zai.json (기존 경로 호환용)

4.2.2. Windows

1. .\.zai.json (프로젝트별 설정)
2. %ZAI_CONFIG_PATH% (설정된 경우)
3. %APPDATA%\zai\config.json
4. %USERPROFILE%\.zai.json (기존 경로 호환용)

4.3. 설정 파일 형식 및 옵션

설정 파일은 JSON 형식을 사용합니다.

복사
{
  "apiKey": "your-api-key",
  "opusModel": "glm-4.6",
  "sonnetModel": "glm-4.5",
  "haikuModel": "glm-4.5-air",
  "subagentModel": "glm-4.6",
  "defaultModel": "opus",
  "enableThinking": "true",
  "enableStreaming": "true",
  "reasoningEffort": "high",
  "maxThinkingTokens": "",
  "maxOutputTokens": ""
}

• apiKey: Z.AI API 키 (환경 변수 사용 시 생략 가능)
• opusModel: Opus 등급 요청에 사용할 모델 (기본값: "glm-4.6")
• sonnetModel: Sonnet 등급 요청에 사용할 모델 (기본값: "glm-4.5")
• haikuModel: Haiku 등급 요청에 사용할 모델 (기본값: "glm-4.5-air")
• subagentModel: 보조 에이전트 작업용 모델 (기본값: "glm-4.6")
• defaultModel: 모델 미지정 시 사용할 기본 모델 (기본값: "opus")
• enableThinking: AI 사고(Thinking) 기능 활성화 (기본값: "true")
• enableStreaming: 스트리밍 응답 활성화 (기본값: "true")
• reasoningEffort: 추론 강도 - "auto", "low", "medium", "high", "max" (기본값: "high")

4.4. 프로젝트별 설정

프로젝트 디렉토리에 .zai.json 파일을 생성하여 전역 설정을 재정의할 수 있습니다. API 키가 포함된 경우 반드시 .gitignore에 추가해야 합니다.

5장. 사용 방법

설치 후 claude 대신 z 또는 glm 명령어를 사용합니다.

복사
# 기본 모델로 세션 시작
z

# 특정 모델 사용
z --model sonnet

# Claude 인자 전달
z --model opus "Python 스크립트 작성을 도와줘"

5.1. 상태 표시줄 기능

상태 표시줄에는 다음 정보가 표시됩니다.

• 모델 표시기: Claude 모델은 👾, Z.AI 모델은 👹로 표시
• 모델 명칭: 현재 활성화된 모델 이름
• 작업 디렉토리: 현재 경로
• Git 정보: 현재 브랜치 정보
• 코드 변경 사항: 세션 중 추가/삭제된 라인 수
• 통계: API 응답 시간 및 세션 총 비용(USD)

주의: 상태 표시줄은 Windows의 경우 Git Bash에서만 안정적으로 작동합니다. CMD나 PowerShell에서는 표준 입력 파이핑 제한으로 인해 정상 작동하지 않을 수 있습니다.

6장. 문제 해결 (Troubleshooting)

1. "Valid API key not found" 오류: ZAI_API_KEY 환경 변수를 확인하거나 설정 파일에 유효한 apiKey가 있는지 확인합니다.
2. "jq not found" 오류: 시스템에 jq가 설치되어 있고 PATH에 등록되어 있는지 확인합니다.
3. 상태 표시줄 미표시: ~/.claude/settings.json에 상태 표시줄 설정이 포함되어 있는지, statusLine.sh 파일에 실행 권한이 있는지 확인합니다.

---

7장. 보안 권장 사항

1. API 키는 설정 파일보다 환경 변수에 저장하는 것을 권장합니다.
2. 프로젝트의 .zai.json 파일은 반드시 **.gitignore**에 등록합니다.
3. Unix 시스템에서는 설정 파일의 권한을 제한적으로 설정합니다 (chmod 600).

---

위의 소스를 git clone으로 받아온 다음에 실행하면

z 라는 이름으로 claude를 실행할 수 있음.

z라고 실행한 후 /model을 실행하면 Default 모델의 이름이 glm-4.5 인것을 알 수 있는데 이것이 z.ai 임. 가격은 잘못된 것.
엄청 많이 사용해도 주간 한계에 다다르지 않는다고 한다.