OpenAI
이 페이지는 기계 번역되었습니다. 영어 원문 보기

Cursor에서 OpenAI 모델 사용하기

마지막 수정: 10 days ago

OpenAI는 Cursor에 OpenAI 모델을 제공하는 계약을 종료할 계획입니다. 저희는 2026년 11월 12일까지를 전환 기간으로 제안했습니다. 이 기간에는 Cursor가 현재 사용 중인 OpenAI 모델에 계속 액세스할 수 있도록 지원할 예정입니다. Cursor는 이보다 일찍 액세스를 종료할 수도 있습니다. 공식 종료일은 양사 간에 확정되는 대로 안내하겠습니다.

Cursor 앱에서 OpenAI 모델을 계속 사용하려면 작업 방식에 가장 적합한 옵션을 선택하세요.

  • 본인의 OpenAI API 키 사용 — Cursor의 로컬 Chat 및 에이전트 기능에서 OpenAI 모델을 계속 사용할 수 있으며, OpenAI API 요금이 적용됩니다.

  • Codex IDE 확장 프로그램 사용 — ChatGPT 구독 또는 OpenAI API 키로 Cursor 내에서 Codex를 바로 사용할 수 있습니다.

  • AI 게이트웨이 제공업체 이용 — Amazon Bedrock, Azure 또는 기타 OpenAI 호환 게이트웨이 등 호환되는 제공업체의 계정을 통해 Cursor를 OpenAI 모델에 연결할 수 있습니다.

다음은 전반적인 방향을 제시하는 안내이며, Cursor는 향후 이러한 기능의 작동 방식과 제공 여부를 변경할 수 있습니다. 최신 정보는 Cursor 공식 문서를 참고하세요. 

이 옵션들은 Cursor 데스크톱 앱의 로컬 작업에 사용할 수 있습니다. Cursor Tab, Auto, 클라우드 또는 백그라운드 에이전트, 자동화, Cursor CLI, Cursor API 및 SDK에서는 ‘본인의 키 사용’이 지원되지 않습니다. 이 기능들은 Cursor가 제공하거나 라우팅하는 모델을 사용하므로, 본인의 OpenAI API 키나 게이트웨이 인증 정보를 사용할 수 없습니다.

본인의 OpenAI API 키 사용

Cursor의 로컬 Chat 및 에이전트 기능에서는 본인의 OpenAI API 키로 OpenAI 모델을 사용할 수 있습니다. 요청은 본인의 OpenAI API 계정을 통해 전송되며, 사용 요금은 Cursor 또는 ChatGPT 구독과 별도로 청구됩니다.

키 설정 방법:

  1. OpenAI API 키를 생성하세요. API에 액세스하려면 결제 설정이 완료된 OpenAI API 계정이 필요합니다.

  2. Cursor 설정을 열고 모델을 선택하세요.

  3. OpenAI API 키 설정을 찾아 키를 붙여넣고 저장하거나 확인하세요.

  4. 사용하려는 OpenAI 모델을 활성화하세요.

  5. Cursor의 Chat 또는 에이전트에서 해당 모델을 선택하세요.

사용 가능한 모델과 사용량 한도는 본인의 OpenAI API 조직에 따라 달라집니다.

본인의 OpenAI API 키는 지원되는 로컬 Chat 및 에이전트 요청에만 적용됩니다. 다음에는 적용되지 않습니다.

  • Cursor Tab 및 자동 완성

  • Auto 모델 선택 및 라우팅

  • 클라우드 또는 백그라운드 에이전트

  • 자동화

  • Cursor CLI

  • Cursor API 또는 SDK

  • Cursor가 제공하는 모델 또는 자체 모델

ChatGPT 구독에는 OpenAI API 사용이 포함되지 않습니다. API 키를 사용하면 사용 요금이 본인의 OpenAI API 계정으로 청구됩니다.

Cursor에서 Codex IDE 확장 프로그램 사용

Codex IDE 확장 프로그램을 사용하면 Cursor 내에서 Codex 에이전트를 바로 이용할 수 있습니다. 별도의 확장 프로그램으로 실행되므로, Cursor 자체 모델 선택기에 OpenAI 모델이 제공되는지와 관계없이 사용할 수 있습니다.

시작 방법:

  1. Cursor에 Codex IDE 확장 프로그램을 설치하세요. 여기를 클릭하세요 (cursor:extension/openai.chatgpt)

  2. 활동 표시줄에서 Codex를 여세요.

  3. 이용 가능한 ChatGPT 구독을 사용하려면 ChatGPT로 로그인을 선택하고, OpenAI API 계정을 사용하려면 API 키 사용을 선택하세요.

  4. 프로젝트를 열고 Codex 패널에서 작업을 시작하세요.

Cursor의 레이아웃 설정을 사용해 Codex 패널을 편집기 오른쪽으로 옮길 수 있습니다. 보기 → 모양 메뉴에서 보조 사이드바를 활성화한 다음, Codex 뷰를 해당 사이드바로 드래그하세요.

Codex 확장 프로그램은 Cursor 내에서 독립적인 에이전트 환경을 제공합니다. Cursor의 Chat, 에이전트, Tab, Auto, 클라우드 에이전트 또는 기타 Cursor 서비스에서 사용하는 모델은 변경하지 않습니다. 사용 가능한 로그인 방법은 Codex 인증 문서를 참고하세요.

AI 게이트웨이 제공업체 이용

호환되는 AI 게이트웨이나 호스팅 제공업체를 통해 Cursor를 OpenAI 모델에 연결할 수도 있습니다. 조직에서 이미 Amazon Bedrock, Azure 또는 다른 게이트웨이를 통해 모델 액세스와 결제를 관리하고 있다면 이 방법이 유용할 수 있습니다.

Cursor는 제공업체별 설정이나 OpenAI와 호환되는 사용자 지정 기본 URL을 통해 연결할 수 있습니다. OpenRouter나 Vercel AI Gateway 같은 서비스도 호환되는 API로 설정하면 작동할 수 있지만, 사용 가능한 모델과 기능은 제공업체에 따라 다릅니다.

세부 설정은 다르지만, 일반적인 설정 절차는 다음과 같습니다.

  1. 이용 중인 제공업체에서 OpenAI 모델을 프로비저닝하세요.

  2. 필요한 인증 정보, 엔드포인트, 모델 또는 배포 이름을 생성하세요.

  3. Cursor 설정을 열고 모델을 선택하세요.

  4. 제공업체 연동을 선택하거나, 게이트웨이의 사용자 지정 기본 URL로 OpenAI API 설정을 구성하세요.

  5. 제공업체에서 받은 엔드포인트와 인증 정보를 입력하세요.

  6. Cursor에서 해당 모델을 추가하거나 활성화하세요.

  7. 로컬 Chat 또는 에이전트 세션에서 모델을 테스트하세요.

Amazon Bedrock을 이용하는 경우 Amazon Bedrock에서 OpenAI 모델 사용하기를 참고하세요.

게이트웨이마다 호환성이 다릅니다. 사용자 지정 엔드포인트는 Cursor가 요구하는 API 형식을 지원해야 합니다. 일부 모델별 제어 옵션은 사용할 수 없거나 사용자 지정 기본 URL을 통해 전달되지 않을 수 있습니다. 게이트웨이 인증 정보 역시 지원되는 로컬 Chat 및 에이전트 요청에만 사용할 수 있습니다. Cursor Tab, Auto, 클라우드 또는 백그라운드 에이전트, 자동화, Cursor CLI, Cursor API 및 SDK에는 적용되지 않습니다.

이 문서가 도움이 되었나요?