본문으로 건너뛰기

Claude Code에서 Anthropic과 Z.ai GLM 모델 분리 설정하기

정석

Claude Code와 Z.ai GLM 통합

Claude Code는 Anthropic의 공식 터미널 기반 AI 코딩 어시스턴트다. 기본적으로 Claude 모델을 사용하지만, 환경변수를 조정하면 다른 Anthropic 호환 API도 사용할 수 있다.

그중 Z.ai의 GLM 시리즈는 가격 경쟁력과 성능 면에서 주목받고 있다. 이 글에서는 기본 Claude 설정은 유지하면서, 별도 명령어로 Z.ai GLM 모델을 사용하는 분리 설정 방법을 정리한다.


1. 왜 분리 설정이 필요한가?

Claude Code는 기본적으로 Anthropic API를 사용한다. 하지만 모든 상황에서 Claude를 쓸 필요는 없다.

그래서 “기본은 Claude, 필요할 때만 GLM”이라는 구성이 필요하다.


2. Z.ai GLM 모델 개요

GLM-4.7 가격 (1M 토큰 기준)

항목가격 (USD)
입력$0.6
캐시 입력$0.11
출력$2.2

캐시 입력 사용 시 ~82% 절감. GLM-4.7-FlashX 변형은 입력 $0.07, 출력 $0.4로 더 저렴하다.

구독 플랜 (Coding Plan)

플랜첫 달 / 연간이후 월 / 연간
Lite$3 / $28.8$6 / $72
Pro$15 / $144$30 / $360
Max$30 / $288$60 / $720

Claude Max Plan($100200/월) 대비 **47배 저렴**하다.


3. 쉘 함수로 Anthropic과 Z.ai 분리 설정하기

핵심 아이디어는 간단하다. 별도의 쉘 함수를 만들어서 환경변수를 함수 내에서만 적용하는 것이다.

ZSH 설정 (~/.zshrc)

# Z.ai GLM으로 Claude Code 실행
zaiclaude() {
  ANTHROPIC_BASE_URL=https://api.z.ai/api/anthropic \
  ANTHROPIC_AUTH_TOKEN="YOUR_ZAI_AUTH_TOKEN" \
  CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 \
  claude "$@"
}

Fish 설정 (~/.config/fish/config.fish)

function zaiclaude
  set -lx ANTHROPIC_BASE_URL https://api.z.ai/api/anthropic
  set -lx ANTHROPIC_AUTH_TOKEN "YOUR_ZAI_AUTH_TOKEN"
  set -lx CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 1
  claude $argv
end

Bash 설정 (~/.bashrc)

zaiclaude() {
  ANTHROPIC_BASE_URL=https://api.z.ai/api/anthropic \
  ANTHROPIC_AUTH_TOKEN="YOUR_ZAI_AUTH_TOKEN" \
  CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 \
  claude "$@"
}

4. 사용 방법

설정 후 쉘을 재시작하거나 source ~/.zshrc로 적용한다.

# 기본 Claude (Anthropic)
claude

# Z.ai GLM 모델 사용
zaiclaude

# 특정 모델 지정
zaiclaude -m sonnet  # GLM-4.7로 매핑

5. 팁과 주의사항

CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

이 환경변수는 텔레메트리와 같은 불필요한 네트워크 트래픽을 비활성화한다. 요청이 더 깔끔해지고, 외부 서비스로의 데이터 전송을 줄일 수 있다.

OpenRouter 등 다른 프로바이더 추가

같은 방식으로 OpenRouter나 다른 Anthropic 호환 API도 추가할 수 있다.

# OpenRouter용 함수
openrouterclaude() {
  ANTHROPIC_BASE_URL=https://openrouter.ai/api/v1 \
  ANTHROPIC_AUTH_TOKEN="YOUR_OPENROUTER_KEY" \
  claude "$@"
}

API 키 보안

API 키를 쉘 설정 파일에 직접 적는 대신, 환경변수 파일을 분리하거나 키체인을 사용하는 것이 좋다.


마치며: 비용 절감과 선택의 자유

개발자의 도구 선택

Claude Code는 훌륭한 도구지만, 모델 선택의 자유를 포기해야 하는 것은 아니다. 쉘 함수 하나로:

이렇게 분리하면 상황에 맞는 모델을 선택할 수 있고, 비용도 최적화할 수 있다.

AI 코딩 어시스턴트의 가격과 성능은 계속 변화하고 있다. 하나의 프로바이더에 종속되지 않고, 필요할 때마다 최선의 선택을 할 수 있는 구조를 갖춰두는 것이 중요하다.


🔗 참고 자료

이전
Ouroboros: 자신의 코드를 스스로 고쳐 쓰며 자율 진화하는 AI 에이전트의 탄생
다음
secure-openclaw: 메시징 앱 위에서 24x7로 동작하는 개인 AI 비서