Windsurf 중계 접속 튜토리얼: Cascade 에이전트 사용자 지정 엔드포인트 설정

1. Windsurf란 무엇인가

Windsurf는 Cascade 에이전트가 내장된 AI 우선 IDE로, 사용자 지정 모델 엔드포인트 추가를 지원합니다. 본 사이트의 게이트웨이를 지정하면 통합 키를 사용하여 Claude / GPT / Gemini를 호출할 수 있습니다.

2. 준비 작업

1. 지능형 API 콘솔에 로그인하여 sk-xxxxxx API Key를 생성합니다(한 번만 표시되므로 반드시 저장하세요).
2. 사용할 모델 슬러그(예: claude-sonnet-5, gpt-5.5, gemini-3.7-flash)를 확인합니다.
3. 게이트웨이 주소 https://www.relay-api.com을 확인합니다.

3. Windsurf 설정 방법

Settings → Models / API Providers → Add Provider를 열고 공급자 유형을 선택한 후 다음 정보를 입력하세요:

Base URL : https://www.relay-api.com        # Claude / Anthropic
API Key  : sk-본인의 키
Model    : claude-sonnet-5
(GPT 모델의 경우 Base URL을 https://www.relay-api.com/v1 로 변경)
(Gemini 모델의 경우 Base URL을 https://www.relay-api.com/v1beta 로 변경)

저장 후 Cascade에서 해당 모델을 선택하고 Ctrl+L(macOS는 Cmd+L)을 눌러 대화를 시작하세요.

4. 인터페이스 주소 대조표

모델 그룹	본 사이트 입구(Base URL)	프로토콜
Claude / Anthropic	https://www.relay-api.com	Anthropic Messages
GPT / OpenAI	https://www.relay-api.com/v1	OpenAI Chat Completions
Gemini	https://www.relay-api.com/v1beta	Google generateContent

Base URL은 위 표의 입구를 사용하세요.

5. 자주 묻는 문제 해결

증상	조치
401 / 403	키가 유효하지 않거나, 활성화되지 않았거나, 잔액이 부족합니다. sk- 값이 정확한지 확인하고 충전하세요.
404 / 모델 사용 불가	모델 이름이 플랫폼 슬러그와 일치하지 않거나 해당 모델이 활성화되지 않았습니다. 모델 ID를 재확인하세요.

보안 권장 사항: 키를 공개 저장소에 작성하지 마세요. 용도별로 키를 별도로 생성하면 통계 확인 및 한도 관리에 용이합니다.

Base URL 설명: 본 사이트는 /v1beta/models/...와 /v1beta/v1beta/models/...(및 /v1/...와 /v1/v1/...)를 모두 수락하므로 클라이언트가 자동으로 /v1, /v1beta를 붙이는지 여부와 관계없이 호출이 가능합니다. 즉, Base URL에 도메인 루트만 입력하거나 /v1beta가 포함된 주소를 입력해도 모두 작동합니다. 모델 ID는 콘솔의 「토큰」 페이지 우측 상단 「모델 ID」에서 조회 및 복사할 수 있습니다.