# Cursor 安装与接入 4SToken

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


## 安装前准备

1. 已安装 Cursor。
2. 已创建 Portal Client Key。
3. 准备一个可用模型名，例如 `spt-5.5`、`spt-5.4`、`openrouter-free`。
4. 确认 OpenAI 兼容 Base URL：`https://api.4stoken.cn/api/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/api/v1`。
7. Add Custom Model，填入 `spt-*` 或 `openrouter-free`。

## 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/api/v1`。
7. Add Custom Model，填入 `spt-*` 或 `openrouter-free`。

## 一键向导

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

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

## 模型命名规则

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

## 配置检查

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

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

## 常见问题

### 401 或 403

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

### 404 或路径错误

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

### 模型不可用

确认 Add Custom Model 填的是 Cursor 名称，例如 `spt-5.5`，不是 `gpt-5.5`。

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