Cursor 설정 가이드
Cursor는 코드 에디터입니다. 프로젝트 파악, 파일 설명, 코드 생성 및 수정에 적합합니다. 일반 채팅 도구에 비해 주의가 더 필요합니다. 먼저 작은 프로젝트에서 테스트하고, 중요한 프로젝트의 코드를 바로 수정하도록 맡기지 마세요.
공식 정보 다운로드 및 문서는 공식 사이트 기준을 따릅니다.
버전별 제한 사항 먼저 확인하기
Cursor의 공식 기능 지원 여부는 버전에 따라 달라집니다. 일반적으로 OpenAI, Anthropic, Google 등의 공식 API 키를 직접 입력해 사용합니다. 사용자 지정 Base URL을 입력할 수 있는지 여부는 현재 사용 중인 버전의 설정 페이지에 해당 입력 항목이 제공되는지에 따라 다릅니다.
설정 페이지에서 Override OpenAI Base URL, custom Base URL 등과 같은 항목을 찾을 수 없다면 예전 튜토리얼을 보고 억지로 입력하려 하지 마시고, 모델 이름란에 중계 사이트 주소를 넣지 마세요.
설정 단계
| 설정 항목 | 입력 방법 |
|---|---|
| 진입 경로 | Settings - Models / API Keys |
| API Key | 공식 Key 또는 중계 사이트 Key |
| Base URL | 현재 버전에서 지원하는 경우에만 입력 |
| Model | 사용 가능한 모델 선택 또는 사용자 지정 모델 추가 |
- Cursor를 실행하고 Settings로 이동합니다.
- Models, API Keys 또는 관련 섹션을 찾습니다.
- 공식 Key를 사용하는 경우, 안내에 따라 OpenAI, Anthropic, Google 등의 공식 키를 입력합니다.
- 중계 사이트를 사용하는 경우, 설정에서 사용자 지정 Base URL을 지원할 때만 중계 API 링크를 입력하세요.
- 모델을 추가한 후에는 테스트 프로젝트를 열고, 파일 수정을 요청하기 전에 먼저 Cursor에게 현재 파일을 설명하게 해보세요.
초보자 테스트 방법
Cursor에 전송해볼 수 있는 안전한 테스트 프롬프트
Read only the current file and do not modify it. Explain what it does in no more than five lines. If a change is needed, list the plan first and wait for my confirmation.| 문제 상황 | 우선 점검 사항 | 해결 방법 |
|---|---|---|
| 모델 사용 불가 | 현재 Cursor 버전에서 해당 모델을 실제로 지원하는지 확인 | 공식 지원 모델로 변경하거나, 중계 사이트에 문의하여 Cursor 호출이 가능한지 확인하세요 |
| Base URL 입력란을 찾을 수 없음 | 현재 Cursor 버전에서 해당 설정을 지원하지 않을 수 있음 | 무리하게 설정을 시도하지 말고, Continue, Cline 또는 Chatbox를 사용하여 테스트하세요 |
| 수정된 파일이 너무 많음 | 요청 범위가 너무 넓음 | 전체 프로젝트 리팩터링을 바로 요청하지 말고, 먼저 파일 설명을 요청하세요 |