Anysphere · IDE

Cursor

Cursor 支持为 OpenAI 兼容端点自带密钥（BYOK）。在 Settings → Models 中粘贴你的 NextModel 密钥，并把 OpenAI 提供商的 Base URL 指向 NextModel，OpenAI 格式的请求就会发往 NextModel。

快速开始

  1. 获取你的 NextModel API 密钥

    在 NextModel 控制台创建密钥，保留这个页面——下一步要粘贴进 Cursor。

  2. 在 Settings 中把 Cursor 指向 NextModel

    Cursor Settings → Models：把你的 NextModel 密钥粘贴到 OpenAI 字段并点击 Save。要让 OpenAI 格式的请求发往 NextModel，在同一面板打开 Override OpenAI Base URL 开关，填入 https://api.nextmodel.app/v1，再把 claude-sonnet-4-5 登记为自定义模型。不同 Cursor 版本中控件名称可能略有差异。

    官方文档

  3. 用一次请求确认端点可用

    返回 JSON 就说明地址、密钥和模型都对得上——Cursor 里填的正是同一组值。

    Shell
    curl "https://api.nextmodel.app/v1/chat/completions" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"model": "claude-sonnet-4-5", "messages": [{"role": "user", "content": "ping"}]}'

  4. 在 Composer 中选择 claude-sonnet-4-5

    打开 Composer 或聊天面板的模型选择器，选中刚添加的模型。

示例提示词

提示词保持英文以获最佳效果

提示词
Add input validation to the signup form and generate unit tests for it.
Explain what this component renders, then simplify it without changing behavior.

常见问题

有没有可以直接改的 settings.json？

Cursor 官方文档只提供 Settings → Models 面板这一种自定义密钥的配置方式，请以该界面为准。

自定义密钥会影响 Cursor 的内置功能吗？

按 Cursor 官方文档，自定义 API 密钥仅适用于 chat 模型——Tab 补全仍使用 Cursor 的内置模型。

哪些模型 ID 可以用？

端点提供的任何 chat 模型 ID 都可以，本指南用 claude-sonnet-4-5。配置完成后，模型会出现在 Cursor 的模型选择器中。

故障排除

Cursor 里密钥或端点检查失败

先确认 Base URL 以 /v1 结尾，再把同一个密钥粘到第 3 步的 curl 里，区分是密钥错了还是 URL 错了。

覆盖之后模型不出现

覆盖会替换 Cursor 内置的 OpenAI 模型目录。在 OpenAI 提供商下把 claude-sonnet-4-5 登记为自定义模型，再到模型选择器中选中它。

其他 Agent

CLIOpenAI

Codex CLI

OpenAI 的终端编程代理，指向 NextModel。

Codex CLI 从 ~/.codex/config.toml 读取模型提供商配置。添加一个指向 NextModel 端点的 provider 并导出密钥，之后每次 codex 调用都会经过 NextModel。

Codex CLI
IDECline

Cline

VS Code 里的自主编程代理，用你自己的密钥。

Cline 是一个 VS Code 扩展，会在每一步征求你的确认后规划和修改代码。它的 OpenAI Compatible provider 接受任意端点，填一张表就能接上 NextModel。

Cline
桌面端Cherry Studio

Cherry Studio

开箱即说 OpenAI 的桌面聊天客户端。

Cherry Studio 把模型提供商作为服务来管理。把 NextModel 作为 OpenAI 兼容服务添加一次，它就会出现在你已有的服务列表旁边。

Cherry Studio
SDKOpenAI

OpenAI SDK

任意 OpenAI SDK，只差一个 base_url。

官方 OpenAI SDK（Python 和 Node）都接受自定义端点。把 base_url 设为你的 NextModel 端点、密钥放在环境变量里，其余代码保持不变。

OpenAI SDK