> ## Documentation Index
> Fetch the complete documentation index at: https://veniceai-mintlify-d2fddb8a.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Cursor IDE

> OpenAI 호환 베이스 URL과 venice- 모델 접두사를 통해 Claude, GPT, DeepSeek, Qwen을 포함한 Venice 모델을 Cursor IDE에서 사용하도록 구성하세요.

[Cursor](https://www.cursor.com/)는 AI 기반 코드 편집기입니다. 다양한 모델에 대한 비공개 및 검열되지 않은 액세스를 위해 Venice AI와 함께 사용할 수 있습니다.

<CardGroup cols={3}>
  <Card title="토큰별 결제" icon="coins">
    구독 없음. 사용한 만큼만 결제
  </Card>

  <Card title="모든 모델" icon="microchip">
    Claude, GPT, DeepSeek, Llama 등에 액세스
  </Card>

  <Card title="OpenAI 호환" icon="plug">
    Venice의 OpenAI 호환 API를 통해 작동
  </Card>
</CardGroup>

***

## 설정

<Steps>
  <Step title="API 키 받기">
    [venice.ai/settings/api](https://venice.ai/settings/api)에서 키를 생성하세요.
  </Step>

  <Step title="Cursor 구성">
    **Cursor Settings**(톱니바퀴 아이콘)을 열고 **Models**로 스크롤한 다음 **Add Model**을 클릭합니다.

    **OpenAI Compatible** 아래에 다음을 입력합니다:

    * **Override OpenAI Base URL**: `https://api.venice.ai/api/v1`
    * **OpenAI API Key**: Venice API 키
  </Step>

  <Step title="모델 추가">
    모델 이름 필드에 Venice 모델 ID를 입력하고 Enter 키를 누릅니다. 사용하려는 각 모델을 추가합니다. 예를 들어:

    * `minimax-m25`
    * `kimi-k2-5`
    * `venice-claude-opus-4-6`(아래 [접두사 참고](#the-venice--model-prefix) 참조)

    사용 가능한 모든 모델 ID는 [모델 카탈로그](/models/text)를 참조하세요.
  </Step>

  <Step title="선택 및 확인">
    새 채팅을 열고 **채팅 하단의 모델 선택기**를 사용하여 방금 추가한 Venice 모델 중 하나를 선택합니다. 테스트 메시지를 보내세요. 응답을 받으면 설정이 완료된 것입니다.
  </Step>
</Steps>

***

## `venice-` 모델 접두사

<Warning>
  **Claude 모델은 Cursor에서 사용할 때 `venice-` 접두사가 필요합니다.**

  Cursor는 `claude-*` 모델의 요청을 Anthropic의 네이티브 형식으로 재작성하며, 이는 Venice와 호환되지 않습니다. 모델 ID에 `venice-` 접두사를 붙이면 이 재작성을 방지합니다. Venice는 접두사를 자동으로 제거합니다.
</Warning>

| 모델                   | 표준 ID                  | Cursor ID                     |
| -------------------- | ---------------------- | ----------------------------- |
| Claude Opus 4.6      | `claude-opus-4-6`      | `venice-claude-opus-4-6`      |
| Claude Opus 4.6 Fast | `claude-opus-4-6-fast` | `venice-claude-opus-4-6-fast` |
| Claude Sonnet 4.6    | `claude-sonnet-4-6`    | `venice-claude-sonnet-4-6`    |
| Claude Opus 4.5      | `claude-opus-4-5`      | `venice-claude-opus-4-5`      |
| Claude Sonnet 4.5    | `claude-sonnet-4-5`    | `venice-claude-sonnet-4-5`    |

<Info>
  Claude 이외의 모델(예: `minimax-m25`, `kimi-k2-5`, `zai-org-glm-5`)은 **영향을 받지 않으며** 접두사 없이 작동합니다. Venice가 항상 접두사를 제거하므로 어떤 모델에든 `venice-` 접두사를 사용해도 안전하지만, Cursor에서 Claude 모델에만 필요합니다.
</Info>

***

## 리소스

<CardGroup cols={2}>
  <Card title="Venice API 문서" icon="book" href="/api-reference/api-spec">
    전체 API 참조
  </Card>

  <Card title="모델 카탈로그" icon="list" href="/models/text">
    사용 가능한 모델 찾아보기
  </Card>
</CardGroup>