WaveSpeedAI
← 블로그

Cursor에서 WaveSpeed LLM 사용하기: 커스텀 API 엔드포인트 가이드

Cursor를 WaveSpeed LLM에 연결하여 Claude Opus 4.6, GPT-5.2, Gemini 3 및 290개 이상의 모델을 사용하세요. 엔드포인트, API 키, 모델 ID 전체 구성 방법을 안내합니다.

By WaveSpeedAI 3 min read
Cursor에서 WaveSpeed LLM 사용하기: 커스텀 API 엔드포인트 가이드

나만의 커서, 나만의 모델

Cursor는 기본적으로 자체 호스팅 모델을 제공하지만, 진지한 Cursor 사용자라면 결국 자신만의 API 키를 사용하고 싶어집니다 — 비용을 절감하거나, 특정 모델을 사용하거나, 내부 게이트웨이를 통해 요청을 라우팅하기 위해서입니다. WaveSpeed LLM은 이 세 가지를 한 번에 해결합니다: 하나의 OpenAI 호환 엔드포인트, 290개 이상의 모델, 토큰당 과금, 구독 잠금 없음.

이 가이드는 필요한 정확한 Cursor 설정을 안내합니다.

설정할 내용

필드값
프로바이더 유형OpenAI (OpenAI 호환)
Base URL / 오버라이드https://llm.wavespeed.ai/v1
API 키WaveSpeed API 키
모델 IDvendor/model — 예: anthropic/claude-opus-4.6

1단계: WaveSpeed API 키 발급

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

2단계: Cursor 모델 설정 열기

  1. Cursor를 실행합니다.
  2. Settings (Cmd/Ctrl + Shift + J)를 엽니다.
  3. Models로 이동합니다.

기본 Cursor 호스팅 모델 목록과 커스텀 프로바이더 섹션이 표시됩니다.

3단계: WaveSpeed를 커스텀 OpenAI 엔드포인트로 추가

  1. OpenAI API Key (또는 동등한 커스텀 프로바이더 섹션)로 스크롤합니다.

  2. OpenAI API Key 필드에 WaveSpeed API 키를 붙여넣습니다.

  3. Override OpenAI Base URL (또는 유사한 토글)을 클릭합니다.

  4. Base URL을 붙여넣습니다:

    https://llm.wavespeed.ai/v1

  5. Verify / Save를 클릭합니다. Cursor가 테스트 요청을 전송합니다.

인증이 성공하면 키와 Base URL이 올바르게 설정된 것입니다.

4단계: WaveSpeed 모델 ID 추가

Cursor에서는 OpenAI 프로바이더 하위에 커스텀 모델 이름을 추가할 수 있습니다. 사용하려는 WaveSpeed 모델 ID를 추가하세요:

  • anthropic/claude-opus-4.6
  • anthropic/claude-sonnet-4.6
  • openai/gpt-5.2-pro
  • openai/gpt-5.2-chat
  • google/gemini-3-flash-preview
  • deepseek/deepseek-v4

저장하면 Cursor의 채팅 사이드바와 인라인 편집 UI의 모델 선택기에 표시됩니다.

5단계: 사용하기

Cursor에서 프로젝트를 열고, Cmd/Ctrl + L을 눌러 채팅을 열고, 드롭다운에서 WaveSpeed 모델을 선택합니다. 코드베이스에 대해 질문해 보세요. 정상적인 스트리밍 응답이 표시됩니다 — Cursor가 이제 WaveSpeed를 통해 라우팅되고 있습니다.

인라인 편집 (Cmd/Ctrl + K)과 탭 자동완성도 지원되는 경우 선택한 모델을 사용합니다.

Cursor를 위한 추천 모델

모델 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 OpenAI API Key” WaveSpeed API 키는 Cursor의 OpenAI API Key 필드에 입력합니다. Base URL 오버라이드가 Cursor에 전송 위치를 알려줍니다.

“Model not found” Cursor는 선택한 모델 문자열을 엔드포인트에 직접 전송합니다. 벤더 접두사가 포함되어야 합니다 — claude-opus-4.6이 아닌 anthropic/claude-opus-4.6.

네트워크 오류로 인증 실패 Base URL이 정확히 https://llm.wavespeed.ai/v1인지 확인하세요 — 후행 슬래시, v1 누락, 또는 api.wavespeed.ai 사용은 모두 실패합니다.

일부 Cursor 기능이 커스텀 엔드포인트에서 작동하지 않음 일부 고급 Cursor 기능(예: Cursor 자체 인덱싱 기반 기능)은 Cursor 호스팅 모델에 의존하며 커스텀 프로바이더를 사용하지 않습니다. 채팅, 인라인 편집, 자동완성은 모두 정상적으로 작동합니다.

이 설정이 가치 있는 이유

  • 많이 사용하는 날 비용을 절감하세요. 고정된 Cursor 구독 할당량을 소진하는 대신 WaveSpeed 토큰당 가격으로 openai/gpt-5.2-pro에서 대규모 리팩터링을 실행하세요.
  • Cursor가 호스팅하지 않는 모델에 접근하세요. Qwen 3, DeepSeek V4, Llama 4, Grok 4 — WaveSpeed 카탈로그의 모든 모델.
  • 하나의 청구서. Cursor 사용량, API 스크립트, 채팅 앱을 단일 WaveSpeed 계정으로 통합하세요.

지금 코딩 시작하기

두 개의 필드 — Base URL과 API 키 — 만으로 290개 이상의 모델로 Cursor를 실행할 수 있습니다.

WaveSpeed API 키 발급받기하고 몇 분 안에 Cursor가 https://llm.wavespeed.ai/v1을 가리키도록 설정하세요.

공유