> ## Documentation Index
> Fetch the complete documentation index at: https://doc.xbhuiz.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cursor API Key 配置

> 使用一把 XMAI API key 和 OpenAI 兼容 base URL 配置 Cursor。

Cursor 可以通过 OpenAI 兼容配置接入 XMAI。打开 Cursor 的模型设置，启用 OpenAI
API Key，填入 XMAI token，并把 Override Base URL 设置为
`https://xmapi.site/v1`。

## 直接答案

在 Cursor 中打开 **Settings → Models → API Keys**：

| 字段                | 值                       |
| ----------------- | ----------------------- |
| OpenAI API Key    | 你的 XMAI API key         |
| Override Base URL | `https://xmapi.site/v1` |
| Model ID          | 例如 `claude-opus-4-8`    |

## 第 1 步：创建 XMAI API key

打开 [API Keys dashboard](https://xbhuiz.com/dashboard/tokens)，创建一把例如
`cursor-local` 的 key，并复制保存。

## 第 2 步：配置 Cursor

在 Cursor 的模型设置中：

1. 启用 OpenAI API key。
2. 粘贴你的 XMAI key。
3. 启用 Override Base URL。
4. 设置为 `https://xmapi.site/v1`。

## 第 3 步：添加模型 id

从 [支持模型](/cn/models) 复制准确的模型 id。Cursor 可以通过 OpenAI 兼容入口调用支持的
Claude、GPT、Gemini、Grok 模型。

常见示例：

* `claude-opus-4-8`
* `gpt-5.5`
* `gemini-3.1-pro-preview`
* `grok-4.5`

## 常见问题

### Cursor 应该使用什么 base URL？

使用 `https://xmapi.site/v1`。

### Cursor 可以通过 OpenAI 兼容接口调用 Claude 吗？

可以。XMAI 会把支持的 Claude id 映射到 OpenAI 兼容 Chat Completions 入口。

### 是否应该所有 Cursor workspace 共用一把 key？

可以共用，但按 workspace 分 key 更方便撤销、限额和审计。