Cursor

Cursor 채팅 BYOK, 조건부 게이트웨이 URL 재정의와 기능 제한을 설정합니다.

설치, 구성 및 테스트

1. https://cursor.com/download 에서 OS에 맞는 데스크톱 설치 프로그램을 받아 Cursor를 설치하고 프로젝트를 엽니다. 여기서는 편집기의 제공업체 API 키를 사용하며 Cursor CLI 계정 토큰은 사용하지 않습니다.

2. routerra.ai 콘솔 (https://routerra.ai/keys)에서 대상 모델 권한이 있는 API 키를 만들고 정확한 모델 ID를 복사합니다. Cursor Settings → Models의 OpenAI API Key에 YOUR_API_KEY를 입력하고 Save(구버전은 Verify)를 누릅니다. 키만 입력하면 게이트웨이로 요청이 전환되지 않습니다.

3. 설치 버전에 Override OpenAI Base URL이 있을 때만 활성화하여 https://routerra.ai/v1 을 입력합니다. 기본 URL이므로 /chat/completions를 붙이지 않습니다. 별도 키 스위치가 있으면 켭니다. 사용자 모델 추가 기능이 있다면 YOUR_MODEL_ID를 등록하고 새 채팅에서 Auto 대신 해당 모델을 직접 선택합니다. 주소 변경 후 Cursor를 다시 시작합니다.

4. 짧은 질문을 보내 게이트웨이 요청 로그를 확인합니다. 공식 BYOK 범위는 채팅 모델이며 OpenAI 통합에는 표준 비추론 채팅 모델이 명시되어 있습니다. Tab 자동 완성은 내장 모델을 사용합니다. 모든 Agent 기능이나 임의 모델의 작동을 가정하지 마세요.

URL 재정의가 없다면 이 안내에는 해당 버전의 공식 게이트웨이 설정법이 없습니다. 키 영역이 숨겨지면 관리자에게 개인 API 키 정책을 확인하세요. 모델이 거부되면 정확한 ID와 OpenAI 키 칸을 확인하고 게이트웨이가 제공하는 별칭만 사용하세요.