Claude Code와 BazaarLink 연결 설정 가이드

Claude Code는 base URL과 API key를 바꾸어 BazaarLink를 사용할 수 있습니다. 아래 설정은 BazaarLink의 Anthropic 호환 Messages endpoint를 사용합니다.

1. 환경 변수 설정

Claude Code를 시작하기 전에 변수를 export하세요. ANTHROPIC_AUTH_TOKEN은 Authorization token으로 전송되므로 커밋하지 말고 shell 환경에 보관하세요.

1
2
3
4
5
export ANTHROPIC_BASE_URL="https://api.bazaarlink.ai/v1"
export ANTHROPIC_AUTH_TOKEN="your-bazaarlink-api-key"
export ANTHROPIC_MODEL="openai/gpt-5.6-luna"
export ANTHROPIC_SMALL_FAST_MODEL="anthropic/claude-haiku-4.5"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

2. settings.json으로 설정

지속적인 Claude Code 설정을 원하면 같은 값을 사용자 설정 파일에 넣으세요. placeholder는 자신의 컴퓨터에서만 실제 BazaarLink key로 바꾸세요.

1
2
3
4
5
6
7
8
9
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.bazaarlink.ai/v1",
    "ANTHROPIC_AUTH_TOKEN": "your-bazaarlink-api-key",
    "ANTHROPIC_MODEL": "openai/gpt-5.6-luna",
    "ANTHROPIC_SMALL_FAST_MODEL": "anthropic/claude-haiku-4.5",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

3. 요청 경로 확인

긴 Claude Code 세션 전에 이 작은 Messages request를 실행하세요. model과 stop reason이 있는 JSON response는 설정한 base URL과 key가 BazaarLink에 도달했음을 확인해 줍니다. 이후 Logs 페이지에서 요청을 확인하세요.

1
2
3
4
5
6
7
8
curl -sS "$ANTHROPIC_BASE_URL/messages"   -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN"   -H "anthropic-version: 2023-06-01"   -H "content-type: application/json"   -d '{
    "model": "openai/gpt-5.6-luna",
    "max_tokens": 32,
    "messages": [{"role": "user", "content": "Reply with OK"}]
  }' | jq '{id, model, stop_reason}'

# After Claude Code runs, confirm the same request in:
# https://bazaarlink.ai/logs

4. 일반적인 오류

401 Unauthorized

증상: Claude Code 또는 curl 확인이 인증 오류를 보고합니다. 원인: ANTHROPIC_AUTH_TOKEN이 없거나 오타가 있거나 변경 후 shell을 재시작하지 않았습니다. 해결: BazaarLink API key를 설정하고 Authorization: Bearer 전송을 확인한 뒤 같은 shell에서 시작하세요.

404 model_not_found

증상: 요청은 gateway에 도달하지만 model이 거부됩니다. 원인: ANTHROPIC_MODEL 또는 ANTHROPIC_SMALL_FAST_MODEL이 현재 /models response의 정확한 ID가 아닙니다. provider prefix와 구두점을 포함해 ID를 복사하세요.

Base URL에 /v1이 없음

증상: route 404가 반환되거나 트래픽이 BazaarLink 대신 Anthropic으로 갑니다. 원인: /v1 누락, /messages 중복, 다른 host 사용입니다. ANTHROPIC_BASE_URL을 https://api.bazaarlink.ai/v1로 설정하면 Claude Code가 /messages를 붙입니다.

5. model 선택

live /models endpoint를 source of truth로 사용하세요. 아래는 brief의 유효한 예입니다. 전체 provider/model ID를 ANTHROPIC_MODEL 또는 ANTHROPIC_SMALL_FAST_MODEL에 복사하세요.

1
2
3
openai/gpt-5.6-luna
anthropic/claude-haiku-4.5
deepseek/deepseek-v4.1-flash