본문으로 건너뛰기

Cursor에서 사용자 정의 모델 사용하기

가이드를 통해 Cursor에서 사용자 정의 AI 모델을 통합하고 사용하여 개발 워크플로우를 위한 다양한 AI 기능을 활용하는 방법을 설명합니다.

지원되는 모델 유형​

Cursor는 다양한 AI 모델을 통합하고 지원합니다:

  1. OpenAI 호환 모델

    • Anthropic Claude
    • DeepSeek
    • Mistral
    • 로컬 LLMs

  2. 사용자 정의 API 엔드포인트

    • 자체 호스트 모델
    • 클라우드 API 서비스
    • 사용자 정의 구현

기본 구성​

사용자 정의 모델 설정​

  1. Cursor 설정 열기
  2. AI 모델 섹션으로 이동
  3. 모델 구성 추가:
{
  "models": {
    "custom-model": {
      "name": "모델 이름",
      "apiKey": "api-키",
      "baseUrl": "https://api.your-model-endpoint.com/v1",
      "contextLength": 8192,
      "temperature": 0.7
    }
  }
}

구성 매개변수​

매개변수설명기본값
name모델 표시 이름필수
apiKeyAPI 인증 키필수
baseUrlAPI 엔드포인트 URL필수
contextLength최대 컨텍스트 길이4096
temperature응답 무작위성0.7

모델 통합​

OpenAI 호환 모델​

{
  "models": {
    "custom-gpt": {
      "name": "사용자 정의 GPT",
      "apiKey": "${OPENAI_API_KEY}",
      "baseUrl": "https://api.openai.com/v1",
      "model": "gpt-4",
      "contextLength": 8192
    }
  }
}

Anthropic Claude 설정​

{
  "models": {
    "claude": {
      "name": "Claude",
      "apiKey": "${ANTHROPIC_API_KEY}",
      "baseUrl": "https://api.anthropic.com/v1",
      "model": "claude-2",
      "contextLength": 100000
    }
  }
}

로컬 모델 구성​

{
  "models": {
    "local-llm": {
      "name": "로컬 LLM",
      "baseUrl": "http://localhost:8000",
      "contextLength": 4096,
      "useDocker": true
    }
  }
}

고급 설정​

모델 동작​

모델 동작 구성:

{
  "models": {
    "custom-model": {
      "settings": {
        "temperature": 0.7,
        "topP": 0.9,
        "frequencyPenalty": 0.0,
        "presencePenalty": 0.0,
        "stopSequences": ["```", "###"]
      }
    }
  }
}

응답 형식​

{
  "models": {
    "custom-model": {
      "formatting": {
        "trimWhitespace": true,
        "removeNewlines": false,
        "maxTokens": 1000
      }
    }
  }
}

모델 기능​

코드 완성​

{
  "models": {
    "code-model": {
      "features": {
        "codeCompletion": true,
        "contextAware": true,
        "multiFile": true
      }
    }
  }
}

채팅 기능​

{
  "models": {
    "chat-model": {
      "features": {
        "chat": true,
        "systemPrompts": true,
        "streaming": true
      }
    }
  }
}

성능 최적화​

캐시 설정​

{
  "models": {
    "custom-model": {
      "cache": {
        "enabled": true,
        "maxSize": "1GB",
        "ttl": 3600
      }
    }
  }
}

속도 제한​

{
  "models": {
    "custom-model": {
      "rateLimit": {
        "requestsPerMinute": 60,
        "tokensPerMinute": 90000,
        "concurrent": 5
      }
    }
  }
}

문제 해결​

일반적인 문제​

  1. 연결 문제

    • API 엔드포인트 확인
    • 네트워크 연결 확인
    • API 테스트

  2. 응답 오류

    • 모델 호환성 확인
    • 요청 형식 확인
    • 오류 메시지 검사

  3. 성능 문제

    • 컨텍스트 길이 최적화
    • 캐시 설정 조정
    • 속도 제한 모니터링

모범 사례​

보안​

  1. API 관리

    • 환경 변수 사용
    • 정기적인 키 교체
    • 접근 제어 구현

  2. 요청 검사

    • 입력 정제
    • 응답 검사
    • 오류 우아하게 처리

성능​

  1. 컨텍스트 최적화

    • 컨텍스트 크기 최소화
    • 관련 정보 우선순위 지정
    • 캐시 효과 사용

  2. 리소스 관리

    • 병렬 요청 제한
    • 메모리 사용 모니터링
    • 응답 시간 최적화