WaveSpeedAI
← 블로그

Claude Code를 WaveSpeed LLM(OpenAI 호환 엔드포인트)으로 구성하는 방법

5분 이내에 Claude Code를 WaveSpeed LLM에 연결하세요. 하나의 OpenAI 호환 엔드포인트를 통해 Claude, GPT, Gemini 및 290개 이상의 다른 모델을 사용하세요 — Anthropic 키가 필요하지 않습니다.

3 min read
Claude Code를 WaveSpeed LLM(OpenAI 호환 엔드포인트)으로 구성하는 방법

Anthropic 키 없이 Claude Code 사용하기

Claude Code는 Claude를 활용한 코딩을 위한 Anthropic의 공식 CLI입니다. 하지만 반드시 Anthropic API를 통해 요청을 라우팅할 필요는 없습니다. 이미 WaveSpeed 계정이 있다면, Claude Code를 WaveSpeed LLM으로 연결하여 단일 OpenAI 호환 엔드포인트를 통해 Claude Opus 4.6, GPT-5.2, Gemini 3, DeepSeek 등 290개 이상의 모델에 액세스할 수 있습니다.

이 가이드에서는 필요한 환경 변수, 기본 URL, 모델 ID 형식을 정확히 다룹니다.

WaveSpeed를 통해 Claude Code를 라우팅하는 이유

  • 하나의 청구서, 여러 모델. Claude, GPT, Gemini, Llama, Qwen — 모두 WaveSpeed 계정을 통해 청구됩니다.
  • 어디서나 OpenAI 호환. Anthropic API 키, OpenAI 키, Google 키를 각각 관리할 필요가 없습니다.
  • 콜드 스타트 없음. 부하가 걸려도 일관된 지연 시간 — Anthropic 네이티브 API와 동일합니다.
  • 모델 이식성. 환경 변수 하나만 변경하면 세션 중간에 Claude Opus에서 GPT-5.2로 전환할 수 있습니다.

필요한 것

항목값
기본 URLhttps://llm.wavespeed.ai/v1
API 키WaveSpeed API 키
프로토콜OpenAI Chat Completions
모델 ID 형식vendor/model (예: anthropic/claude-opus-4.6)

1단계: Claude Code 설치

아직 설치하지 않았다면:

npm install -g @anthropic-ai/claude-code

2단계: WaveSpeed API 키 발급

  1. wavespeed.ai에 로그인합니다.
  2. 대시보드 → API Keys를 엽니다.
  3. 새 키를 생성하고 복사합니다.

3단계: WaveSpeed를 사용하도록 Claude Code 구성

Claude Code는 환경 변수를 통해 커스텀 OpenAI 호환 엔드포인트를 지원합니다. 실행 전에 다음을 설정하세요:

macOS / Linux

export ANTHROPIC_BASE_URL="https://llm.wavespeed.ai/v1"
export ANTHROPIC_API_KEY="YOUR_WAVESPEED_API_KEY"
export ANTHROPIC_MODEL="anthropic/claude-opus-4.6"

Windows (PowerShell)

$env:ANTHROPIC_BASE_URL = "https://llm.wavespeed.ai/v1"
$env:ANTHROPIC_API_KEY = "YOUR_WAVESPEED_API_KEY"
$env:ANTHROPIC_MODEL = "anthropic/claude-opus-4.6"

영구적으로 적용하려면 ~/.zshrc, ~/.bashrc 또는 Windows 환경 변수에 추가하세요.

4단계: Claude Code 시작

claude

Claude Code는 설정한 모델을 사용하여 모든 요청을 WaveSpeed LLM을 통해 라우팅합니다. 일반적인 스트리밍 응답이 표시되며 Anthropic 네이티브 API와 차이가 없습니다.

프로젝트 중간에 모델 전환하기

290개 이상의 모델이 하나의 엔드포인트를 공유하므로, 전환은 한 줄만 변경하면 됩니다. 다른 모델로 새 셸을 엽니다:

export ANTHROPIC_MODEL="openai/gpt-5.2-pro"
claude

또는 오픈소스 대안을 시도해 보세요:

export ANTHROPIC_MODEL="deepseek/deepseek-v4"
claude

동일한 코드베이스를 여러 모델이 어떻게 처리하는지 비교할 때 유용합니다.

Claude Code에 권장하는 모델

모든 모델이 에이전트 코딩에 최적화되어 있는 것은 아닙니다. 다음 모델들이 잘 작동합니다:

모델 ID최적 용도
anthropic/claude-opus-4.6기본값 — 가장 강력한 긴 컨텍스트 코딩 및 도구 사용
anthropic/claude-sonnet-4.6일상적인 작업을 위한 더 빠르고 저렴한 Claude
openai/gpt-5.2-pro최고의 대안 추론 성능
openai/gpt-5.2-chat균형 잡힌 속도와 품질
deepseek/deepseek-v4강력한 오픈소스 코더, 최저 비용

문제 해결

“Invalid API key” / 401 ANTHROPIC_API_KEY가 Anthropic 키가 아닌 WaveSpeed 키로 설정되어 있는지 확인하세요. Claude Code는 이를 ANTHROPIC_BASE_URL이 가리키는 곳에 bearer 토큰으로 전송합니다.

“Model not found” 항상 벤더 접두사를 포함하세요. anthropic/claude-opus-4.6은 작동하지만 claude-opus-4.6은 작동하지 않습니다.

요청이 계속 api.anthropic.com으로 전송됨 ANTHROPIC_BASE_URL은 claude를 실행하는 동일한 셸에서 설정되어야 합니다. 다음으로 확인하세요:

echo $ANTHROPIC_BASE_URL

비어 있으면 다시 내보내거나 셸 설정을 다시 로드하세요.

도구 사용 / 함수 호출이 작동하지 않음 선택한 모델이 도구를 지원하는지 확인하세요. anthropic/claude-opus-4.6과 openai/gpt-5.2-pro는 모두 지원하지만 일부 소형 모델은 지원하지 않습니다.

가격

선택한 모델에 대해 WaveSpeed의 토큰당 요금을 지불하며 추가 Claude Code 요금은 없습니다. wavespeed.ai/llm에서 가격을 비교하세요. Claude Opus 4.6은 입력 $5/M, 출력 $25/M입니다. 소형 모델은 $1/M 이하로 내려갑니다.

이 설정이 작동하는 이유

Claude Code의 ANTHROPIC_BASE_URL 오버라이드는 팀이 프록시, 게이트웨이, 엔터프라이즈 인증 레이어를 통해 라우팅할 수 있도록 설계되었습니다. WaveSpeed LLM은 OpenAI 호환 게이트웨이이며, Claude Code는 해당 엔드포인트를 가리키면 OpenAI Chat Completions를 사용하므로 오버라이드가 깔끔하게 작동합니다.

지금 바로 코딩 시작하기

환경 변수 세 개만 설정하면 하나의 청구서로 290개 이상의 모델에서 Claude Code를 실행할 수 있습니다.

WaveSpeed API 키 발급하기 후 몇 분 안에 Claude Code를 https://llm.wavespeed.ai/v1로 연결하세요.

공유