Skip to main content

​
一、產品簡介

Cursor 是一款 AI 驅動的程式碼編輯器，通過集成 Mixroute Api，可在編寫程式碼時獲得強大的 AI 輔助功能，支援智能程式碼生成、補全、解釋及優化。Mixroute Api 現已兼容 Cursor 的 Agent 能力（Auto Apply / 多文件編輯等），配置得當即可啟用。

​
二、快速配置步驟

重要提示：目前 Cursor 官方限制，使用第三方 API Key（包括 Mixroute Api）需要滿足以下條件：
  • 必須開通 Pro Plan（付費訂閱），Free Plan 無法使用第三方 API Key
  • 需要配置科學上網（VPN/代理）才能正常連接第三方 API 服務
  • 這是 Cursor 官方的政策限制，並非 Mixroute Api 的限制

​
1. 打開設定

點擊右上角的齒輪圖標 ⚙️，選擇 Models 選項。

​
2. 配置 API

  • OpenAI API Key：輸入您的 Mixroute Api 密鑰
  • Override OpenAI Base URL：勾選並輸入 https://console.mixroute.io/v1
  • 點擊 Verify 驗證配置
  • GPT 系列模型需在模型名加前綴 openai/，例如使用 gpt-5.2 時需填寫 openai/gpt-5.2。其餘渠道按原模型 ID 配置。
  • Mixroute Api 已兼容 Cursor Agent（Auto Apply 等）。若希望啟用 Agent，請在模型選擇中使用支援 Agent 的模型。

​
3. Agent 模式使用提示

  • 使用支援 Agent 的模型（如 Claude、DeepSeek、Grok、以及帶 openai/ 前綴的 GPT 系列等）
  • 確保 Base URL 為 https://console.mixroute.io/v1
  • 首次啟用時可在 Cursor 側邊欄執行一次簡單改動驗證自動應用
  • 若模型不支援 Agent，可改為 Chat 方式手動 Apply

​
三、推薦模型配置

類型推薦模型 ID特點
程式首選claude-sonnet-4-20250514Claude 4 Sonnet，程式能力最強
gpt-4.1速度快，綜合能力強
deepseek-v3中文程式優秀，性價比高
成本優化gpt-4.1-mini輕量級但能力不俗
claude-3-haikuClaude 系列最便宜
gemini-2.5-flashGoogle 快速回應模型
推理增強o4-mini程式任務首選推理模型
o3-mini適合複雜推理和算法問題

​
添加自訂模型

在 Cursor 設定中添加： 
claude-sonnet-4-20250514
gpt-4.1
deepseek-v3
o4-mini
gemini-2.5-pro

​
四、使用模式說明

​
Chat 模式工作流程

  1. 對話生成程式碼：Ctrl/Cmd + L 打開聊天窗口，描述需求
  2. 手動應用程式碼：複製程式碼貼到目標文件，或使用 “Apply” 按鈕
  3. 迭代優化：繼續對話要求修改

​
替代方案對比

工具Agent 模式優勢劣勢
Cursor❌界面優雅，補全體驗好無 Agent 模式
Cline (VS Code)✅完整 Agent 功能需依賴 VS Code
RooCode (VS Code)✅支援多文件編輯較新，功能完善中
Continue (VS Code)✅開源，可定製性強配置較複雜

​
五、核心功能

​
智能程式碼補全

  • Tab 補全：按 Tab 接受 AI 建議
  • 多行補全：支援函數級別程式碼生成
  • 上下文感知：基於專案結構提供精準建議

​
AI 對話

  • Ctrl/Cmd + K：打開命令面板
  • Ctrl/Cmd + L：打開側邊欄對話
  • 程式碼解釋：選中程式碼後詢問 AI

​
程式碼編輯

  • 生成程式碼：描述需求，AI 自動生成
  • 重構建議：獲取程式碼優化方案
  • 錯誤修復：AI 協助定位修復錯誤

​
六、快捷鍵

快捷鍵功能
Ctrl/Cmd + K打開 AI 命令面板
Ctrl/Cmd + L打開 AI 對話側邊欄
Tab接受程式碼建議
Esc取消當前建議

​
七、使用技巧

​
提供清晰的上下文

// @context: React組件，用於用戶認證
// @requirements: 需要支援OAuth2登入
// @constraints: 兼容NextJS 13+

​
優化提示詞

  • 不佳："修復這個函數"
  • 優質："修復calculateTotal函數中的浮點數精度問題，確保金額計算準確到小數點後兩位"

​
八、故障排除

  • 檢查網路連接
  • 確認 API 地址為 https://console.mixroute.io/v1
  • 驗證 API 密鑰有效性
  • 檢查帳戶餘額
  • 嘗試切換其他模型
  • 重啟 Cursor 客戶端
  • 提供更多專案上下文
  • 使用更具體的提示詞
  • 切換性能更優的模型

​
九、最佳實踐

​
專案級配置

在專案根目錄創建 .cursor-settings.json： 
{
  "model": "gpt-4.1",
  "temperature": 0.7,
  "contextFiles": ["README.md", "package.json"],
  "rules": [
    "使用TypeScript嚴格模式",
    "遵循ESLint規範",
    "添加適當的註釋"
  ]
}

​
程式碼審查

請審查這段程式碼，關注：
1. 性能問題
2. 安全漏洞
3. 程式碼規範
4. 最佳實踐

​
十、關於 Agent 模式

若需要 AI 自動修改多文件、執行複雜重構任務，推薦：
  • Cline：VS Code 插件，支援完整 Agent 功能
  • RooCode：新興 VS Code AI Agent 插件