Cursor

Cursor 是基于 VS Code 的 AI 原生 IDE，支持自定义 OpenAI-compatible 端点。

安装

去 cursor.com 下载对应平台安装包。

配置 Shuro

打开 Cursor → Cmd/Ctrl + , → 「Cursor Settings」 → 「Models」

添加自定义 OpenAI 端点

找到「OpenAI API Key」区块
点「Override OpenAI Base URL」
填：

https://shuro.vip/v1

必须带 /v1

Cursor 是 OpenAI 兼容协议，base_url 需要带 /v1 后缀。

API Key 填你的 sk-...
点「Verify」按钮验证

添加自定义模型

Cursor 默认只列出 OpenAI 自家的模型。要用 Claude 模型，需要手动添加：

「Models」面板 → 「Add model」 → 输入：

claude-opus-4-8
claude-opus-4-7
claude-fable-5
claude-sonnet-4-6
claude-haiku-4-5-20251001

每行一个。

同 key 双协议

Shuro 同一把 key 既能调 OpenAI 风格的 /v1/chat/completions（Cursor 用），也能调 Anthropic 风格的 /v1/messages（Claude Code 用）。不用为不同客户端单独申请 key。

使用

快捷键	作用
`Cmd/Ctrl + K`	行内编辑
`Cmd/Ctrl + L`	Chat 面板
`Cmd/Ctrl + I`	Composer（多文件编辑）

常见问题

Verify 验证失败

错误	解决
401	Key 错或失效 → 见 401 排查
404	base_url 漏了 `/v1`
Verify 一直转圈	网络问题 / 切换 Provider 验证后立即用

提示 "Model not available"

Cursor 没看到你添加的模型。重启 Cursor 后再试。

Composer 在 Claude 模型上失败

Cursor 的 Composer 功能用了 OpenAI 特定的 prompt 模板。换成 GPT 系列（gpt-5.5 / gpt-5.4）可能更稳定。

配合 Shuro 的最优配置

Base URL: https://shuro.vip/v1
Default Model: claude-opus-4-7
Composer Model: gpt-5.5  (推荐)
Fast Apply Model: claude-haiku-4-5-20251001  (省钱)

「Fast Apply」是 Cursor 用小模型快速应用 patch 的功能，用 Haiku 比 Opus 省 15 倍。

Cursor ​

安装 ​

配置 Shuro ​

添加自定义 OpenAI 端点 ​

添加自定义模型 ​

使用 ​

常见问题 ​

Verify 验证失败 ​

提示 "Model not available" ​

Composer 在 Claude 模型上失败 ​

配合 Shuro 的最优配置 ​