在 Cursor 中接入 Nbility 后，你可以直接在编辑器里使用 GPT、Claude 等模型完成对话、改代码、解释报错和辅助开发。
如果你还没有账号和令牌，建议先阅读 快速开始。
一、准备工作
开始之前，请先确认你已经具备下面几项：
- 已注册 Nbility 账号
- 已登录 Nbility 控制台
- 已创建可用令牌
- 令牌中有足够余额
如果这些还没完成，先去 注册页面 和控制台完成准备。
二、打开 Cursor 设置
启动 Cursor，进入设置页面。
如果你是第一次配置，建议直接搜索 Models，这样能更快进入模型和 API 的相关选项。
三、进入 Models 配置页
在 Cursor 设置中找到 Models 区域。
这一页通常会包含模型开关、OpenAI API Key、Base URL 等配置项。Nbility 接入主要就是在这里完成。
四、填写 API 信息
在 OpenAI 相关配置中，填写以下内容：
OpenAI API Key：你在 Nbility 控制台创建的令牌Override OpenAI Base URL：https://api.nbility.dev/v1
如果 Cursor 要求你先启用自定义模型或 OpenAI 兼容接口，按提示开启即可。
五、选择要使用的模型
填写好 Key 和 Base URL 后，就可以在 Cursor 中启用你需要的模型。
常见思路是：
- 想用 GPT 系列：准备
codex或相关 GPT 分组令牌 - 想用 Claude 系列：准备
claude或claude-mix分组令牌 - 想试 Gemini：准备对应 Gemini 分组令牌
如果当前令牌只属于某个分组，那么它只能访问该分组支持的模型。这是正常现象，不是配置错误。
六、验证是否接入成功
配置完成后，建议立即做一次最简单的验证：
- 新建一个空白对话或打开任意项目
- 在 Cursor 中选择一个已启用模型
- 输入一句简单提示词，例如“你好，请介绍一下你自己”
- 观察是否能正常返回结果
如果可以正常回复，说明 Cursor 已经成功接入 Nbility。
七、常见问题
1. 提示 Key 无效
优先检查：
- 令牌是否复制完整
- 是否误填了空格
- 是否使用了已经删除或禁用的令牌
建议回到 控制台令牌页面 重新创建一个新令牌测试。
2. 能填上去，但请求失败
优先检查：
- Base URL 是否写成了
https://api.nbility.dev/v1 - 当前网络或代理环境是否影响 Cursor 请求
- 令牌余额是否充足
如果你电脑开着代理软件，建议先退出代理，再重启 Cursor 重试。
3. 找不到想用的模型
这通常不是 Cursor 坏了，而是当前令牌分组不支持该模型。
你可以新建一个对应分组的令牌，再回到 Cursor 中切换使用。
八、使用建议
- 建议给 Cursor 单独创建一个令牌，方便统计消耗
- 初期先用一个分组跑通流程，不要一次配太多模型
- 如果你经常切换模型，可以按工具或用途拆分多个令牌
完成后，你也可以继续查看：