Cursor에 커스텀 API Keys를 추가하는 방법: 완벽 가이드 (2026)
Cursor에서 본인의 OpenAI, Anthropic 및 Google API 키를 사용하세요.
Hypereal로 구축 시작하기
단일 API를 통해 Kling, Flux, Sora, Veo 등에 액세스하세요. 무료 크레딧으로 시작하고 수백만으로 확장하세요.
신용카드 불필요 • 10만 명 이상의 개발자 • 엔터프라이즈 지원
Cursor에 커스텀 API 키를 추가하는 방법: 전체 가이드 (2026)
Cursor는 가장 인기 있는 AI 기반 코드 에디터 중 하나이지만, 내장된 AI 사용량에는 월간 제한이 있습니다. 본인의 API 키를 직접 추가하면 이러한 제한을 우회하고, 원하는 모델을 선택하며, 비용을 직접 제어할 수 있습니다. 이 가이드에서는 OpenAI, Anthropic, Google 및 기타 제공업체의 API 키를 Cursor에 추가하는 방법을 단계별로 안내합니다.
왜 커스텀 API 키를 추가해야 하나요?
Cursor에 본인의 API 키를 가져와야 하는 몇 가지 이유는 다음과 같습니다.
| 혜택 | 기본 Cursor | 커스텀 API 키 |
|---|---|---|
| 월간 고속 요청 | 50회(Free) / 500회(Pro) | 무제한 (토큰당 과금) |
| 모델 선택 | Cursor 제공 모델만 가능 | 제공업체의 모든 모델 사용 가능 |
| 비용 제어 | 고정 구독료 | 사용한 만큼만 지불 |
| 속도 제한 (Rate limits) | 모든 사용자와 공유 | 본인 전용 API 속도 제한 |
| 개인정보 보호 | Cursor가 요청을 처리 | 제공업체로 직접 전송 |
이미 OpenAI, Anthropic 또는 Google의 API 크레딧을 보유하고 있다면, Cursor에서 이를 사용하여 Cursor Pro 구독 없이도 AI 기능을 이용할 수 있습니다.
1단계: Cursor 설정 열기
Cursor에서 API 키 설정에 접속하는 방법에는 두 가지가 있습니다.
방법 1: 설정 UI
- Cursor를 엽니다.
Cmd + ,(macOS) 또는Ctrl + ,(Windows/Linux)를 눌러 Settings를 엽니다.- 왼쪽 사이드바에서 "Models"를 클릭합니다.
방법 2: 커맨드 팔레트(Command Palette)
Cmd + Shift + P(macOS) 또는Ctrl + Shift + P(Windows/Linux)를 누릅니다.- "Cursor Settings"를 입력하고 "Cursor: Open Cursor Settings"를 선택합니다.
- "Models" 섹션으로 이동합니다.
여기에서 API 키 입력 필드가 있는 AI 제공업체 목록을 확인할 수 있습니다.
2단계: OpenAI API 키 추가하기
OpenAI API 키 가져오기
- platform.openai.com/api-keys로 이동합니다.
- "Create new secret key"를 클릭합니다.
- 식별하기 쉽도록 "Cursor IDE"와 같은 이름을 지정합니다.
- 키를 복사합니다 (
sk-로 시작합니다).
Cursor에 추가하기
- Cursor Settings > Models에서 "OpenAI API Key" 필드를 찾습니다.
- API 키를 붙여넣습니다.
- "Verify"를 클릭하여 연결을 테스트합니다.
키가 추가되면 Cursor의 채팅, 인라인 편집(inline edits), 에이전트 모드에서 GPT-4o, GPT-4o-mini, o4-mini, o3 등의 OpenAI 모델을 사용할 수 있습니다.
Cursor 추천 OpenAI 모델
| 모델 | 용도 | 비용 (1M 토큰당) |
|---|---|---|
| gpt-4o | 범용 코딩, 복잡한 작업 | 입력 $2.50 / 출력 $10.00 |
| gpt-4o-mini | 빠른 완성, 단순 작업 | 입력 $0.15 / 출력 $0.60 |
| o4-mini | 추론, 디버깅 | 입력 $1.10 / 출력 $4.40 |
| o3 | 복잡한 아키텍처 결정 | 입력 $2.00 / 출력 $8.00 |
3단계: Anthropic API 키 추가하기
Anthropic API 키 가져오기
- console.anthropic.com으로 이동합니다.
- 로그인하거나 계정을 생성합니다.
- "API Keys"로 이동하여 "Create Key"를 클릭합니다.
- 키를 복사합니다 (
sk-ant-로 시작합니다).
Cursor에 추가하기
- Cursor Settings > Models에서 "Anthropic API Key" 필드를 찾습니다.
- API 키를 붙여넣습니다.
- "Verify"를 클릭합니다.
이제 본인의 API 키를 통해 Claude 모델에 직접 접속할 수 있습니다.
Cursor 추천 Anthropic 모델
| 모델 | 용도 | 비용 (1M 토큰당) |
|---|---|---|
| claude-sonnet-4-5-20250514 | 최고의 범용 코딩 모델 | 입력 $3.00 / 출력 $15.00 |
| claude-haiku-3-5-20241022 | 빠른 완성, 가벼운 작업 | 입력 $0.80 / 출력 $4.00 |
| claude-opus-4-20250514 | 복잡한 추론, 아키텍처 | 입력 $15.00 / 출력 $75.00 |
대부분의 코딩 작업에는 Claude Sonnet 4.5가 품질과 비용의 균형이 가장 좋습니다.
4단계: Google Gemini API 키 추가하기
Google AI API 키 가져오기
- aistudio.google.com/apikey로 이동합니다.
- "Create API Key"를 클릭합니다.
- Google Cloud 프로젝트를 선택하거나 새로 생성합니다.
- 생성된 키를 복사합니다.
Google은 Gemini 모델에 대해 넉넉한 무료 티어를 제공하므로 매우 비용 효율적인 옵션입니다.
Cursor에 추가하기
- Cursor Settings > Models에서 "Google AI API Key" 필드를 찾습니다.
- API 키를 붙여넣습니다.
- "Verify"를 클릭합니다.
Cursor 추천 Google 모델
| 모델 | 용도 | 비용 (1M 토큰당) |
|---|---|---|
| gemini-2.0-flash | 빠르고 비용 효율적인 코딩 | 무료 티어 가능 |
| gemini-2.5-pro | 복잡한 다중 파일 작업 | 입력 $1.25 / 출력 $10.00 |
| gemini-2.5-flash | 속도와 품질의 균형 | 입력 $0.15 / 출력 $0.60 |
Gemini 2.0 Flash 무료 티어는 특히 유용합니다. 비용을 지불하기 전에 상당한 무료 사용량을 제공받을 수 있습니다.
5단계: 커스텀 OpenAI 호환 엔드포인트 추가하기
Cursor는 OpenAI API 형식을 따르는 모든 API를 지원합니다. 이를 통해 다음 서비스에 연결할 수 있습니다.
- Ollama를 통한 로컬 모델
- Together AI
- Groq
- Fireworks AI
- OpenRouter
- 모든 OpenAI 호환 서버
Ollama 연결 (로컬 모델)
먼저, Ollama를 설치하고 실행합니다.
# Ollama 설치
curl -fsSL https://ollama.ai/install.sh | sh
# 코딩 모델 다운로드
ollama pull qwen2.5-coder:14b
# Ollama는 기본적으로 localhost:11434에서 실행됩니다.
그 후 Cursor에서 다음을 수행합니다.
- Settings > Models로 이동합니다.
- "OpenAI API Base URL" 또는 "Override OpenAI Base URL"을 찾습니다.
- 기본 URL을
http://localhost:11434/v1로 설정합니다. - API 키를
ollama(비어 있지 않은 문자열이면 무엇이든 가능)로 설정합니다. - 모델 목록에
qwen2.5-coder:14b모델 이름을 추가합니다.
OpenRouter 연결 (100개 이상의 모델 사용 가능)
OpenRouter를 사용하면 단일 API 키로 수백 개의 모델에 접속할 수 있습니다.
- openrouter.ai로 이동하여 계정을 생성합니다.
- API 키를 생성합니다.
- Cursor에서 OpenAI Base URL을
https://openrouter.ai/api/v1로 설정합니다. - OpenAI API Key 필드에 OpenRouter API 키를 붙여넣습니다.
anthropic/claude-sonnet-4-5,google/gemini-2.5-pro와 같은 모델 식별자를 사용합니다.
Groq 연결 (빠른 추론)
Groq은 오픈 소스 모델에 대해 매우 빠른 추론 속도를 제공합니다.
- console.groq.com으로 이동하여 계정을 생성합니다.
- API 키를 생성합니다.
- Cursor에서 OpenAI Base URL을
https://api.groq.com/openai/v1로 설정합니다. - Groq API 키를 붙여넣습니다.
llama-3.3-70b-versatile또는mixtral-8x7b-32768과 같은 모델을 사용합니다.
6단계: 모델 기본 설정 구성하기
API 키를 추가한 후, 각기 다른 작업에 어떤 모델을 사용할지 Cursor에서 설정할 수 있습니다.
기본 모델 설정
Cursor Settings > Models에서 각 기능에 모델을 할당할 수 있습니다.
- Chat: Cursor Chat (Cmd+L)에 사용되는 모델. 추천: Claude Sonnet 4.5 또는 GPT-4o.
- Inline Edit: 인라인 코드 편집 (Cmd+K)에 사용되는 모델. 추천: Claude Sonnet 4.5 또는 GPT-4o.
- Agent: 에이전트 모드에 사용되는 모델. 추천: Claude Sonnet 4.5.
- Tab Completion: 자동 완성 제안용 모델. 추천: GPT-4o-mini 또는 Gemini Flash와 같은 빠른 모델.
비용 최적화를 위한 예시 구성
자주 발생하는 간단한 작업에는 저렴한 모델을 사용하고, 복잡한 작업에는 프리미엄 모델을 사용하세요.
| 기능 | 모델 | 이유 |
|---|---|---|
| Tab completion | gpt-4o-mini | 빠름, 저렴함, 많은 사용량 처리 |
| Inline edits | claude-sonnet-4-5 | 정밀한 변경 작업에 뛰어난 품질 |
| Chat | claude-sonnet-4-5 | 토론 및 기획에 최적 |
| Agent mode | claude-sonnet-4-5 | 다단계 작업 수행에 강력함 |
7단계: 작동 여부 확인하기
간단한 작업을 실행하여 각 API 키를 테스트해 보세요.
- 채팅 테스트:
Cmd+L을 누르고 커스텀 모델을 선택한 뒤 "Write a hello world function in Python"이라고 요청해 봅니다. - 인라인 편집 테스트: 코드 블록을 선택하고
Cmd+K를 누른 뒤 "Add error handling to this function"이라고 요청해 봅니다. - 에이전트 테스트: 에이전트 모드를 시작하고 "Create a new file called test.py with a function that calculates factorial"이라고 요청해 봅니다.
테스트에 실패하면 다음을 확인하세요.
- API 키가 정확하게 입력되었는지 (불필요한 공백 확인).
- API 계정에 크레딧이 있거나 활성 결제 수단이 등록되어 있는지.
- Base URL이 올바른지 (특히 커스텀 엔드포인트의 경우).
- 모델 이름이 제공업체의 명명 규칙과 일치하는지.
일반적인 문제 해결 (Troubleshooting)
| 문제 | 원인 | 해결 방법 |
|---|---|---|
| "Invalid API key" | 잘못된 키 또는 만료됨 | 제공업체 사이트에서 키 재생성 |
| "Model not found" | 잘못된 모델 이름 | 제공업체 문서에서 정확한 모델 ID 확인 |
| "Rate limit exceeded" | 요청이 너무 많음 | 잠시 기다린 후 재시도 또는 API 티어 업그레이드 |
| "Connection refused" (Ollama) | Ollama 미실행 | ollama serve 명령어로 Ollama 실행 |
| 느린 응답 | 서버 위치 | 가까운 곳에 서버가 있는 제공업체 선택 |
| "Insufficient credits" | 잔액 부족 | API 계정에 충전(결제) |
자주 묻는 질문 (FAQ)
커스텀 API 키를 추가해도 Cursor Pro가 필요한가요? 아니요. 본인의 API 키를 사용하면 Cursor Pro 구독 없이도 AI 기능을 사용할 수 있습니다. 다만, 고급 탭 자동 완성(advanced tab completions)과 같은 일부 Cursor 전용 기능은 여전히 Pro가 필요할 수 있습니다.
어떤 API 키가 가장 경제적인가요? Google Gemini가 가장 넉넉한 무료 티어를 제공합니다. 유료 사용의 경우 GPT-4o-mini와 Gemini Flash가 가장 저렴하면서도 품질이 좋은 옵션입니다.
여러 개의 API 키를 동시에 사용할 수 있나요? 네. 여러 제공업체의 키를 추가하고 필요에 따라 모델을 전환할 수 있습니다. Cursor는 선택한 모델에 따라 적절한 키를 사용합니다.
내 API 키는 안전하게 저장되나요? Cursor는 API 키를 사용자의 로컬 컴퓨터에 저장합니다. 본인의 키를 사용할 때 키 자체가 Cursor 서버로 업로드되지 않으며, 요청은 제공업체로 직접 전송됩니다.
커스텀 API 키를 사용하면 Cursor의 기본 한도에 영향을 주나요? 네. 본인의 API 키를 사용할 경우, 해당 요청은 Cursor의 Free 또는 Pro 요청 한도에 포함되지 않습니다. 비용은 API 제공업체에서 직접 청구됩니다.
마무리
Cursor에 커스텀 API 키를 추가하면 AI 코딩 환경을 완벽하게 제어할 수 있습니다. 작업 복잡도에 따라 모델을 선택하고, 비용을 정교하게 관리하며, Cursor의 기본 내장 제한을 피할 수 있습니다. 설정은 제공업체당 5분도 걸리지 않습니다.
코드와 함께 AI 생성 미디어가 필요한 애플리케이션을 구축하고 있다면, Hypereal AI를 무료로 체험해 보세요. 카드 등록 없이 35 크레딧을 드립니다. Hypereal API는 Cursor나 다른 에디터에서 빌드하는 프로젝트에 완벽하게 통합됩니다.
