---
title: Cursor 接入
sidebarTitle: Cursor
description: 在 Cursor 中配置海宇数科 API 与国内模型
---

# Cursor 接入

[Cursor](https://cursor.com) 支持使用 **OpenAI 兼容** 自定义接口。将 Base URL 指向海宇数科网关后，可在 Cursor 中选择控制台已上线的 **国内模型 ID** 进行补全与对话。

## 前置条件

1. 登录 [控制台](https://console.haiyushuke.com)，完成 **实名认证**  
2. 在 **API Key** 创建密钥，并确认 Key 的 **可用模型** 包含你要用的模型 ID  
3. 在 **模型广场** 复制目标模型 ID（例如 `deepseek-chat`、`glm-5.1` 等，以实际列表为准）

## 配置步骤

1. 打开 Cursor → **Settings**（设置）  
2. 进入 **Models** 或 **OpenAI API** 相关区域（版本不同菜单名可能略有差异）  
3. 填写：
   - **OpenAI API Key**：海宇控制台创建的 API Key  
   - **Override OpenAI Base URL**（或 Custom OpenAI Endpoint）：`https://api.haiyushuke.com/v1`  
4. 在模型列表中添加 **自定义模型名**，名称必须与模型广场 **模型 ID 完全一致**  
5. 保存后在新对话中选择该模型进行测试  

## 示例（settings.json 片段）

若你通过 `settings.json` 管理配置，可参考（键名以 Cursor 当前版本为准）：

```json
{
  "openai.apiKey": "YOUR_HAIYUSHUKE_API_KEY",
  "openai.baseUrl": "https://api.haiyushuke.com/v1"
}
```

自定义模型请在 Cursor 的 Models 界面添加，ID 使用控制台复制的字符串。

## 使用建议

- **不要** 使用 `gpt-4o`、`claude-sonnet` 等海外模型名；平台未提供这些模型。  
- 生产环境 Key 不要提交到 Git；可配合 Key 的 **IP 白名单**。  
- 若补全无响应，先在 **体验中心** 用同一模型 ID 验证，再查 [常见问题](/docs/faq)。  

## 相关文档

- [工具接入概览](/docs/integrations/overview)  
- [API Key 管理](/docs/guides/api_keys)  
- [计费与财务](/docs/guides/billing)