Cursor 설치 및 API 설정
Cursor를 설치하고 BetterToken Base URL과 API Key를 설정한 뒤 호환 제공자 모델을 선택하고 일반적인 오류를 해결하세요.
Cursor를 BetterToken에 연결하려면 API Key를 준비하고 아래 Base URL을 입력한 뒤 모델 광장에서 현재 Model ID를 선택하세요.
주요 설정
| 필드 | 값 |
|---|---|
| API Key | BetterToken API Key |
| Base URL | https://bettertoken.ai/v1 |
| Model | 모델 광장의 현재 Model ID |
준비 사항
이미 계정이 있나요? 로그인하고 잔액을 충전한 다음 콘솔에서 키를 만드세요.
추가 요구 사항
- Cursor 설치 (Cursor 다운로드)
설치하기
Cursor 웹사이트에서 최신 버전을 다운로드해 설치하세요. 사용자 지정 모델을 지원하는 Cursor 계정으로 로그인한 뒤 아래 단계를 진행하세요.
Cursor의 BYOK 규칙은 OpenAI BYOK를 표준 비추론 채팅 모델로 제한합니다. Tab 완성은 계속 Cursor 내장 모델을 사용합니다. 프롬프트 구성을 위해 요청이 Cursor 백엔드를 거치며, API Key는 각 요청과 함께 전송되고 요청 완료 후 보관되지 않습니다. BYOK 데이터 처리에는 Cursor의 Zero Data Retention 정책 대신 선택한 provider의 정책이 적용됩니다.
Teams와 Enterprise 요금제에서는 해당 BYOK 요청도 Cursor Token Rate에 따라 Cursor 사용량에 반영되며 모델 provider가 모델 비용을 별도로 청구합니다. 팀 크레딧, 온디맨드 사용량, 지출 한도를 확인하세요. 허용량을 모두 사용하면 요청이 중단될 수 있습니다. 개인 요금제는 사용량 규칙이 다르므로 요금제 안내를 참고하세요.
수동 설정
Cursor 설정 UI에서 다음 설정을 완료하세요. 설정 파일을 수정할 필요는 없습니다.
| Cursor 필드 | 값 |
|---|---|
| Override OpenAI Base URL | 켜기 |
| Base URL | https://bettertoken.ai/v1 |
| OpenAI API Key | BetterToken API Key 입력 |
| 사용자 지정 모델 | 지원 제공자의 전체 Model ID |
설정 절차
모델 설정 페이지 열기
Cursor 왼쪽 아래에서 Settings를 클릭한 뒤 Models로 이동하세요. API Keys까지 아래로 스크롤하세요.
Base URL과 API Key 입력
API Keys에서 다음 순서로 필드를 설정하세요.
- Override OpenAI Base URL을 활성화합니다.
- Base URL 필드에
https://bettertoken.ai/v1을 입력합니다. - BetterToken API Key를 OpenAI API Key에 붙여 넣습니다.
- URL과 Key를 입력한 뒤 OpenAI API Key 토글을 활성화합니다.
토글을 켜기 전에 Key를 입력하세요. 그러면 Cursor에 인증 확인 대화 상자가 표시됩니다.
OpenAI API Key 활성화
확인 대화 상자에서 Enable OpenAI API Key를 클릭하세요.
모델 목록 새로 고침 및 모델 활성화
Models로 돌아가 모델을 선택하기 전에 오른쪽의 새로 고침 버튼을 클릭하세요. 모델 목록의 새로 고침이 끝날 때까지 기다리세요.
설정한 엔드포인트가 지원하는 제공자의 모델만 선택하세요. BetterToken API Key를 사용할 때는 모델 광장의 지원 제공자에서 Model ID를 선택한 뒤 해당 모델의 토글을 켜세요.
채팅으로 돌아가 Auto 끄기
설정 후 Cursor 채팅 화면으로 돌아가 입력창 아래의 모델 선택기를 여세요. Auto가 활성화되어 있으면 먼저 Auto를 끄세요.
모델 선택 후 채팅 시작
활성화한 지원 제공자의 모델을 선택한 뒤 채팅을 시작하세요.
연결 확인
짧은 테스트 프롬프트를 보내세요. 인증 또는 Model ID 오류 없이 응답이 오면 연결이 완료된 것입니다. 설정을 변경한 뒤에는 도구를 완전히 다시 시작하세요.
Cursor CLI 제한
공식 Cursor CLI(cursor-agent)는 Cursor 계정 인증을 사용합니다. CURSOR_API_KEY는 Cursor Key이며 BetterToken API Key가 아닙니다. --endpoint 옵션은 Cursor 서비스 주소를 지정합니다. 공식 인증 및 매개변수 문서에는 OpenAI 호환 Base URL이 설명되어 있지 않습니다. 이 페이지의 데스크톱 BYOK 설정은 Cursor CLI에 적용되지 않습니다.
모델 전환
모델 선택기를 열거나 설정의 Model 필드를 변경하세요. 모델 광장의 정확한 Model ID를 사용한 뒤 현재 세션을 다시 시작하세요.
흔한 오류
사용자 지정 API 및 API Key 오류
모델이나 Key를 변경하기 전에 Cursor 사용자 지정 OpenAI API 설정과 현재 설정을 비교하세요.
Cursor에 Custom API, API Key 또는 Base URL 필드가 표시되지 않음
Cursor 요금제와 클라이언트 버전을 확인하세요. 사용자 지정 모델은 지원되는 유료 등급에서만 사용할 수 있습니다. Cursor를 업데이트한 뒤 Settings → Models를 다시 여세요.
API Key를 활성화하거나 확인할 수 없음
Base URL https://bettertoken.ai/v1과 API Key를 입력한 뒤 OpenAI API Key 토글을 켜세요. Base URL에 /chat/completions를 추가하지 마세요.
새로 고침 후 모델이 표시되지 않음
선택한 Model ID가 지원 제공자의 것인지 확인하고 새로 고침이 끝날 때까지 기다린 뒤 해당 제공자의 모델만 활성화하세요. 모델 광장에는 항상 현재 ID가 표시됩니다.
Cursor 내장 모델이 작동하지 않음
Override OpenAI Base URL은 전역 설정입니다. BetterToken을 사용하지 않을 때 이 토글을 끄면 Cursor가 자체 Base URL을 다시 사용할 수 있습니다.
채팅에서 다른 모델이 선택됨
모델 선택기를 열고 Auto를 끈 뒤 활성화한 모델을 직접 선택하세요.
관련 FAQ
기술 세부 정보
프로토콜, 엔드포인트, 내부 제공자 필드
이 설정은 https://bettertoken.ai/v1을 사용합니다. 도구가 OpenAI 호환 엔드포인트 경로를 추가합니다. 특정 필드에서 명시적으로 요구하지 않는 한 /chat/completions 또는 /responses를 추가하지 마세요.
참고
- 모델 광장에서 정확한 Model ID를 복사하세요.
