Agent 接入

Cursor + 星模XModel

Cursor 支持用自定义 OpenAI 兼容端点覆盖默认模型服务:在设置里填入星模XModel 的 Base URL 和你的 Key,模型列表里添加网关发布的模型 ID 即可。

IDE 插件 · 厂商:Anysphere

快速开始

分步接入

  1. 1前置条件:获取 API Key

    注册星模XModel 后,在控制台「API 密钥」页创建一个 Key。下文所有 YOUR_API_KEY 占位符都替换为你的 Key;Key 等同账户凭证,不要提交进仓库。

    打开 /docs/quickstart 文档

  2. 2打开 Cursor 设置 → Models

    在 OpenAI API 区块填入你的 Key,并点开 Override Base URL。

  3. 3覆盖 Base URL

    复制下面的地址填入 Override Base URL 输入框(必须保留末尾 /v1)。

    Base URL
    https://modelxing.com/v1
  4. 4添加模型并验证

    在模型列表添加 qwen/qwen3-coder-plus,保存后任意开一个对话验证响应。

示例提示词

配好后直接粘贴

复制任意一条发给刚配好的 Agent,验证接入是否生效。

提示词
用 qwen/qwen3-coder-plus 解释这个文件的核心逻辑,并指出两处最容易出回归的修改点。
提示词
为当前打开的组件补一组边界条件单元测试。

常见问题

FAQ

覆盖 Base URL 会影响 Cursor 自身功能吗?

模型请求会直接发到星模XModel 网关;Cursor 自家功能(Tab 补全等)是否可用以 Cursor 官方文档为准。

Key 存在哪里?

保存在 Cursor 本地设置中,请求由 Cursor 直连网关,不经过第三方。

故障排查

出问题时先看这里

连接失败或 404

确认 Override Base URL 以 /v1 结尾;Cursor 对路径拼接敏感,多一段或少一段都会失败。

模型列表为空或报模型不存在

添加的模型名必须是网关发布的模型 ID(如 qwen/qwen3-coder-plus),不是展示名。