Windsurf 중계 연동 튜토리얼: Cascade 에이전트 사용자 지정 엔드포인트 설정
Codeium Windsurf AI IDE 연동 튜토리얼: 설정에서 사용자 지정 모델 엔드포인트와 API Key를 구성하여 Claude / GPT / Gemini 등 다양한 모델을 호출하는 방법.
1. Windsurf란 무엇인가
Windsurf는 Cascade AI 에이전트가 내장된 AI 우선 IDE로, 사용자 지정 모델 엔드포인트 추가를 지원합니다. 본 사이트의 게이트웨이를 설정하면 통합 키 하나로 Claude / GPT / Gemini를 호출할 수 있습니다.
2. 준비 작업
- 지능형 API(极智API) 콘솔에 로그인하여
sk-xxxxxx형식의 API Key를 생성합니다(한 번만 표시되므로 반드시 저장해 두세요). - 사용할 모델 슬러그(예:
claude-sonnet-5,gpt-5.4,gemini-3.7-flash)를 확인합니다. - 게이트웨이 주소:
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를 확인하세요. |
보안 권장사항: 키를 공개 저장소에 올리지 마십시오. 용도별로 별도의 키를 생성하여 통계 관리 및 한도 설정에 활용하시기 바랍니다.