Cursor

Cursor 是基于 VS Code 的 AI 代码编辑器。Cursor 自带订阅账户体系，但允许把 Chat / Composer / Agent 模式的请求转发到自定义 OpenAI 兼容端点 —— 这正是接入 wrouter 的入口。

前置要求

项	要求
Cursor	≥ 0.42（设置项位置以最新版为准）
wrouter	一把可用 Token

配置

打开 Settings（Cmd , / Ctrl ,） → 左侧 Models：

1. 设置 OpenAI 兼容端点

页面底部 OpenAI API Key 区块：

字段	值
OpenAI API Key	sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Override OpenAI Base URL	https://api.wrouter.io/v1

点 Verify，按钮变 ✓ 即连通。

注意 Base URL 末尾必须带 /v1，否则 Verify 会失败。

2. 添加自定义模型

Models 列表底部 → Add model，逐个添加：

• gpt-5、gpt-4o、gpt-4o-mini
• claude-sonnet-4-5、claude-opus-4-1、claude-haiku-4-5
• gemini-2.5-pro、gemini-2.5-flash
• deepseek-chat、deepseek-reasoner
• qwen3-coder

添加后开关打开。可同时关闭不会使用的 Cursor 默认模型，避免误用计费。

验证

1. 任意打开一个工程，Cmd L（Chat） / Cmd I（Composer）
2. 右下角模型选择器 → 选 claude-sonnet-4-5
3. 提问 "Summarize this repo" 应能正常返回

推荐模型

模型	推荐场景
claude-sonnet-4-5	日常 Chat / Composer 主力
claude-opus-4-1	大改、复杂重构
gpt-5	推理密集型任务、深度调试
qwen3-coder	国内网络场景的代码生成补充
gemini-2.5-flash	长上下文（1M）扫码、批量改写

已知限制（重要）

Cursor 的部分功能不会走自定义端点，仍使用 Cursor 官方账户调用 Cursor 自有模型：

功能	是否走 wrouter
Chat、Composer、Agent	✓ 走
Cmd K 内联编辑	✓ 走
Tab 自动补全	✗ 不走（Cursor 自研 cursor-small）
Apply / Smart Rewrite	✗ 不走
Bug Finder / Codebase Index	✗ 不走

如果你希望 Cursor 完全不调用官方 API：

1. 设置 → Cursor Tab 关闭
2. 设置 → 退出 Cursor 账户登录
3. 注意：以上操作会失去 Tab 补全这一 Cursor 核心特性

故障排查

现象	可能原因	处理
Verify 按钮报 401	Token 错误	控制台核对，注意 sk- 完整复制
Verify 报 404 / 超时	Base URL 没带 /v1	改为 https://api.wrouter.io/v1
模型选择器找不到 wrouter 模型	没在 Models 里添加	回到 Models 页 Add model
选了模型但仍报错 "model not found"	该模型 ID 与上游不匹配	访问 https://wrouter.io/models 确认拼写
图像消息没反应	该模型不支持视觉	改用 gpt-4o / claude-sonnet-4-5 / gemini-2.5-pro

相关

• Cursor 官方设置文档：https://docs.cursor.com
• wrouter API 参考：Chat Completions