Cursor 연결

Cursor에서 사용자 지정 OpenAI API 키와 Base URL을 사용하여 1折AI의 Claude 모델을 호출하는 방법과, 사용자 지정 API 키를 거치지 않는 기능에 대해 안내합니다.

Cursor는 설정에서 직접 API 키(API key)를 입력할 수 있으며, 채팅 모델은 이 API 키로 요청을 보냅니다. 아래는 1折AI를 연결하는 방법과, 시작 전에 반드시 알아야 할 몇 가지 제한 사항입니다.

작업을 시작하기 전에 다음 세 가지를 먼저 확인하세요:

Cursor 공식 문서에 따르면, 사용자 지정 API 키는 채팅 모델에만 적용되며, Tab 자동완성은 항상 Cursor 자체 모델을 사용합니다.
요청은 Cursor 서버를 거쳐 입력한 주소로 전달되므로, Base URL은 공개적으로 접근 가능해야 합니다(https://1zheai.com/v1은 문제없지만, 로컬 localhost 프록시는 불가합니다).
“Override OpenAI Base URL” 스위치는 Cursor 공식 문서에 없으며, 아래 인터페이스 설명은 Cursor 포럼과 커뮤니티 튜토리얼에서 가져온 것으로, Cursor 개편 시 변경될 수 있습니다.

구성

모델 설정 열기
Cursor → Cursor Settings → Models로 이동하여 Keys 영역을 찾습니다.

OpenAI API Key와 Base URL 입력

1
OpenAI API Key              sk-你的Key（1折AI 的 Key）
2
Override OpenAI Base URL    https://1zheai.com/v1

Base URL에는 /v1을(를) 포함해야 합니다.

모델 추가
모델 목록에서 Add model을 클릭하고 모델 ID를 입력합니다(예: claude-sonnet-5-5). 그런 다음 해당 모델의 스위치를 켭니다. 모델 ID는 지원되는 모델을(를) 참조하세요.
채팅에서 한 번 시도
Chat 패널에서 방금 추가한 모델을 선택하고 메시지를 보냅니다. 응답이 정상적으로 오면, 콘솔의 호출 로그에서 이 호출을 확인합니다.

알려진 문제

Cursor 포럼에 다음과 같은 피드백이 있습니다: Override OpenAI Base URL을 설정한 후, 이름이 claude-으로 시작하는 모델은 Cursor가 Anthropic 모델로 인식하여 Anthropic API 키로 처리하거나, 바로 오류를 반환할 수 있습니다. Claude를 선택할 때 모델 ID는 claude-로 시작하며, 이 문제가 발생하면 Cursor에 입력된 Anthropic API 키를 먼저 비운 후 다시 시도하세요.

참고: 포럼 게시물 144899, 포럼 게시물 146998.

자주 묻는 질문

Tab 자동완성이 1折AI를 사용하나요?

아니요. Cursor 공식 문서에 따르면, Tab 자동완성은 항상 Cursor 기본 모델을 사용하며, 사용자의 API 키를 거치지 않습니다.

Verify 클릭 시 실패?

먼저 Base URL에 /v1이(가) 포함되어 있는지 확인하세요. 커뮤니티 피드백에 따르면 Verify 버튼은 OpenAI가 아닌 모델 이름에 대해 통과하지 못할 수 있으므로, Chat에서 메시지를 직접 보내 테스트하고 호출 로그에 기록이 있는지로 판단하세요.

Agent / Composer를 사용할 수 있나요?

커뮤니티 튜토리얼의 일반적인 피드백은 Chat만 사용자 지정 API 키를 거치며, Agent, Apply, Inline Edit 등의 기능은 여전히 Cursor 자체 백엔드를 거칠 수 있다는 것입니다. 실제 호출 로그에 기록된 내용을 기준으로 판단하세요.

편집기에서 Claude를 완전히 사용하고 싶나요?

주로 Claude로 코드를 작성하고 싶다면, Claude Code(명령줄 또는 VS Code 플러그인)과 Cline이(가) 사용자 지정 주소에 대한 지원이 더 완벽합니다.