APIMaster.ai
APIMaster.ai 문서
Quick startAPIMaster.aiMarketplace

Claude Code에서 GLM-5.2, GLM-5.3, GLM-5.3-Flash 사용하기: 설정 및 모델 전환

APIMaster를 사용하여 Claude Code에서 GLM을 설정합니다. Windows, macOS, Linux에서 settings.json을 구성하고, claude를 실행하고, /model로 모델을 선택한 후 대화를 시작합니다.

settings.json에서 APIMaster를 구성하고, claude를 실행한 다음, 대화 중에 /model MODEL_ID를 입력하면 GLM을 사용할 수 있습니다. 여기서 다루는 사용 가능한 ID는 glm-5.2, glm-5.3, glm-5.3-flash입니다. Claude Code는 클라이언트이며, GLM은 응답을 생성하는 모델입니다.

시작하기 전에

환경 확인과 Claude Code 설정을 완료하세요. 충분한 잔액이 있고 선택한 모델에 접근할 수 있는 APIMaster API 키를 발급받으세요.

claude --version

게이트웨이 베이스 URL은 https://apimaster.ai 이며, /v1 은 포함하지 않습니다. Claude Code가 /v1/messages를 직접 추가합니다.

1. 설정 디렉터리 열기

Windows

Win + R 을 누르고 다음 경로를 입력한 후 Enter를 누릅니다:

%USERPROFILE%\.claude

필요하면 폴더를 새로 만드세요. settings.json 파일을 열거나 생성합니다. 파일 이름이 settings.json.txt가 아닌지 확인하세요.

macOS / Linux

macOS에서는 Finder에서 Command + Shift + G 를 누르고 다음을 입력합니다:

~/.claude

Linux에서는 파일 관리자나 편집기로 같은 디렉터리를 엽니다. 필요하면 생성하세요:

mkdir -p ~/.claude

그곳에서 settings.json 파일을 열거나 생성합니다. 사용자 지정 Claude Code 설정 디렉터리를 지정했다면 해당 디렉터리를 대신 사용하세요.

2. settings.json 편집

Windows, macOS, Linux는 모두 동일한 설정을 사용합니다. YOUR_APIMASTER_API_KEY를 본인의 APIMaster 키로 교체하세요:

