Skip to Content

Cursor 配置

Cursor  是一款內建 AI 的程式碼編輯器,支援自訂 API 提供商。透過配置 OfoxAI,你可以在 Cursor 中使用 Claude、GPT-4o、Gemini 等 100+ 模型,無需單獨訂閱各家服務。

前提條件

Cursor 免費版僅支援 Auto 模式,無法使用自訂模型。配置 OfoxAI 需要訂閱 Cursor Pro 及以上套餐

配置步驟

第 1 步:開啟模型設定

點擊右上角 齒輪圖示Cursor Settings → 左側選擇 Models(如下圖標注 ①)。

也可使用快速鍵 Cmd + ,(macOS)/ Ctrl + ,(Windows/Linux)直接開啟設定,然後切換到 Models 標籤頁。

第 2 步:填寫 API Key 並開啟開關

在 Models 頁面,找到 OpenAI API Key 區域,先開啟右側的開關(toggle ON),再將你的 OfoxAI API Key 貼上到輸入框中(如下圖標注 ②)。

OfoxAI 的 API Key 可以直接填入 Cursor 的 OpenAI API Key 欄位,因為 OfoxAI 完全相容 OpenAI 協議。

第 3 步:填寫 Base URL 並開啟開關

在同一頁面,找到 Override OpenAI Base URL 選項,先開啟右側的開關(toggle ON),再填入 OfoxAI 的 API 位址(如下圖標注 ③)。

兩項配置匯總如下:

配置項
OpenAI API Key(開關打開)你的 OfoxAI API Key
Override OpenAI Base URL(開關打開)https://api.ofox.ai/v1

Cursor Models 配置介面

上圖中 Base URL 為示例位址,請填寫 OfoxAI 的位址:https://api.ofox.ai/v1

第 4 步:新增自訂模型

Model Names 區域,點擊 Add or search model 輸入框(如上圖標注 ④),依次新增你想使用的模型:

anthropic/claude-sonnet-4.6 anthropic/claude-opus-4.6 openai/gpt-4o openai/gpt-4o-mini google/gemini-3.1-flash-lite-preview

Cursor 預設的模型名稱(如 gpt-4oclaude-3-5-sonnet)不適用於 OfoxAI。請務必使用 OfoxAI 格式的模型 ID,如 openai/gpt-4oanthropic/claude-sonnet-4.6

第 5 步:驗證配置

開啟 AI 聊天視窗(Cmd+L / Ctrl+L),關閉 Auto 模式,然後在模型下拉選單中選擇剛新增的模型,發送一條測試訊息:

你好,請介紹一下你自己。

如果收到正常回覆,說明配置成功。

推薦模型

模型 ID適用場景
anthropic/claude-sonnet-4.6程式碼生成與重構,綜合能力強
anthropic/claude-opus-4.6複雜架構分析,頂級能力
openai/gpt-4o通用程式設計助手
openai/gpt-4o-mini快速補全,成本低
google/gemini-3.1-flash-lite-preview高頻使用,速度快

完整模型清單參見 模型目錄 

常見問題

Q:點擊 Verify 提示「Invalid API Key」

檢查以下幾點:

  1. API Key 是否從 OfoxAI 控制台  完整複製(注意不要有前後空格)
  2. Base URL 是否正確填寫為 https://api.ofox.ai/v1(末尾不加斜線)
  3. OpenAI API Key 和 Override OpenAI Base URL 右側的開關是否都已開啟

Q:新增的模型在聊天面板看不到

在聊天面板中關閉 Auto 模式,才能在模型下拉清單中看到自訂新增的模型。

Q:報錯「The model does not work with your current plan」

此錯誤表示目前 Cursor 套餐不支援自訂模型。需要升級到 Cursor Pro 套餐才能使用自訂 API 提供商。

Q:程式碼補全不生效,只有聊天可用

Cursor 的內嵌補全(Tab 補全)預設使用 Cursor 自己的模型。自訂模型主要用於 AI Chat(Cmd+L)和 Composer(Cmd+I)功能。

Last updated on