How to Add a Custom API Key to Cursor (2026 Guide)

Cursor는 평면적인 월간 요금제(flat monthly plan)로 번들 모델 접근을 제공하며, 대부분의 사람들에게 이것이 올바른 기본값입니다. 하지만 두 그룹은 자신들의 키를 연결하는 방법을 계속해서 문의합니다: 이미 OpenAI와 호환되는 API 크레딧을 보유하여 사용하고 싶어 하는 개발자들과, 포함된 사용량을 모두 소진하여 더 이상 추가 구매하기를 원하지 않는 헤비 유저들입니다.

Cursor는 이 두 가지 질문에 단 하나의 설정 — Override OpenAI Base URL — 로 답합니다. 이는 에디터를 Cursor 자체 백엔드 대신 모든 OpenAI와 호환되는 엔드포인트로 연결해 줍니다. 이 토글을 켜면, 사용자는 제공업체에게 토큰당 비용을 지불하고, 원하는 모델을 선택하며, 더 이상 구독 할당량에 묶이지 않습니다.

이 가이드에서는 전체 설정 과정을 안내합니다: 필요한 것들, 정확한 단계, 추가해야 할 모델 ID, 평면 요금제와의 비용 비교, 그리고 사람들이 실제로 부딪히는 문제점들까지 다룹니다.

Cursor 사용자 지정 API 키 한 단락으로 정리: Cursor Settings → Models로 이동하여, OpenAI API Key 필드에 키를 붙여넣고, Override OpenAI Base URL을 활성화한 다음, https://tokenpapa.ai/v1과 같은 OpenAI와 호환되는 엔드포인트로 설정합니다. 원하는 모델 ID(예: deepseek-v4-flash)를 추가하고, Verify를 클릭하면 Cursor가 해당 엔드포인트로 채팅 요청을 라우팅하며 — 이는 Cursor가 아닌 사용자의 제공업체에 의해 토큰당 청구됩니다.

시작하기 전에 필요한 것들

단계별 가이드: 사용자 지정 API 키 및 기본 URL 추가하기

1단계 — API 키 받기

TokenPAPA를 사용하려면 이메일 주소 또는 Google/GitHub 원클릭 로그인을 통해 tokenpapa.ai에 가입한 다음, API keys 페이지에서 키를 생성하세요. 중국 전화번호나 현지 결제 수단은 필요하지 않습니다. 이 키는 비밀번호처럼 취급하여 안전한 곳에 보관하십시오.

2단계 — Cursor 설정 열기

명령 팔레트를 열거나 설정 단축키(Windows/Linux의 Ctrl+Shift+J, macOS의 Cmd+Shift+J)를 누른 다음, Models 탭을 선택합니다. 이 패널에는 Cursor 자체 모델 목록과 사용자가 직접 키를 입력하는 필드가 모두 포함되어 있습니다.

3단계 — 키 붙여넣기

OpenAI API Key 필드를 찾아 키를 붙여넣습니다. Cursor는 OpenAI와 호환되는 타사 키들을 이 하나의 필드 아래에 그룹화하므로, DeepSeek, Qwen 또는 Kimi 같은 애그리게이터(aggregator)의 키도 정확히 동일한 상자에 넣으면 됩니다.

4단계 — "OpenAI Base URL 재정의" 활성화하기

Override OpenAI Base URL을 켜고 엔드포인트를 입력합니다:

/v1 접미사는 중요합니다. Cursor는 사용자가 입력한 내용에 /chat/completions를 추가하므로, 이미 API 버전을 포함하는 기본 URL이 올바르며, 이를 생략하면 404 오류가 발생할 수 있습니다.

키 옆의 Verify를 클릭합니다. 녹색 확인 표시는 엔드포인트가 올바르게 인증되었음을 의미하며, 빨간색은 거의 항상 잘못된 키, 누락된 /v1, 또는 잘못된 호스트를 가리키는 기본 URL을 의미합니다.

5단계 — 원하는 모델 ID 추가하기