{
  "model": "glm-5.3",
  "env": {
    "ANTHROPIC_BASE_URL": "https://apimaster.ai",
    "ANTHROPIC_API_KEY": "YOUR_APIMASTER_API_KEY",
    "ANTHROPIC_AUTH_TOKEN": "",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}

파일이 이미 존재한다면 백업한 후, 이 필드들을 기존 JSON 객체와 env 객체에 병합하세요. 필요한 다른 설정은 그대로 유지합니다. 두 번째 JSON 객체를 추가하거나 env 키를 중복해서는 안 됩니다. JSON은 주석이나 후행 쉼표를 허용하지 않습니다.

일반 Claude Code 가이드는 토큰 인증 방식을 보여줍니다. 이 가이드는 통합 테스트에서 사용한 API 키 인증 방식을 사용합니다. ANTHROPIC_API_KEY를 사용할 때는 ANTHROPIC_AUTH_TOKEN을 비워두고, 다른 설정이나 터미널에서 충돌하는 자격 증명은 제거하세요. 이 게이트웨이에는 APIMaster 키를 사용하세요.

model 필드는 시작 모델을 지정합니다. 실행 후 다른 모델을 선택할 수 있습니다. 이 사용자 설정 파일은 비공개로 유지하고, 실제 키를 공유 저장소에 커밋하지 마세요. 파일을 저장한 후 Claude Code를 다시 시작하면 새 설정이 적용됩니다.

3. Claude Code 시작

프로젝트 디렉터리에서 연 터미널에서 다음을 실행합니다:

claude

일반적인 첫 실행 프롬프트를 완료하고 프로젝트 신뢰 프롬프트를 확인하세요. 시작 모델은 glm-5.3 이어야 합니다. 이는 일반적인 도구와 프로젝트 설정을 갖춘 평범한 대화형 세션입니다.

4. 모델 선택 및 대화 시작

Claude Code 대화 에서 다음 명령 중 하나를 입력하고 Enter를 누릅니다:

/model glm-5.2
/model glm-5.3
/model glm-5.3-flash

한 번에 한 줄씩 실행하며 원하는 모델을 선택하세요. Claude Code가 전환을 확인한 후, 짧은 메시지를 보냅니다:

Reply with exactly OK.

정상적인 텍스트 응답이 돌아오면 기본 연결이 확인된 것입니다. 이후 대화를 계속하거나 프로젝트 작업을 요청할 수 있습니다. 같은 대화에서 다시 전환하려면 다른 /model MODEL_ID 명령을 입력하세요.

/model만 입력하면 모델 선택기가 열립니다. 사용자 지정 게이트웨이 ID는 기본 목록에 나타나지 않을 수 있습니다. 이 경우 위와 같이 전체 ID를 직접 입력하세요. 슬래시 명령은 PowerShell이나 Bash가 아니라 Claude Code 안에서 사용하는 것입니다. 모델 이름은 GLM 모델을 나타내며, Claude Sonnet이나 Opus가 아닙니다.

터미널 에서 실행할 때 모델을 선택할 수도 있습니다. 한 번에 하나의 명령을 실행하세요:

claude --model glm-5.2
claude --model glm-5.3
claude --model glm-5.3-flash

이후 세션의 기본값을 명시적으로 지정하려면 settings.json의 model을 편집하세요. 실행 플래그, ANTHROPIC_MODEL 환경 변수, 프로젝트/관리 설정이 선택된 모델에 영향을 줄 수 있습니다. 시작 모델이 저장된 값과 다르면 이 항목들을 확인하세요.

문제 해결

증상 확인 사항
401 / 예상치 못한 로그인 프롬프트 APIMaster 키, 베이스 URL, 충돌하는 인증 변수를 확인하고, 설정을 편집한 후 CLI를 다시 시작하세요.
404 /v1 또는 /v1/messages 없이 https://apimaster.ai를 사용하세요.
설정이 적용되지 않음 파일 위치, 유효한 JSON 여부, 터미널/프로젝트/관리 설정에 의한 재정의를 확인하세요.
선택기에 모델이 없음 정확한 ID로 /model MODEL_ID를 입력하거나, claude --model MODEL_ID로 실행하세요.
모델 사용 불가 / 403 철자, 키의 허용 모델, 계정 잔액, 현재 라우트 가용성을 확인하세요.
unrecognized_model 테스트에서 사용자 지정 ID로 관찰된 사례입니다. 실제 응답과 도구 결과를 확인하세요. GLM에 대해 내장된 Claude 기능 기본값은 검증되지 않았습니다.
파일 또는 명령 권한 거부 일반 권한 프롬프트를 통해 의도한 작업을 검토하고 승인하세요.
429 / 5xx / 응답 중단 지원 요청 시 오류 내용, 모델 ID, CLI 버전, UTC 시간, 가능하다면 요청 ID를 보관하세요.

검증 및 선택적 진단

기록된 통합 테스트: 2026-09-15 UTC, Claude Code 2.1.239, Linux. 여기에 나열된 모든 모델이 예상한 텍스트를 반환했고, 도구를 통해 로컬 파일을 읽었습니다. 세 모델 모두 작은 Python 수정 및 테스트 실행도 완료했으며, 이후 독립적으로 검증했습니다. Windows와 macOS는 해당 기록 실행에 포함되지 않았습니다.

이전 자동화 점검에서는 설정을 분리하기 위해 베어 모드를 사용했습니다. 일상적인 사용은 위의 settings.json 및 대화형 단계를 따릅니다. 베어 모드와 --setting-sources ""는 일반적인 통합이나 저장된 설정을 건너뛰므로, 이 가이드의 일상적인 시작 명령에 추가해서는 안 됩니다.

저장된 설정을 사용한 빠른 비대화형 점검:

claude --model glm-5.3 -p "Reply with exactly OK."

도구 점검을 위해 FILE_PROBE_739182가 포함된 probe.txt 파일을 만들고, 해당 디렉터리에서 Claude Code를 시작한 후, 도구를 사용해 파일을 읽고 정확한 내용을 반환하도록 요청하세요. 도구가 실제로 실행되는지 확인합니다.

이것들은 범위가 제한된 통합 점검이며, 모든 Claude Code 기능, 장시간 세션 동작 또는 최대 컨텍스트를 보장하지 않습니다. Anthropic의 게이트웨이 문서는 Claude Code를 비(非)Claude 모델로 라우팅하는 것을 공식적으로 지원하지 않으며, 이 가이드는 APIMaster의 통합을 설명합니다.

FAQ

Claude 구독이 이러한 요청 비용을 지불하나요?

아니요. 이 APIMaster 구성에서는 요청이 APIMaster 키와 잔액을 사용합니다.

모델을 전환한 후에도 대화를 계속할 수 있나요?

네, 열려 있는 대화에서 모델 전환 명령을 사용하고 다음 메시지를 보내기 전에 확인을 기다리세요. 모델 간 깔끔한 비교를 위해서는 claude --model MODEL_ID로 별도의 세션을 시작하세요.

관련 가이드 및 참고 자료