홈 / 가이드 / 무료 LLM API로 Cursor 사용하기

무료 LLM API로 Cursor 사용하기

Cursor는 사용자 자신의 OpenAI API 키로 채팅 요청을 보낼 수 있습니다. 이 가이드는 그 키를 FreeLLMAPI를 통해 무료 모델에 연결하는 방법을 보여 줍니다. 또한 한계도 설명합니다. Cursor는 각 요청을 자체 서버로 보내며, Tab 자동 완성은 항상 Cursor의 모델을 사용합니다.

코드, 모델 이름, 실시간 카탈로그 레이블은 영어로 표시합니다.

동작하는 기능과 동작하지 않는 기능

시작하기 전에 이 부분을 읽으세요. Cursor의 자체 키 지원은 대부분의 다른 편집기보다 범위가 좁습니다.

Cursor 기능자체 키 사용 시출처
표준 OpenAI 스타일 모델과 채팅예. Cursor는 표준 비추론 채팅 모델에 대해 자체 OpenAI 키를 문서화합니다.Cursor API 키 도움말 페이지
Tab 자동 완성아니요. Cursor는 Tab이 계속 Cursor의 기본 모델을 사용한다고 밝힙니다.Cursor API 키 도움말 페이지
에이전트 모드와 Composer확인되지 않음. Cursor 문서는 채팅 모델만 언급합니다. 의존하기 전에 사용자의 요금제에서 테스트하세요.문서화되지 않음
localhost의 요청아니요. Cursor는 프롬프트를 구성하기 위해 모든 요청을 자체 서버로 보냅니다. 따라서 사용자의 컴퓨터에 있는 localhost는 경로에 포함되지 않습니다.Cursor API 키 도움말 페이지

요금제도 중요합니다. Cursor 가격 페이지는 Premium, Super, Ultra 요금제에서 타사 모델과 자체 API 키를 나열합니다. Plus 요금제에는 자체 API 키가 없다고 적혀 있습니다. Free 요금제의 경우 이 페이지는 타사 모델을 사용할 수 없다고 나열합니다. 계속하기 전에 사용자의 요금제를 가격 페이지에서 확인하세요.

참고: 요금제 규칙 없이 무료 편집기 에이전트를 원한다면 VS Code에서 Cline, Roo Code 또는 Kilo Code를 사용하세요. 이들은 localhost에 직접 연결합니다. 무료 API로 Cline, Roo Code, Kilo Code 사용하기를 읽으세요.

1단계: FreeLLMAPI 설치하고 접근 가능하게 만들기

FreeLLMAPI는 오픈 소스이며 Docker에서 사용자의 컴퓨터를 기반으로 실행됩니다. 설치한 다음 Keys 페이지에서 무료 제공업체 키를 두 개 이상 추가하세요.

macOS 또는 Linux에 설치

curl -fsSL https://freellmapi.co/install.sh | bash

Keys 페이지에서 통합 키를 복사하세요. 그다음 게이트웨이에 공개 HTTPS 주소를 주세요. Cursor의 서버는 사용자의 localhost에 접근할 수 없기 때문입니다. 신뢰할 수 있는 HTTPS 터널이나 직접 관리하는 서버를 사용하세요. Cursor용 FreeLLMAPI 가이드는 다음 단계를 출력합니다.

Cursor 가이드 출력

npx freellmapi setup-cursor

이 명령은 파일을 쓰지 않습니다. Cursor에는 이 설정을 위한 구성 파일이 없으므로, Cursor 설정에 값을 직접 입력합니다.

보안: 공개 URL은 통합 키를 가진 누구나 사용자의 무료 할당량을 쓸 수 있게 합니다. 키를 절대 공유하지 마세요. 터널이 Authorization 헤더를 보낼 수 없다면, Keys, Agents에서 따로 취소할 수 있는 URL 토큰을 만드세요. 사용을 멈추면 취소하세요.

2단계: Cursor에 키와 Base URL 설정하기

  1. Cursor Settings를 여세요.
  2. Models를 여세요.
  3. OpenAI API 키 필드를 찾으세요. FreeLLMAPI 통합 키를 붙여 넣으세요. Save를 클릭하세요.
  4. OpenAI Base URL 재정의를 켜세요. FreeLLMAPI 가이드는 이 설정을 Override OpenAI Base URL이라고 부릅니다.
  5. 끝에 /v1을 붙여 공개 주소를 입력하세요. 예: https://<your-tunnel-host>/v1.
  6. 모델 선택기에서 모델을 고르고 짧은 채팅 메시지를 보내세요.

Cursor의 개인정보 보호 문서는 OpenAI 호환 Base URL 재정의를 언급합니다. Cursor는 정확한 단계를 문서화하지 않습니다. 사용자의 버전에서는 항목 이름이 다를 수 있습니다.

요청이 게이트웨이에 도달했는지 확인하려면 대시보드의 요청 로그를 여세요. 각 응답에는 응답한 제공업체와 모델을 보여 주는 X-Routed-Via 헤더도 있습니다.

중요: 재정의를 켜 두면 전역으로 적용됩니다. Cursor의 기본 제공업체로 되돌리기 전에 재정의를 끄세요.

3단계: 모델 선택하기

모델 ID auto를 사용하면 라우터가 요청마다 무료 모델을 고릅니다. GET /v1/models의 카탈로그 ID를 사용할 수도 있습니다. Cursor 채팅은 메시지마다 파일 컨텍스트를 보내므로, 큰 컨텍스트 윈도우를 가진 모델을 사용하세요. 아래 표는 현재 도구 호출을 지원하고 컨텍스트가 최소 128K인 무료 모델을 보여 줍니다.

