연동Claude Code

Claude Code

Claude Code는 Anthropic Messages API를 지원하는 모든 엔드포인트에서 작동합니다. 설정할 항목은 세 가지입니다: 기본 URL(https://api.abliteratedllm.dev), API 키, 그리고 Claude Code의 각 별칭이 사용할 모델입니다.

자리 표시자: $API_BASE는 https://api.abliteratedllm.dev/v1, $API_ORIGIN은 https://api.abliteratedllm.dev, $YOUR_KEY는 발급받은 API 키입니다.

셸에서 변수 설정하기

Bash 또는 Zsh:

bash
export ANTHROPIC_BASE_URL="$API_ORIGIN"
export ANTHROPIC_AUTH_TOKEN="$YOUR_KEY"
export ANTHROPIC_DEFAULT_OPUS_MODEL="glm-5.3-flash-abliterated"
export ANTHROPIC_DEFAULT_SONNET_MODEL="glm-5.3-flash-abliterated"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="glm-5.3-flash-abliterated"
claude

PowerShell:

powershell
$env:ANTHROPIC_BASE_URL = "$API_ORIGIN"
$env:ANTHROPIC_AUTH_TOKEN = "$YOUR_KEY"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "glm-5.3-flash-abliterated"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "glm-5.3-flash-abliterated"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "glm-5.3-flash-abliterated"
claude

셸 변수는 해당 터미널 세션에서만 유지됩니다.

또는 설정 파일에 지정하기

Claude Code가 실행되는 모든 곳에 적용하려면 ~/.claude/settings.json(Windows에서는 %USERPROFILE%\.claude\settings.json)의 env 블록에 넣으세요:

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "$API_ORIGIN",
    "ANTHROPIC_AUTH_TOKEN": "$YOUR_KEY",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5.3-flash-abliterated",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5.3-flash-abliterated",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-5.3-flash-abliterated"
  }
}

프로젝트의 .claude/settings.json에는 키를 넣지 마세요. 이 파일은 보통 저장소에 커밋됩니다.

각 변수의 역할

변수값
ANTHROPIC_BASE_URL/v1 없는 API 오리진입니다. Claude Code가 /v1/messages를 직접 붙입니다.
ANTHROPIC_AUTH_TOKENAPI 키이며 Authorization: Bearer로 전송됩니다. ANTHROPIC_API_KEY도 사용할 수 있습니다. 이 경우 키는 x-api-key로 전송되고, Claude Code가 사용 승인을 한 번 요청합니다.
ANTHROPIC_DEFAULT_OPUS_MODELopus 별칭에 연결되는 모델입니다.
ANTHROPIC_DEFAULT_SONNET_MODELsonnet 별칭에 연결되는 모델입니다.
ANTHROPIC_DEFAULT_HAIKU_MODELhaiku 별칭에 연결되는 모델입니다. Claude Code는 세션 제목 생성 같은 백그라운드 작업에도 이 모델을 사용합니다.

예시에서는 세 별칭 모두에 glm-5.3-flash-abliterated 모델을 연결합니다. 활성화된 모델이라면 어느 별칭에든 연결할 수 있으므로, GET /v1/models에 여러 모델이 나열되어 있다면 자주 발생하는 백그라운드 호출을 위해 haiku에 더 저렴한 모델을 연결할 수 있습니다.

연결 확인

Claude Code를 시작하기 전에 같은 변수로 요청을 하나 보내 보세요:

bash
curl "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "content-type: application/json" \
  -d '{"model": "glm-5.3-flash-abliterated", "max_tokens": 16, "messages": [{"role": "user", "content": "Say hi"}]}'

그런 다음 같은 셸에서 claude를 시작하고 /status를 실행하세요. Anthropic base URL 줄에는 API 오리진이, 인증 줄에는 ANTHROPIC_AUTH_TOKEN이 표시되어야 합니다. 401이 반환되면 키가 잘못되었거나 폐기된 것입니다.

참고 사항

  • 이미지: 붙여 넣은 스크린샷과 이미지는 GET /v1/models의 input_modalities에 image가 포함된 모델에서만 작동합니다. 다른 모델에서는 400 unsupported_content 오류로 실패합니다.
  • 체험 계정은 동시 요청 1건과 출력 토큰 4096개까지 허용합니다. Claude Code는 요청을 병렬로 보내므로(백그라운드 작업, 하위 에이전트) 체험 계정에서는 429 rate_limit_exceeded 오류가 발생할 수 있습니다. 유료 계정은 동시 요청 64건까지 허용합니다. 속도 제한 및 체험을 참고하세요.
  • 사고(thinking): Claude Code의 사고 설정은 thinking 파라미터를 통해 모델에 전달됩니다. 이 파라미터는 POST /v1/messages에 설명되어 있습니다.
  • 인식할 수 없는 필드: 요청이 context_management 또는 기타 알 수 없는 필드를 언급하는 400 오류로 실패하면 CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1을 설정하세요.
  • 기타 트래픽: Claude Code는 버전 확인과 텔레메트리도 Anthropic에 직접 전송합니다. CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1로 이를 끌 수 있습니다(자동 업데이트도 비활성화됩니다).
  • 지원: Anthropic은 Claude 이외의 모델과 함께 사용하는 Claude Code를 지원하지 않습니다. Remote Control, 음성 받아쓰기처럼 Anthropic 전용 API에 의존하는 기능은 게이트웨이 자격 증명이 설정된 동안 사용할 수 없습니다.

2026년 11월 3일에 Claude Code 문서와 대조해 확인했습니다: Connect Claude Code to an LLM gateway, Environment variables.