Skip to Content
도구 연동Cursor

Cursor 설정

Cursor 는 AI가 내장된 코드 편집기로, 커스텀 API 공급자를 지원합니다. OfoxAI를 설정하면 각 서비스에 별도로 구독하지 않고도 Cursor에서 Claude, GPT-4o, Gemini 등 100개 이상의 모델을 사용할 수 있습니다.

사전 요건

Cursor 무료 플랜은 Auto 모드만 지원하며, 커스텀 모델을 사용할 수 없습니다. OfoxAI를 설정하려면 Cursor Pro 이상 플랜을 구독해야 합니다.

설정 단계

1단계: 모델 설정 열기

우측 상단 톱니바퀴 아이콘 클릭 → Cursor Settings → 왼쪽에서 Models 선택（아래 그림의 표시 ①）.

단축키 Cmd + ,（macOS）/ Ctrl + ,（Windows/Linux）로 설정을 직접 열고 Models 탭으로 전환할 수도 있습니다.

2단계: API Key 입력 및 토글 활성화

Models 페이지에서 OpenAI API Key 섹션을 찾은 후, 먼저 우측 토글을 켜고（toggle ON）, 입력란에 OfoxAI API Key를 붙여넣습니다（아래 그림의 표시 ②）.

OfoxAI는 OpenAI 프로토콜과 완전히 호환되므로, OfoxAI API Key를 Cursor의 OpenAI API Key 필드에 바로 입력할 수 있습니다.

3단계: Base URL 입력 및 토글 활성화

같은 페이지에서 Override OpenAI Base URL 옵션을 찾은 후, 먼저 우측 토글을 켜고（toggle ON）, OfoxAI의 API 주소를 입력합니다（아래 그림의 표시 ③）.

두 가지 설정 항목 요약:

설정 항목값
OpenAI API Key（토글 ON）귀하의 OfoxAI API Key
Override OpenAI Base URL（토글 ON）https://api.ofox.ai/v1

Cursor Models 설정 화면

위 그림의 Base URL은 예시 주소입니다. OfoxAI의 주소를 입력하세요：https://api.ofox.ai/v1

4단계: 커스텀 모델 추가

Model Names 섹션에서 Add or search model 입력란을 클릭하고（위 그림의 표시 ④）, 사용할 모델을 순서대로 추가합니다:

anthropic/claude-sonnet-4.6
anthropic/claude-opus-4.6
openai/gpt-4o
openai/gpt-4o-mini
google/gemini-3.1-flash-lite-preview

Cursor의 기본 모델 이름（gpt-4o, claude-3-5-sonnet 등）은 OfoxAI에서 사용할 수 없습니다. openai/gpt-4o, anthropic/claude-sonnet-4.6과 같이 반드시 OfoxAI 형식의 모델 ID를 사용하세요.

5단계: 설정 확인

AI 채팅 창（Cmd+L / Ctrl+L）을 열고, Auto 모드를 끄고, 모델 드롭다운에서 방금 추가한 모델을 선택한 후 테스트 메시지를 보냅니다:

안녕하세요, 자기소개를 해주세요.

정상적인 응답을 받으면 설정이 성공한 것입니다.

추천 모델

모델 ID사용 사례
anthropic/claude-sonnet-4.6코드 생성 및 리팩토링, 종합적 우수 성능
anthropic/claude-opus-4.6복잡한 아키텍처 분석, 최고 수준 성능
openai/gpt-4o범용 프로그래밍 어시스턴트
openai/gpt-4o-mini빠른 자동완성, 저비용
google/gemini-3.1-flash-lite-preview고빈도 사용, 빠른 응답

전체 모델 목록은 모델 카탈로그 를 참조하세요.

자주 묻는 질문

Q: Verify 클릭 시 「Invalid API Key」가 표시됩니다

다음 사항을 확인하세요:

  1. API Key가 OfoxAI 콘솔 에서 완전히 복사되었나요?（앞뒤 공백 주의）
  2. Base URL이 https://api.ofox.ai/v1로 올바르게 입력되었나요?（끝에 슬래시 없이）
  3. OpenAI API Key와 Override OpenAI Base URL의 우측 토글이 모두 켜져 있나요?

Q: 추가한 모델이 채팅 패널에 보이지 않습니다

채팅 패널에서 Auto 모드를 끄면 모델 드롭다운 목록에서 커스텀으로 추가한 모델을 볼 수 있습니다.

Q: 「The model does not work with your current plan」 오류가 발생합니다

이 오류는 현재 Cursor 플랜이 커스텀 모델을 지원하지 않음을 의미합니다. 커스텀 API 공급자를 사용하려면 Cursor Pro 플랜으로 업그레이드해야 합니다.

Q: 코드 자동완성이 작동하지 않고 채팅만 사용 가능합니다

Cursor의 인라인 자동완성（Tab 자동완성）은 기본적으로 Cursor 자체 모델을 사용합니다. 커스텀 모델은 주로 AI Chat（Cmd+L）과 Composer（Cmd+I）기능에서 사용됩니다.

Last updated on
Gemini CLIGitHub Copilot