Cursor의 무료 플랜을 사용하면서 모델을 선택했을 때,

Named models unavailable

Free plans can only use Auto. Switch to Auto or upgrade plans to continue.

라는 에러 메시지가 나타난 적이 있지 않으신가요?

본 기사에서는 이 메시지가 표시되는 원인과, 무료 플랜에서의 회피 방법 / 유료 플랜에서의 해결 방법을 정리합니다.

결론

• 무료 플랜에서는
  「Auto」 이외의 Named models (GPT-4o mini 등)를 직접 지정할 수 없음 - 모델을 개별 지정한 상태로 실행하면 「Named models unavailable」이 발생함
• 무료로 계속 사용하고 싶다면 「Auto」로 전환
• Named models 나 고기능 에이전트 (Agent)를 풀 활용하고 싶다면 유료 플랜으로 업그레이드

에러 메시지의 내용

팝업에는 대략 다음과 같은 문구가 표시됩니다.

Named models unavailable

Free plans can only use Auto. Switch to Auto or upgrade plans to continue.

의역하자면,

「Named models (이름 지정 모델)는 사용할 수 없습니다.

무료 플랜에서는 Auto만 사용할 수 있으므로, Auto로 전환하거나 유료 플랜으로 업그레이드해 주세요.」

라는 의미입니다.

왜 에러가 발생하는가

Cursor의 무료 플랜에는 다음과 같은 제한이 있습니다.

Named models (GPT-4o mini 등 특정 모델)를 직접 지정할 수 없음 - 이용 가능한 것은
「Auto」 모드뿐임 (환경 측에서 모델을 자동 선택)

그렇기 때문에, 입력창의 모델 선택에서 「GPT-4o mini」 등의 Named model을 선택한 상태로 실행하면,

• 「무료 플랜인데 Named model을 지정하고 있음」
• → 제한에 걸림
• → 「Named models unavailable」 에러 발생

이라는 흐름이 됩니다.

사양에 따른 제한이므로 버그가 아닙니다.

무료 플랜으로 계속 사용하는 경우의 대처 방법

「우선은 무료 상태로 계속 쓰고 싶다」는 경우에는 모델 선택을 Auto로 되돌리는 것만으로 충분합니다.

절차

• 입력창 왼쪽 하단의 모델명 (예: GPT-4o mini)이 표시된 부분을 클릭한다
• 모델 목록 중에서 Auto를 선택한다
• 그 상태로 프롬프트 (Prompt)를 전송한다

이렇게 하면 무료 플랜 범위 내에서 에이전트적인 서포트 (코드 보완이나 채팅 등)를 계속 이용할 수 있습니다.

단,

• 특정 모델을 전제로 한 동작 튜닝
• 고성능 모델에서의 답변 품질

등은 Auto가 내부적으로 선택하는 모델과 제한 사항에 의존하기 때문에, Named models를 명시적으로 지정할 때와 비교하여 차이가 발생할 가능성이 있습니다.

Named models나 에이전트 기능을 풀 활용하고 싶은 경우

「GPT-4o mini와 같은 Named model을 직접 선택하고 싶다」, 「고성능 모델을 전제로 한 에이전트 기능도 포함하여 풀로 사용하고 싶다」는 경우에는 유료 플랜으로의 업그레이드가 필요합니다.

업그레이드 흐름

• 에러 팝업 오른쪽 하단의 **「Upgrade to Pro」**를 클릭한다

(또는 Cursor의 웹 페이지에서 계정 설정 / Billing으로 이동) - 유료 플랜 (Pro 등)을 선택하여 업그레이드를 완료한다

• 앱 측의 Cursor에서 로그인 상태를 확인한다
• 입력창의 모델 선택에서 GPT-4o mini 등의 Named model을 선택한다

이렇게 하면,

• Named models의 직접 지정
• 그것들을 전제로 한 에이전트 기능
• 고성능 모델에 의한 코드 생성 · 리팩토링 (Refactor) · 테스트 생성 등의 품질 향상

을 기대할 수 있습니다.

요약

Cursor 무료 플랜에서 「Named models unavailable」이라는 에러가 표시되는 것은,

• 무료 플랜에서는 Auto 이외의 Named models를 사용할 수 없음
• 그럼에도 불구하고 GPT-4o mini 등의 Named model을 선택하여 실행하고 있음

이라는 사양상의 제한이 원인입니다.

대처 방법은 심플하며,

• 무료로 계속 사용하려면 → 모델을 Auto로 되돌리기
• Named models나 고성능 에이전트 (Agent)를 온전히 사용하려면 → 유료 플랜으로 업그레이드하기

라는 두 가지 선택지가 있습니다.

동일한 에러로 어려움을 겪고 계신 분들에게 참고가 되기를 바랍니다.

Discussion