⌘K

Cursor

概述

Cursor 是基于 VS Code 体验改造的 AI 编辑器。它适合作为代码编辑环境, 但近期版本对第三方 API provider 的支持存在明显限制：Tab 补全、Background Agent、Auto 模式和部分内置模型选择逻辑并不会稳定读取自定义 Base URL。

因此, Vtrix 对 Cursor 的建议是：把 Cursor 当作编辑器使用, 在 Cursor 内置终端中运行 Codex 或 Claude Code；如果你的 Cursor 版本仍保留 OpenAI API Key 和 Base URL override, 可以尝试只给 Cursor Chat 配置 Vtrix。

不要把 Cursor 当作完整 Agent 接入

Cursor 的内联补全、Background Agent 和 Auto 模式可能绕过第三方配置。本文只说明可尝试的 Chat 配置和推荐替代流程, 不承诺 Cursor 全部 AI 功能都会走 Vtrix。

环境要求

  • Cursor
  • Vtrix API Key, 在 设置 中创建
  • Vtrix OpenAI 兼容模型, 例如 gpt-5.5 或 gpt-5.3-codex
可选：使用 Vtrix Doctor

可以先使用 Vtrix Doctor 检查 Cursor 相关配置和本机环境。Cursor 当前仅支持扫描和配置检查, 不支持 Doctor 一键写入或修复。

推荐用法

1

把 Cursor 作为编辑器

继续用 Cursor 打开项目、浏览代码、编辑文件。不要依赖 Cursor 自带 Tab 补全或 Background Agent 来验证 Vtrix 接入是否生效。

2

在 Cursor 内置终端中运行 Agent CLI

打开 Cursor 内置终端, 在项目目录中运行已接入 Vtrix 的 CLI 工具：

# 使用 Codex
codex

# 或使用 Claude Code
claude

Codex 和 Claude Code 会读取当前项目目录, 直接编辑文件并运行命令。Cursor 负责编辑体验, Agent CLI 负责模型调用和任务执行。

3

按需复用已有指南

这条路径更稳定, 因为配置文件和 Base URL 都由对应 CLI 明确读取, 不依赖 Cursor 内部的模型路由策略。

可尝试的 Cursor Chat 配置

如果你的 Cursor 版本仍显示 OpenAI API Key 和 Base URL override, 可以尝试以下配置。不同版本入口名称可能不同。

1

打开 Cursor 模型设置

进入 Cursor Settings, 找到 Models 或 API Keys 相关设置页。

2

填写 Vtrix OpenAI 兼容入口

在 OpenAI 相关配置中填写：

OpenAI API Key: YOUR_VTRIX_API_KEY
Override OpenAI Base URL: https://cloud.vtrix.ai/llm/openai/v1

如果设置页允许添加自定义模型, 添加 Vtrix 模型 ID：

gpt-5.5
gpt-5.3-codex
qwen3.7-max
3

关闭 Auto 并手动选择模型

在 Chat 中不要选择 Auto。手动选择刚添加的模型, 然后发送一条简单消息验证。

如果 Cursor 仍然强制使用官方模型、无法选择自定义模型, 或提示当前版本不支持第三方 provider, 请改用上面的推荐用法。

已知限制

功能状态说明
Cursor Chat可尝试取决于当前版本是否保留 OpenAI API Key 和 Base URL override
Tab 补全不建议常被 Cursor 官方模型链路接管, 不稳定读取第三方配置
Background Agent不建议第三方 provider 支持受限
Auto 模式不建议可能绕过自定义 Base URL 并回退到官方模型
Doctor 一键配置暂不支持Vtrix Doctor 只做扫描和配置检查

故障排查

Cursor 找不到自定义模型

原因： 当前 Cursor 版本没有开放自定义模型列表, 或 Chat 仍在使用 Auto 模式.

处理： 关闭 Auto, 手动选择模型。如果仍不能选择, 改用 Cursor 内置终端中的 Codex 或 Claude Code.

Tab 补全没有走 Vtrix

原因： Cursor 的 Tab 补全通常由官方模型链路提供, 不等同于 Chat 的 OpenAI API 配置.

处理： 不要用 Tab 补全判断 Vtrix 配置是否生效。需要稳定 Agent 能力时, 使用 Codex 或 Claude Code.

报错：401 Unauthorized

原因： API Key 填写错误, 或 Cursor 没有把该 Key 用在当前 Chat 请求中.

处理： 重新复制 Vtrix API Key, 确认 Base URL 为 https://cloud.vtrix.ai/llm/openai/v1, 并手动选择 Vtrix 模型.

Doctor 显示 Cursor 不能自动修复

原因： Cursor 的配置入口和版本行为不稳定, Vtrix Doctor 当前不会自动写入 Cursor 设置.

处理： 使用 agent-doctor check cursor 做只读检查；需要稳定配置时, 优先配置 Codex 或 Claude Code.