# Cursor 接入指南

## 基础信息

- 接入地址：`https://api.apiverse.ai/v1/support/cursor`
- API Key：控制台「API 密钥」页面创建，需开通「大模型」能力

## 注意事项

1. Cursor 需要 Pro 或企业订阅才能修改 Settings 中的自定义模型配置。
2. Cursor 以第三方模式调用，部分模型的 `tools` 调用兼容性存在差异，跑不通时请更换同系列其他模型。
3. Gemini 协议与 OpenAI Responses 协议的转写暂不支持，请使用 Chat Completions（GPT / Grok / DeepSeek 等）或 Anthropic 协议（Claude）的模型。

## 配置步骤

1. 打开 Cursor → Settings → Models，关闭所有其他模型。
2. 按各系列文档「别名（Cursor 模式）」列添加模型，例如 `fc-cc-sonnet5`、`fc-cc-opus5`、`fc-glm-52`、`fc-ds-4p`。
3. 在「Base URL」填入 `https://api.apiverse.ai/v1/support/cursor`，在「API Key」填入你的 API Key。
4. 若请求不通，先将开关关闭、重新粘贴 URL 和 Key 后再打开。

> 未在文档「别名（Cursor 模式）」列提供别名的模型不支持在 Cursor 模式下调用。

## 常见问题

| 现象 | 排查方向 |
| ---- | -------- |
| 返回 403 未开通 LLM 能力 | 在控制台重新创建并开通「大模型」能力的 API Key |
| tools 调用失败 | 第三方模式兼容性差异，换同系列其他模型重试 |
| 返回 666 | 复制响应体 `code_reason` 联系技术支持 |