Cursor는 사용자가 제공하는 공급업체의 카탈로그를 추측하지 못합니다. Add model을 사용하여 엔드포인트가 노출하는 정확한 식별자(identifier)들을 입력하세요. TokenPAPA의 실제 ID에는 다음이 포함됩니다:

• deepseek-v4-flash — 저렴하고 빠른 기본 모델
• deepseek-v4-pro — 더 강력한 DeepSeek 등급
• qwen3.7-plus — 코딩 및 구조화된 출력용
• kimi-k3 — 긴 컨텍스트 작업용
• gpt-5.6-luna — 저비용 OpenAI 계열 옵션

그런 다음 비용을 지불하고 싶지 않은 모델은 비활성화하고, 채팅 모델 선택기에서 새로 추가한 모델들을 선택합니다.

6단계 — 테스트하기

Cursor 채팅창에 한 줄 프롬프트를 보내 응답이 돌아오는 것을 확인하세요. 편집기 외부에서 엔드포인트를 먼저 테스트하고 싶다면, curl이나 Python으로 동일한 요청을 보내 키 문제인지 편집기 문제인지를 분리할 수 있습니다:

from openai import OpenAI

client = OpenAI(
...

만약 이것이 문장을 출력하는데 Cursor가 그렇지 않다면, 키와 엔드포인트는 정상이며 문제는 Cursor의 설정(보통 기본 URL 또는 모델 ID) 내부에 있습니다.

어떤 모델을 추가해야 하나요?

Cursor에서 모델 선택은 대부분의 앱보다 중요합니다. 왜냐하면 편집기는 요청마다 많은 컨텍스트를 보내기 때문입니다. 일상적인 수정에는 128K 창 크기에 낮은 토큰당 가격을 가진 모델이 가장 적합하며, 더 강력한 모델은 어려운 추론 작업에 사용해야 합니다.

핵심 통찰: 편집기에게는 _컨텍스트 창 ÷ 가격_이 월별 청구액을 결정하는 수치이지, 순수한 벤치마크 점수가 아닙니다. $0.14의 입력 토큰당 비용으로 128K 모델은 프롬프트에 모듈 절반을 붙여넣어도 약 5분의 1센트만 지불하게 합니다.

실용적인 패턴은 두 가지 모델을 추가하는 것입니다: 일상적인 구동 엔진으로는 deepseek-v4-flash를, flash로는 충분하지 않은 요청에는 deepseek-v4-pro를 사용합니다. 이들 사이를 전환하는 것은 재설정이 아니라 드롭다운 변경이며, 둘 다 동일한 키와 동일한 기본 URL을 거칩니다.

사용자 지정 API 키 vs Cursor Pro: 어느 것이 더 저렴할까요?

Cursor의 번들 플랜은 정액제입니다. 고정된 월별 요금(작성 시점 기준 Pro 티어는 약 $20/월 — 현재 가격은 cursor.com에서 확인하세요)을 지불하며 Cursor가 모델 접근, 할당량 및 청구 관리를 대신 해줍니다. 사용자 지정 키는 이와 반대입니다: 고정 요금은 없지만, 제공업체에 토큰당 비용을 지불하고 사용 한도는 본인의 지출액이 됩니다.

교차점은 실제로 얼마나 많은 데이터를 전송하느냐에 달려 있습니다. 동일한 워크로드를 두 가지 방식으로 모델링해 보세요:

사용자 지정 API 키가 Cursor Pro보다 저렴할까요?: 자동으로 그렇지는 않습니다. 가볍고 간헐적인 사용에는 고정 요금제가 유리합니다. 사용자 지정 키는 월별 토큰 볼륨이 충분히 높아져 저가 모델의 토큰당 비용이 구독료보다 낮아질 때 이기게 되는데, DeepSeek V4 Flash와 같은 저비용 모델에서는 놀라울 정도로 일찍 발생할 수 있습니다.

솔직한 추천은 다음과 같습니다. Cursor를 매일 사용하고 청구서 오버헤드를 0으로 유지하고 싶다면 번들 플랜을 유지하고, API 크레딧을 사용할 것이거나, Cursor가 나열하지 않은 모델에 접근하거나, 사용량이 할당량을 초과했다면 기본 URL을 자체 키로 전환하세요.

TokenPAPA를 Cursor의 사용자 지정 엔드포인트로 사용하는 이유?

Cursor의 사용자 지정 기본 URL은 모든 OpenAI 호환 호스트에서 작동합니다. TokenPAPA는 특정한 이유 때문에 합리적인 선택입니다. 바로 여러 모델 패밀리를 하나의 키와 하나의 기본 URL 뒤에 통합하여, 같은 편집기 내에서 DeepSeek 키, Qwen 키, Kimi 키를 번거롭게 관리할 필요가 없기 때문입니다.

일반적인 문제 및 해결 방법

FAQ

Cursor에 자체 API 키를 사용할 수 있나요?

예. Cursor는 OpenAI와 호환되는 제공업체의 자체 키를 가져오는 것을 지원합니다. Cursor 설정으로 이동하여 Models 탭에서 OpenAI API Key 필드에 키를 붙여넣고 Override OpenAI Base URL을 활성화하세요.

Cursor에서 사용자 지정 OpenAI base URL을 설정하려면 어떻게 해야 하나요?

Cursor 설정의 Models 탭에서 Override OpenAI Base URL을 활성화하고, https://tokenpapa.ai/v1로 설정합니다. 그런 다음 deepseek-v4-flash와 같은 원하는 모델 ID를 추가하고, 엔드포인트가 응답하는지 확인하기 위해 Verify를 클릭하세요.

사용자 지정 API 키가 Cursor Pro 플랜보다 저렴한가요?

사용량에 따라 다릅니다. 가벼운 사용에는 고정 구독이 더 저렴합니다. 월간 사용량이 몇 백만 토큰을 초과하면, DeepSeek V4 Flash와 같은 저비용 모델에 대한 종량제 액세스(1M 입력 토큰당 $0.14)가 고정 월간 플랜보다 훨씬 적게 나올 수 있습니다.

Cursor에서 어떤 모델 ID를 추가해야 하나요?

엔드포인트가 이름으로 노출하는 모든 OpenAI 호환 모델 ID입니다. TokenPAPA에서는 deepseek-v4-flash, deepseek-v4-pro, qwen3.7-plus, kimi-k3 및 gpt-5.6-luna를 포함하며, 이 모든 모델에 하나의 키와 하나의 기본 URL을 통해 접근할 수 있습니다.

시작하기

1. tokenpapa.ai/register에서 가입하세요 — 이메일, Google 또는 GitHub 사용, 중국 전화번호 불가.
2. API 키 페이지에서 키를 생성하고 충전하세요 (최소 $10, 국제 카드 및 지갑 필요).
3. Cursor에 연결하기: Cursor 설정 → 모델(Models) → 키 붙여넣기 → OpenAI 기본 URL 재정의(Override OpenAI Base URL) 활성화 → https://tokenpapa.ai/v1 입력 → deepseek-v4-flash 추가 → 확인(Verify).

from openai import OpenAI

client = OpenAI(
...

기본 모델을 선택하기 전에 모델들을 비교하고 싶으신가요? 현재 100만 토큰당 요율은 가격 페이지를 참조하시고, 코딩 작업에 대한 DeepSeek V4 대 GPT-5.6의 전격 비교는 DeepSeek V4 vs GPT-5.6를 참고하세요.

표시된 모델 가격은 2026-10-09 기준 TokenPAPA 플랫폼 요율이며 변경될 수 있습니다. 현재 요율은 tokenpapa.ai/pricing에서 확인하십시오. Cursor의 UI 및 플랜 가격은 Cursor가 설정하며 버전 간에 변경될 수 있습니다.

원래 게시일: [https://doc.tokenpapa.ai/en/docs/blog/cursor-custom-api-key-setup].