Skip to content

Cursor

Cursor 是基於 VS Code 的 AI 程式碼編輯器。Cursor 自帶訂閱賬戶體系,但允許把 Chat / Composer / Agent 模式的請求轉發到自定義 OpenAI 相容端點 —— 這正是接入 WRouter 的入口。

前置要求

要求
Cursor≥ 0.42(設定項位置以最新版為準)
WRouter一把可用 Token

配置

開啟 SettingsCmd , / Ctrl ,) → 左側 Models

1. 設定 OpenAI 相容端點

頁面底部 OpenAI API Key 區塊:

欄位
OpenAI API Keysk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Override OpenAI Base URLhttps://wrouter.ai/v1

Verify,按鈕變 ✓ 即連通。

注意 Base URL 末尾必須帶 /v1,否則 Verify 會失敗。

2. 新增自定義模型

Models 列表底部 → Add model,逐個新增:

  • gpt-5.5gpt-5.4gpt-5.4-mini
  • claude-fable-5claude-sonnet-4-6claude-opus-4-8claude-haiku-4-5
  • gemini-2.5-progemini-2.5-flash
  • deepseek-v4-flashdeepseek-v4-pro
  • qwen3-coder

新增後開關開啟。可同時關閉不會使用的 Cursor 預設模型,避免誤用計費。

驗證

  1. 任意開啟一個工程,Cmd L(Chat) / Cmd I(Composer)
  2. 右下角模型選擇器 → 選 claude-sonnet-4-6
  3. 提問 "Summarize this repo" 應能正常返回

推薦模型

模型推薦場景
claude-sonnet-4-6日常 Chat / Composer 主力
claude-opus-4-8大改、複雜重構
gpt-5.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 按鈕報 401Token 錯誤控制台核對,注意 sk- 完整複製
Verify 報 404 / 超時Base URL 沒帶 /v1改為 https://wrouter.ai/v1
模型選擇器找不到 WRouter 模型沒在 Models 裡新增回到 Models 頁 Add model
選了模型但仍報錯 "model not found"該模型 ID 與上游不匹配訪問 https://wrouter.ai/models 確認拼寫
影像訊息沒反應該模型不支援視覺改用 gpt-5.4 / claude-sonnet-4-6 / gemini-2.5-pro

相關