Skip to main content

一、產品簡介

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

二、快速配置步驟

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

1. 打開設定

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

2. 配置 API

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

3. Agent 模式使用提示

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

三、模型配置

添加自訂模型

在 Cursor 設定中添加:

四、使用模式說明

Chat 模式工作流程

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

替代方案對比

五、核心功能

智能程式碼補全

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

AI 對話

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

程式碼編輯

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

六、快捷鍵

七、使用技巧

提供清晰的上下文

優化提示詞

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

八、故障排除

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

九、最佳實踐

專案級配置

在專案根目錄創建 .cursor-settings.json

程式碼審查

十、關於 Agent 模式

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