Claude Code

환경 변수 두 개 — ANTHROPIC_BASE_URL과 ANTHROPIC_AUTH_TOKEN — 설치를 변경하지 않고 Claude Code를 종량제 방식으로 전환합니다

# One terminal session
export ANTHROPIC_BASE_URL=https://api.kunavo.com   # origin, no /v1
export ANTHROPIC_AUTH_TOKEN=sk-kn-...

# Pin models Kunavo serves. Claude Code's default and its opus/sonnet aliases
# follow Anthropic's newest models; the sonnet alias asks for Sonnet 5.5,
# which Kunavo does not serve — unpinned, /model sonnet 404s.
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

claude

단계별 안내

1. /app/keys에서 키를 생성해 복사하세요. 키는 한 번만 표시됩니다.
2. 위 변수를 현재 세션에 export하거나 ~/.claude/settings.json의 env 블록에 저장하세요: {"env":{"ANTHROPIC_BASE_URL":"https://api.kunavo.com","ANTHROPIC_AUTH_TOKEN":"sk-kn-...","ANTHROPIC_MODEL":"claude-sonnet-5","ANTHROPIC_DEFAULT_OPUS_MODEL":"claude-opus-5-5","ANTHROPIC_DEFAULT_SONNET_MODEL":"claude-sonnet-5","ANTHROPIC_DEFAULT_HAIKU_MODEL":"claude-haiku-4-5"}}. Anthropic 문서에는 자격 증명을 프로젝트의 .claude/settings.json에 넣지 말라고 명시되어 있습니다. 해당 파일은 커밋되기 때문입니다.
3. claude를 실행하고 Status 탭을 여세요. Auth token를 언급하는 줄이 있으면 게이트웨이 자격 증명이 활성 상태임을 나타냅니다. claude.ai 계정을 언급하는 Login method 줄이 있으면 변수가 적용되지 않은 것입니다.
4. VS Code 확장 프로그램에서 변수는 VS Code 자체 사용자 설정의 claudeCode.environmentVariables에 입력해야 합니다. 확장 프로그램이 실행 전에 자격 증명을 확인하므로, ~/.claude/settings.json는 시작된 프로세스에는 전달되지만 해당 확인 절차에는 전달되지 않습니다.

Anthropic의 “Claude Code를 LLM 게이트웨이에 연결하기”에서 확인했습니다(2026년 10월 3일 기준). 서드파티 설정은 변경될 수 있으므로, 여기의 필드 이름이 실제 화면과 다르면 이 문서가 아니라 해당 페이지를 기준으로 삼으세요.

클라이언트를 디버깅하기 전에 확인할 사항

한 번의 요청으로 문제가 엔드포인트, 키 또는 구성 파일 중 어디에 있는지 판단할 수 있습니다. 이 요청에서 JSON이 반환되면 동일한 base URL과 키가 Claude Code에서 작동합니다.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/messages \
  -H "Authorization: Bearer sk-kn-..." \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":16,"messages":[{"role":"user","content":"ping"}]}'

필드에 입력할 model id

모든 텍스트 모델은 model id로 접근할 수 있습니다. 현재 목록은 GET /v1/models이며, 가격이 포함된 카탈로그는 모델 페이지에서 확인할 수 있습니다. 요금은 토큰 100만 개당 USD 기준이며 입력 / 출력 순서입니다.