# Cursor 安装与接入 4SToken

Cursor 通过 OpenAI 兼容接口调用模型。因配置存储在客户端内，需要半自动完成 Add Models。


## 安装前准备

1. 已安装 Cursor。
2. 已创建 Portal Client Key。
3. 准备一个 Cursor 模型 Key，例如 `spt-5.5`、`spt-5.4`、`openrouter-free`。
4. 确认 OpenAI 兼容 Base URL：`https://api.4stoken.cn/v1`

## Windows 安装与配置

1. 打开 Cursor 下载页：<https://www.cursor.com/downloads>
2. 下载 Windows 安装包并完成安装。
3. 运行本页 PowerShell 向导，复制 Base URL、Key、模型名。
4. 打开 Cursor：`Settings -> Cursor Settings -> Models`
5. 填入 OpenAI API Key。
6. 开启 Override OpenAI Base URL，填入 `https://api.4stoken.cn/v1`。
7. 在模型下拉中点击 Add Models，输入 `spt-*` 或 `openrouter-free`，按 Enter 添加并启用。

## macOS / Linux 安装与配置

1. 打开 Cursor 下载页：<https://www.cursor.com/downloads>
2. macOS 下载 `.dmg`，Linux 下载 AppImage 或发行版包。
3. 运行本页 bash 向导，复制 Base URL、Key、模型名。
4. 打开 Cursor：`Settings -> Cursor Settings -> Models`
5. 填入 OpenAI API Key。
6. Override OpenAI Base URL 填入 `https://api.4stoken.cn/v1`。
7. 在模型下拉中点击 Add Models，输入 `spt-*` 或 `openrouter-free`，按 Enter 添加并启用。

## 截图操作指南

### 截图 1：配置 URL 和 Key

1. 打开 Cursor：`Settings -> Cursor Settings -> Models`。
2. 展开 **API Keys**。
3. 打开 **OpenAI API Key** 开关，把 4SToken Client Key（`sk-...`）粘贴到输入框。
4. 打开 **Override OpenAI Base URL** 开关，填入 `https://api.4stoken.cn/v1`。
5. Anthropic API Key 不需要填写；Cursor 这里走 OpenAI 兼容接口。

### 截图 2：进入 Add Models

1. 回到 Cursor 聊天或 Composer 输入框。
2. 点击当前模型名旁边的下拉箭头。
3. 在下拉菜单底部点击 **Add Models**。
4. 如看到 **Auto**，建议先关闭，避免 Cursor 自动走官方模型。

### 截图 3：输入模型 Key 并启用

1. 在 **Add or search model** 输入框输入 Cursor 模型 Key，例如 `spt-5.4`。
2. 按 Enter 添加模型。
3. 添加成功后打开该模型右侧开关。
4. 不确定该填哪个 Key 时，在 `/tools/cursor` 页面点击 **查看模型 Key 对照**，会跳到模型 Key 说明区域。

## 一键向导

```bash
curl -fsSL '{PORTAL}/docs/scripts/cursor.sh' \
  | GATEWAY_BASE_URL='https://api.4stoken.cn' bash -s -- sk-你的Key
```

`{PORTAL}` 替换为 Portal 公网地址，例如 `https://www.4stoken.cn`。

## 模型 Key 规则

- Portal 中 `gpt-5.5` 在 Cursor 里填 `spt-5.5`
- Portal 中 `gpt-5.4` 在 Cursor 里填 `spt-5.4`
- Portal 中 `gpt-5.4-mini` 在 Cursor 里填 `spt-5.4-mini`
- `openrouter-free` 直接填写，不需要改名

## 配置检查

```bash
curl -sS 'https://api.4stoken.cn/v1/models' \
  -H 'Authorization: Bearer sk-你的Key'
```

然后在 Cursor 中新建一次 Ask 或 Agent 请求，确认模型可以正常返回内容。

## 常见问题

### 401 或 403

Client Key 错误或已失效，请在 Portal Keys 页重新创建。

### 404 或路径错误

Cursor 的 Override OpenAI Base URL 必须包含 `/v1`。

### 模型不可用

确认 Add Models 填的是 Cursor 模型 Key，例如 `spt-5.5`，不是 `gpt-5.5`。

交互式步骤见 Portal：`/tools/cursor`