> ## 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 兼容的 base URL 和 venice- 模型前缀，配置 Cursor IDE 使用包括 Claude、GPT、DeepSeek 和 Qwen 在内的 Venice 模型。

[Cursor](https://www.cursor.com/) 是一款 AI 驱动的代码编辑器。您可以将其与 Venice AI 一起使用，从而私密、无审查地访问广泛的模型。

<CardGroup cols={3}>
  <Card title="按 token 付费" 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 并按回车。逐个添加您想使用的模型。例如：

    * `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>
  **在 Cursor 中使用 Claude 模型时需要 `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>