更新于 2026-04-14
Cursor + ModelServer 配置指南
Cursor 默认走 Cursor 自家 API，订阅制按月收费，中国网络环境下偶尔抖动。通过 ModelServer 的 OpenAI 兼容端点，你能**按用量付费**、用自己的 Claude / GPT / DeepSeek 配额，还能走支付宝充值。
为什么用 Cursor + ModelServer
- 不想付 $20/月 Cursor 订阅
- 需要用 Claude Sonnet / Opus（Cursor 免费版不给）
- 中国开发者：支付宝充值
- 重度用户：按 token 计费反而更省
配置步骤
1. 获取 ModelServer API Key
登录 modelserver.dev，进 API Keys 页面创建 sk-... 密钥。
2. 打开 Cursor Settings
快捷键 ⌘ + ,（macOS）/ Ctrl + ,（Windows/Linux）→ 搜 "Models" → 滚到 OpenAI API Key 区域。
3. 覆盖 OpenAI Base URL
- 展开 "OpenAI API Key" 区块，点击 "Override OpenAI Base URL"
- 填入
https://modelserver.dev/v1（**要带 /v1**） - OpenAI API Key 填你的
sk-...ModelServer key - 点击 "Verify" 测试连通
- 打开下方 "Custom models" 开关
4. 添加自定义模型
在 "Custom models" 文本框里加你想用的模型 ID，每行一个：
Custom models
claude-opus-4-6
claude-sonnet-4-6
claude-haiku-4-5
gpt-5
deepseek-v3
gemini-2.5-pro完成后在 Cursor 的 Chat 下拉里就能选这些模型了。
Cursor 的 base URL 要带 /v1
这跟 Claude Code 不一样。Cursor 要求完整的
/v1 路径作为 base，而 Anthropic SDK / Claude Code 则不能带。每个工具的约定不同，照文档即可。验证
打开一个代码文件，按 ⌘ + L 打开 Chat，确认顶部模型下拉能选到你刚配的模型，问一句话看有无回答即成功。
常见问题
Cursor Composer / Tab 功能还能用吗？
Composer 可用（走你配置的 OpenAI 兼容端点）。Tab 自动补全是 Cursor 自家小模型，必须订阅才能用，ModelServer 不能替代。
为什么 Chat 里选不到我的自定义模型？
先确认 "Custom models" 开关是开的，且模型 ID 拼写正确。Cursor 只识别英文半角字符，不能有中文引号。
报 "connection failed"？
99% 是 base URL 写成了 https://modelserver.dev（缺 /v1）或 https://modelserver.dev/v1/（多了尾斜杠）。标准写法：https://modelserver.dev/v1。