Claude Code에서 GLM-5.3 사용하는 방법

Claude Code에 I Code Easy API Key, 루트 URL https://api.icodeeasy.cc, 모델 glm-5.3을 설정하면 이 서비스를 통해 GLM-5.3을 사용할 수 있습니다. macOS, Linux, Windows 설정과 확인 방법, 자주 발생하는 오류를 안내합니다.

모델과 클라이언트의 차이

GLM-5.3은 모델이고, Claude Code는 Anthropic의 코딩 클라이언트입니다. Claude Code를 실행한다고 반드시 Claude 모델이 요청을 처리하는 것은 아닙니다. 이 설정은 GLM-5.3을 선택합니다. 여기서는 이 서비스의 Key와 URL을 사용하며, Zhipu 공식 Key, Coding Plan 구독, 공식 접속 주소와는 다릅니다.

시작하기 전에

1. 클라이언트를 아직 설치하지 않았다면 Claude Code 설치 안내를 먼저 따르세요. Windows 터미널과 Git Bash 요구 사항은 Anthropic의 최신 설치 설명을 기준으로 합니다.
2. 회원 가입 후 API Keys에서 이 서비스의 Key를 복사하세요. 빠른 시작에 따라 사용할 접속점을 선택하세요.
3. 현재 요금은 가격 페이지, 지원 기능은 모델 기능 목록에서 확인하세요. 공식 Coding Plan의 가격과 할당량은 이 서비스에 적용되지 않습니다.
4. Key는 본인의 로컬 설정에만 저장하세요. 저장소, 스크린샷, 채팅, 지원 문의에 포함하지 마세요.

설정 요약

기본 모델 변수 세 개는 Claude Code가 Haiku, Sonnet, Opus 별칭을 사용할 때도 GLM-5.3을 선택하도록 합니다. GLM을 Claude 모델로 바꾸는 설정은 아닙니다. 기존 템플릿의 ANTHROPIC_SMALL_FAST_MODEL은 권장 설정에서 제외하고 위의 기본 모델 변수 세 개를 사용합니다.

Linux / MacOS

Claude Code를 실행할 터미널에 아래 설정을 붙여 넣고 자리표시자를 이 서비스의 Key로 바꾸세요. 먼저 현재 터미널 세션에 적용됩니다.

export ANTHROPIC_AUTH_TOKEN="본인의 I Code Easy API Key"
export ANTHROPIC_BASE_URL="https://api.icodeeasy.cc"
export ANTHROPIC_MODEL="glm-5.3"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="glm-5.3"
export ANTHROPIC_DEFAULT_SONNET_MODEL="glm-5.3"
export ANTHROPIC_DEFAULT_OPUS_MODEL="glm-5.3"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

지속적으로 적용하려면 같은 export 줄을 셸 시작 파일에 추가하세요. zsh는 ~/.zshrc, bash는 ~/.bashrc입니다. 사용하는 셸에 맞는 줄만 실행하세요.

source ~/.zshrc

source ~/.bashrc

터미널을 새로 열어도 됩니다. 이미 실행 중인 Claude Code는 변경된 환경 변수를 읽지 않으므로 종료한 뒤 설정한 터미널에서 다시 실행하세요.

Windows

현재 PowerShell 세션에만 적용하려면 다음을 실행하세요.

$env:ANTHROPIC_AUTH_TOKEN = "본인의 I Code Easy API Key"
$env:ANTHROPIC_BASE_URL = "https://api.icodeeasy.cc"
$env:ANTHROPIC_MODEL = "glm-5.3"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "glm-5.3"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "glm-5.3"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "glm-5.3"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC = "1"

사용자 수준으로 저장하려면 위 변수를 설정한 같은 창에서 아래 코드를 실행하세요. 이 일곱 값을 사용자 환경에 저장합니다.

$names = @(
  "ANTHROPIC_AUTH_TOKEN",
  "ANTHROPIC_BASE_URL",
  "ANTHROPIC_MODEL",
  "ANTHROPIC_DEFAULT_HAIKU_MODEL",
  "ANTHROPIC_DEFAULT_SONNET_MODEL",
  "ANTHROPIC_DEFAULT_OPUS_MODEL",
  "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC"
)
foreach ($name in $names) {
  $value = [Environment]::GetEnvironmentVariable($name, "Process")
  [Environment]::SetEnvironmentVariable($name, $value, "User")
}

사용자 환경 변수는 이후 실행되는 프로세스에 적용됩니다. 저장 후 PowerShell을 새로 여세요. VS Code 등 통합 터미널을 사용한다면 호스트 앱도 재시작한 뒤 Claude Code를 실행하세요.

로컬 확인 후 실제 요청 보내기

먼저 클라이언트 설치를 확인하세요. 다음 명령은 버전만 출력하며 모델 요청을 보내지 않습니다.

claude --version

Key 자체를 출력하지 말고 불리언 값으로 존재 여부만 확인하세요.

macOS / Linux:

test -n "$ANTHROPIC_AUTH_TOKEN" && echo true || echo false

PowerShell:

[bool]$env:ANTHROPIC_AUTH_TOKEN

설정한 터미널에서 claude를 실행한 뒤 클라이언트에 /status를 입력해 모델과 연결 설정을 확인하세요. 상태 화면은 설정을 살펴보는 단서입니다. 화면에 Claude Code, Haiku, Sonnet, Opus가 표시된다는 사실만으로 Claude 모델이 요청을 처리했다고 판단할 수는 없습니다.

그다음 Claude Code에서 “OK만 답해 줘”와 같은 짧은 프롬프트를 직접 보내세요. 실제 요청이 발생하며 현재 규칙에 따라 요금이 부과됩니다. 요청 로그에서 성공 여부, 기록된 모델, 요금을 확인하세요. 응답에서 모델이 자신을 소개한 이름만 믿고 판단하지 마세요.

자주 발생하는 문제 해결

기본 도메인 연결이 느리면 ANTHROPIC_BASE_URL만 변경하고 다른 변수는 유지하세요. 대체 주소에도 /v1을 붙이지 않습니다.

https://jp.icodeeasy.cc
https://sg.icodeeasy.cc

주소 변경 후 Claude Code를 재시작하고 위 확인 절차를 반복하세요. 문제 해결 시 오류 코드, 발생 시각, 민감 정보를 제거한 로그를 제공하고 Key 원문은 보내지 마세요.

모델이나 터미널을 전환할 때

이전에 Claude나 Kimi를 설정했다면 현재 터미널에 남아 있는 모델 설정을 먼저 확인하세요. 서로 다른 안내의 값을 섞지 마세요. 다시 전환할 때는 해당 안내에 따라 URL, Key, 모델 변수를 복원하세요.

시스템 터미널, IDE 통합 터미널, 이미 실행 중인 클라이언트는 서로 다른 환경을 상속할 수 있습니다. 실제로 Claude Code를 시작할 같은 터미널에서 설정하고 확인하세요.

관련 안내와 공식 참고 자료

• Claude Code 설치 및 기본 설정
• Kimi 연결 안내: Kimi를 쓸 때는 전용 페이지의 설정을 따르고 모델 이름을 섞지 마세요.
• 가격, 잔액, 사용량
• Anthropic 환경 변수
• Anthropic 모델 설정
• Zhipu Claude Code 안내: 모델 별칭 설정을 이해하기 위한 자료입니다. 공식 URL, Key, 구독 설명은 이 서비스에 적용되지 않습니다.