Cursor 채팅용 무료 모델: 도구 호출과 128K 이상 컨텍스트
모델무료 제공컨텍스트무료 한도 (가장 좋은 조건)도구비전
GLM 5.3UnoRouter1M1 요청/분
1 req/min per model
예아니요
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 요청/분
40 RPM
예예
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quota예예
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowance예아니요
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring credit예예
Gemini 3.7 FlashGoogle AI Studio1M10 요청/분
20 요청/일
250,000 토큰/분
~3M
예예
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring credit예예
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 요청/분
50 요청/일
50 req/day account-wide (1,000 after a $10 purchase)
예예
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 요청/분
50 요청/일
Shared rate limit
예아니요
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 요청/분
250 요청/일
70,000 토큰/분
~6M
예예

일치하는 무료 모델 109개 중 10개를 표시합니다. 모든 모델 보기.

FreeLLMAPI 카탈로그의 실시간 데이터입니다 (버전 2026.11.19, 2026-11-19 확인). 무료 한도는 자주 바뀝니다. 카탈로그는 매일 확인합니다.

Cursor는 비추론 채팅 모델에 대해서만 자체 OpenAI 키를 문서화합니다. 추론 모델은 재정의를 거치면 실패할 수 있습니다. 모델이 실패하면 auto를 쓰거나 표에 있는 다른 모델을 사용하세요.

속도 제한과 실패 전환

각 무료 요금제에는 분당 한도와 일일 한도가 있습니다. FreeLLMAPI는 키마다 사용량을 계산합니다. 한 제공업체가 429 오류를 보내면, 라우터는 요청을 실패 전환 체인의 다음 모델로 보냅니다. 채팅은 계속되며 Cursor에서 설정을 바꿀 필요가 없습니다.

  • 제공업체 네 곳 이상의 키를 추가하세요. 제공업체가 많을수록 하루 요청 수가 늘어납니다.
  • 짧은 질문에는 auto:fast를, 어려운 코드 질문에는 auto:smart를 사용하세요.
  • 작업마다 새 채팅을 시작하세요. 기록이 짧을수록 보내는 토큰이 적습니다.

문제 해결

문제원인해결 방법
Cursor가 http://localhost:3001/v1에 연결할 수 없습니다Cursor는 자체 서버에서 요청을 보내며, 사용자의 컴퓨터에서 보내지 않습니다게이트웨이에 공개 HTTPS 주소를 사용하세요
자체 키 옵션이 없습니다사용자의 Cursor 요금제에는 자체 API 키가 포함되지 않습니다Cursor 가격 페이지의 요금제 표를 확인하세요
401 "Invalid API key"Cursor의 키가 FreeLLMAPI 통합 키가 아닙니다Keys 페이지에서 통합 키를 다시 복사하세요
Tab 자동 완성이 게이트웨이를 사용하지 않습니다Cursor는 Tab에 항상 자체 모델을 사용합니다해결 방법 없음. 무료 자동 완성이 필요하면 VS Code에서 Continue를 사용하세요
"All models rate-limited after N attempts" (N회 시도 후 모든 모델이 속도 제한에 걸림)체인의 모든 키가 한도에 도달했습니다더 많은 제공업체의 키를 추가하거나 쿨다운이 끝날 때까지 기다리세요
기본 제공 모델이 작동하지 않습니다Base URL 재정의가 아직 켜져 있습니다재정의를 끄세요
하나의 키로 이 모델을 모두 사용하십시오. FreeLLMAPI는 오픈 소스이며 직접 호스팅하는 라우터입니다. 이 모든 무료 제공 서비스를 하나의 OpenAI 호환 엔드포인트로 묶고, 요청 한도에 걸리면 다른 모델로 자동 전환합니다. 카탈로그 보기 또는 바로 시작.

자주 묻는 질문

자체 API 키로 Cursor를 무료로 사용할 수 있나요?

Cursor 가격 페이지는 Premium, Super, Ultra 요금제에서 자체 API 키를 나열하며, Plus 요금제에는 자체 키가 없다고 밝힙니다. 자체 키를 쓸 수 있는 요금제에서는 FreeLLMAPI가 채팅에 무료 모델을 제공하므로, 추론 비용은 $0입니다.

Cursor가 localhost에 연결되지 않는 이유는 무엇인가요?

Cursor는 프롬프트를 구성하기 위해 모든 요청을 자체 서버로 보냅니다. 이 서버들은 사용자의 컴퓨터에 있는 localhost에 접근할 수 없으므로, 게이트웨이에는 공개 HTTPS 주소가 필요합니다.

Cursor Tab 자동 완성이 사용자 지정 API로 동작하나요?

아니요. Cursor 문서는 사용자 지정 API 키가 채팅 모델에서만 동작하며, Tab 자동 완성은 계속 Cursor의 기본 모델을 사용한다고 밝힙니다.

Cursor에 가장 좋은 무료 모델은 무엇인가요?

auto를 쓰거나, 이 페이지의 표에서 도구 호출을 지원하고 컨텍스트가 최소 128K인 모델을 사용하세요. Cursor는 메시지마다 파일 컨텍스트를 보내므로, 큰 컨텍스트 윈도우가 중요합니다.

자체 키를 사용하면 내 코드가 Cursor로 전송되나요?

네. Cursor는 최종 프롬프트 구성을 위해 요청이 자체 서버를 거친다고 밝힙니다. 자체 키를 사용할 때는 Zero Data Retention이 적용되지 않습니다.

관련 가이드

출처

전체 가이드 · 무료 모델 전체 보기