Z.ai (GLM)

Z.ai는 자신의 GLM 모델을 Anthropic 호환 엔드포인트를 통해 제공합니다 — shunt는 Claude Code의 Messages 요청을 그대로 전달하고 Z.ai API 키를 주입합니다. 내장 프리셋이 없으므로, 업스트림이 kind와 base_url을 명시적으로 선언합니다.

빠른 시작

코딩 에이전트가 대신 구성하도록 하세요 — 이름이 있는 블루프린트가 없는 프로바이더의 경우 shunt add가 일반 리서치 가이드에 문서 URL을 삽입합니다(오프라인·읽기 전용이며, 구성은 에이전트가 편집하고 이 명령은 절대 편집하지 않습니다):

shunt add upstream https://docs.z.ai/ --print | claude

또는 아래의 수동 단계를 따르세요.

업스트림 구성

[[upstreams]]
name = "anthropic"
provider = "anthropic"   # 라우트가 없는 모델(예: claude-*)의 기본값으로 Anthropic을 유지

[[upstreams]]
name = "zai"
kind = "anthropic"
base_url = "https://api.z.ai/api/anthropic"
auth = { mode = "api_key", env = "ZAI_API_KEY" }

[[routes]]
model = "glm-5.2"
provider = "zai"

[[routes]]
model = "glm-4.7"
provider = "zai"

순서가 있는 [[upstreams]]는 shunt의 내장 프로바이더를 대체하므로, 구성은 여전히 폴백 대상인 anthropic 기본값을 선언해야 합니다(server.default_provider의 기본값은 anthropic입니다).

레거시 [providers.zai] 테이블 형식도 계속 지원됩니다 — 다만 한 파일에서 [[upstreams]]와 [providers.*]를 섞지 마세요.

자격 증명

export ZAI_API_KEY='...'

키를 구성 파일에 절대 쓰지 마세요. shunt check는 구성의 구조를 검증하지만 키의 값을 읽지는 않습니다 — ZAI_API_KEY가 설정되어 있지 않으면 zai로 라우팅된 첫 요청이 인증 오류를 반환합니다.

모델

Claude Code에서 라우팅된 id는 ANTHROPIC_MODEL, ANTHROPIC_CUSTOM_MODEL_OPTION, 또는 서브에이전트의 model: 프론트매터로 선택하세요. 대신 /model 선택기에 항목을 드러내려면, [models.upstream_model] 맵과 함께 claude 프리픽스가 붙은 별칭을 광고하세요 — 모델 디스커버리를 참고하세요.

검증

shunt check    # -> config ok
shunt run
curl -sS http://127.0.0.1:3001/v1/messages \
  -H 'anthropic-version: 2023-06-01' \
  -H 'content-type: application/json' \
  -d '{"model":"glm-5.2","max_tokens":16,"messages":[{"role":"user","content":"Reply with OK."}]}'

응답의 x-gateway-upstream 헤더가 zai를 가리키는지 확인한 다음, Claude Code를 shunt로 지정하세요.

서브에이전트 플러그인

shunt-zai 플러그인은 위 모델마다 하나씩 미리 만들어진 Claude Code 서브에이전트를 제공합니다:

/plugin marketplace add pleaseai/shunt
/plugin install shunt-zai@shunt