1. Cursor란 무엇인가
Cursor는 VS Code를 기반으로 구축된 AI 네이티브 코드 편집기로, AI 대화(Chat), 코드 생성(Composer/Chat) 및 스마트 코드 완성 기능이 깊게 통합되어 있습니다. BYOK(Bring Your Own Key)를 지원하므로, 공식 구독을 구매하고 싶지 않거나 특정 모델로 통합하여 사용하려는 경우 개인 API Key를 사용하여 자체 모델 엔드포인트에 연결할 수 있습니다.
중계 서버를 연결하면 Cursor 공식 구독을 구매하지 않고도, 사이트 내 sk- 키를 통해 토큰 종량제로 Claude / GPT / Gemini 모델을 사용할 수 있습니다.
2. 준비 사항
- 지즈(极智) API 콘솔에 로그인하여 'API 키' 메뉴에서 전용
sk-xxxxxx키를 생성합니다. - '모델 가격(模型定价)'에서 사용할 모델 slug(예:
claude-sonnet-5,gpt-5.4,gemini-3.7-flash)를 확인합니다. - 게이트웨이 주소:
https://www.relay-api.com을 확인합니다.
3. Cursor 설정 방법
Cursor → Settings → Models → API Keys를 엽니다(설정에서 Models를 직접 검색해도 됩니다).
- 사용할 모델 공급자를 선택합니다(OpenAI는 Open AI 항목, Claude는 Anthropic 항목, Gemini는 Google Gemini 항목).
- API Key를 입력합니다:
sk-본인의키. - Override Base URL을 입력합니다: 선택한 공급자에 맞는 게이트웨이 주소를 입력하세요.
- Claude / Anthropic:
https://www.relay-api.com - GPT / OpenAI:
https://www.relay-api.com/v1 - Gemini:
https://www.relay-api.com/v1beta
- Claude / Anthropic:
- Models 목록에 사용할 정확한 모델 ID를 추가합니다(모델 마켓에서 slug를 복사하세요. 표시 이름이 아닌 ID를 입력해야 합니다).
- Verify를 클릭하여 연결을 확인합니다. 그 후 일반 채팅창에 짧은 텍스트를 입력하여 정상적으로 응답이 오는지 테스트합니다.
4. 검수 및 문제 해결
| 현상 | 조치 방법 |
|---|---|
| 401 / 403 | 키가 유효하지 않거나, 활성화되지 않았거나, 잔액이 부족한 경우입니다. sk- 키가 정확한지 확인하고 충전하세요. |
| 404 / 모델을 사용할 수 없음 | 모델 slug가 플랫폼과 일치하지 않거나 해당 모델이 활성화되지 않은 상태입니다. 모델 ID를 다시 확인하세요. |
| Verify는 통과했지만 Agent가 작동하지 않음 | /chat/completions 프로토콜 차이로 인해 발생할 수 있습니다. 일반 채팅으로 기본 연결을 먼저 확인하세요. |
| Tab 자동 완성이 작동하지 않음 | Tab Completion 등 전용 기능은 Cursor 내장 모델을 사용합니다. 이는 제품의 설계 영역으로 Base URL 설정과는 무관합니다. |
보안 권장 사항: API 키를 공개 저장소에 올리지 마세요. 프로젝트별로 별도의 키를 생성하는 것을 권장하며, 잔액과 사용 내역을 수시로 확인하시기 바랍니다.