---
title: "Cursor 연결"
description: "Cursor에서 사용자 지정 OpenAI API 키와 Base URL을 사용하여 1折AI의 Claude 모델을 호출하는 방법과, 사용자 지정 API 키를 거치지 않는 기능에 대해 안내합니다."
headingIds: {"구성":"section-1","알려진 문제":"section-2","자주 묻는 질문":"section-3"}
---

<aside className="docs-publication" data-pagefind-ignore>

[1ZheAI](https://1zheai.com/en/editorial/#publisher)가 관리하는 문서입니다. [출처 및 수정 사항](https://1zheai.com/en/editorial/).

오류를 발견하셨나요? 페이지 주소와 설명을 첨부하여 [고객 지원](mailto:support@1zheai.com)으로 문의해 주세요. API 키나 계정 정보는 보내지 마세요.

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

<Warning>

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

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

</Warning>

## 구성

<Steps>
<Step title="모델 설정 열기">

Cursor → **Cursor Settings** → **Models**로 이동하여 Keys 영역을 찾습니다.

</Step>
<Step title="OpenAI API Key와 Base URL 입력">

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

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

</Step>
<Step title="모델 추가">

모델 목록에서 **Add model**을 클릭하고 모델 ID를 입력합니다(예: `claude-sonnet-5-5`). 그런 다음 해당 모델의 스위치를 켭니다. 모델 ID는 [지원되는 모델](/ko/docs/models/)을(를) 참조하세요.

</Step>
<Step title="채팅에서 한 번 시도">

Chat 패널에서 방금 추가한 모델을 선택하고 메시지를 보냅니다. 응답이 정상적으로 오면, 콘솔의 [호출 로그](/ko/docs/usage-logs/)에서 이 호출을 확인합니다.

</Step>
</Steps>

## 알려진 문제

<Warning>

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

참고: [포럼 게시물 144899](https://forum.cursor.com/t/anthropic-models-break-when-override-openai-baseurl-is-set/144899), [포럼 게시물 146998](https://forum.cursor.com/t/override-anthropic-base-url-automatically-switches-on-when-using-anthropic-byok/146998).

</Warning>

## 자주 묻는 질문

<AccordionGroup>
<Accordion title="Tab 자동완성이 1折AI를 사용하나요?">

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

</Accordion>
<Accordion title="Verify 클릭 시 실패?">

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

</Accordion>
<Accordion title="Agent / Composer를 사용할 수 있나요?">

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

</Accordion>
<Accordion title="편집기에서 Claude를 완전히 사용하고 싶나요?">

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

</Accordion>
</AccordionGroup>