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

Cursor에서 OpenAI 모델 사용하기

본인의 API 키, Codex IDE 확장 프로그램 또는 AI 게이트웨이 제공업체를 통해 Cursor에서 OpenAI 모델을 사용하는 방법을 알아보세요.

마지막 수정: 7 days ago

OpenAI는 Cursor에 OpenAI 모델을 제공하는 계약을 종료할 계획입니다. 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는 Cursor Tab, Auto, 클라우드 또는 백그라운드 에이전트, 자동화, Cursor CLI, Cursor API 및 SDK에서 “자체 API 키 사용”을 지원하지 않습니다. 이 기능들은 Cursor가 제공하거나 라우팅하는 모델을 사용하므로, 사용자의 OpenAI API 키나 게이트웨이 인증 정보를 사용할 수 없습니다.

자체 OpenAI API 키 사용하기

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

키를 설정하려면 다음 단계를 따르세요.

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

  2. Cursor 설정을 열고 모델을 선택합니다.

  3. OpenAI API 키 설정을 찾아 키를 붙여넣고 저장하거나 검증합니다.

  4. 사용하려는 OpenAI 모델을 활성화합니다.

  5. Cursor 채팅 또는 에이전트에서 해당 모델을 선택합니다.

사용 가능한 모델과 사용량 한도는 소속 OpenAI API 조직에 따라 다릅니다.

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

  • 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. 위에 링크된 Codex IDE 확장 프로그램 페이지를 열고 Cursor를 선택하여 확장 프로그램을 설치합니다.

  2. 작업 표시줄에서 Codex를 엽니다.

  3. 지원되는 ChatGPT 구독을 사용하려면 ChatGPT로 로그인을 선택하고, OpenAI API 계정을 사용하려면 API 키 사용을 선택합니다.

  4. 프로젝트를 열고 Codex 패널에서 작업을 시작합니다.

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

Codex 확장 프로그램은 Cursor 안에서 독자적인 에이전트 기능을 제공합니다. Cursor 채팅, 에이전트, 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. 로컬 채팅 또는 에이전트 세션에서 모델을 테스트합니다.

Amazon Bedrock에 대해서는 Amazon Bedrock에서 OpenAI 모델 사용하기를 참조하세요.

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

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