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://wrouter.ai/v1 |
點 Verify,按鈕變 ✓ 即連通。
注意 Base URL 末尾必須帶
/v1,否則 Verify 會失敗。
2. 新增自定義模型
Models 列表底部 → Add model,逐個新增:
gpt-5.5、gpt-5.4、gpt-5.4-miniclaude-fable-5、claude-sonnet-4-6、claude-opus-4-8、claude-haiku-4-5gemini-2.5-pro、gemini-2.5-flashdeepseek-v4-flash、deepseek-v4-proqwen3-coder
新增後開關開啟。可同時關閉不會使用的 Cursor 預設模型,避免誤用計費。
驗證
- 任意開啟一個工程,
Cmd L(Chat) /Cmd I(Composer) - 右下角模型選擇器 → 選
claude-sonnet-4-6 - 提問 "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:
- 設定 → Cursor Tab 關閉
- 設定 → 退出 Cursor 賬戶登入
- 注意:以上操作會失去 Tab 補全這一 Cursor 核心特性
故障排查
| 現象 | 可能原因 | 處理 |
|---|---|---|
| Verify 按鈕報 401 | Token 錯誤 | 控制台核對,注意 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 |
相關
- Cursor 官方設定文件:https://docs.cursor.com
- WRouter API 參考:Chat Completions