Cursor 自定义配置

本文档说明如何在 Cursor 中使用自定义 OpenAI 兼容配置接入当前服务。

不同版本的 Cursor，设置项名称可能略有差异，但核心思路一致：把 OpenAI 的 API Key 和 Base URL 改成你自己的网关配置。

1. 打开模型设置

打开 Cursor Settings，进入 Models 相关设置。

如果你当前版本带有自定义 OpenAI 配置，通常会看到类似这些字段：

• OpenAI API Key
• OpenAI Base URL
• Custom Base URL
• Override OpenAI Base URL

2. 填写连接信息

按当前服务填写：

• Base URL：https://okapi.pockgo.com/v1
• API Key：你的 codex_... Key
• Model ID：以 GET /v1/models 返回结果为准；如果只是先测连通性，可先试 gpt-5.4

3. 验证

保存后，点击 Verify，或者直接新建一个会话测试。

如果能正常开始对话，说明自定义配置已经生效。

说明

• Base URL 要填写 OpenAI 兼容根路径，也就是 <ApiBaseUrl />
• 不要写成 /v1/chat/completions 或 /v1/responses 的完整接口路径
• 如果你的 Cursor 版本只支持填官方 OpenAI API Key，但没有自定义 Base URL，那么它不能直接改到当前网关
• Cursor 官方 API Key 说明页：https://docs.cursor.com/advanced/api-keys
• 按 Cursor 官方文档，自定义 API Key 主要用于标准聊天模型；某些依赖 Cursor 内建模型的功能不会走这条自定义链路