Cursor 配置

1. Cursor 是什麼，以及開始前需要準備什麼

Cursor 是基於 VS Code 的 AI IDE，可以在編輯器中完成聊天、代碼生成、修改和解釋等常見開發操作。

在通過 RouteAPI 接入 Cursor 之前，建議先準備好：

已安裝並可正常登錄的 Cursor 桌面應用
你的 RouteAPI 密鑰
RouteAPI 控制台中可用的 OpenAI 協議標準聊天模型
RouteAPI 的 OpenAI-compatible 接入地址 https://www.routeapi.ai/v1

2. 安裝並打開模型設置

安裝並登錄 Cursor

從 Cursor 官網安裝桌面版應用，並使用你的 Cursor 賬號登錄。

打開 `Cursor Settings` > `Models`

在 Cursor 中打開設置頁面，然後進入 Models。

3. 配置 RouteAPI

3.1 填寫 OpenAI provider 的接入信息

在 Models 頁面中找到 OpenAI 相關配置項。不同 Cursor 版本的字段名稱可能略有差異，但你需要填寫的核心信息是：

OpenAI API Key：你的 RouteAPI 密鑰
OpenAI Base URL：https://www.routeapi.ai/v1

填寫完成後，點擊 Verify。

3.2 選擇模型

驗證通過後，打開 Cursor 的模型選擇器，選擇 RouteAPI 返回的可用 OpenAI-compatible 模型。

更穩妥的做法是：

優先選擇 RouteAPI 控制台裡標註為 OpenAI 協議、適合聊天或編碼的標準模型
不要優先選擇 reasoning 模型，因為 Cursor 官方文檔明確說明 OpenAI 自定義 API key 僅支持標準、非 reasoning 聊天模型

3.3 開始使用

完成配置後，你可以在 Cursor 的 Chat 或 Composer 中直接使用 RouteAPI 提供的模型。

4. 注意事項

自定義 API key 方案主要影響 Chat / Composer 這類標準聊天模型能力，不會替代 Cursor 的全部內置能力
如果你開啟的是 Tab Completion、某些 Agent 能力或其他需要專用模型的功能，仍可能繼續使用 Cursor 自帶模型
根據 Cursor 官方 FAQ，API key 不會被存儲，但每次請求仍會發送到 Cursor 的服務器，由其完成最終 prompt 組裝

5. 常見排查

Verify 失敗時，先檢查 API key 是否正確，以及地址是否填寫為 https://www.routeapi.ai/v1
如果模型列表沒有出現你期望的模型，先檢查該模型是否支持 OpenAI 協議，並確認它是標準聊天模型而不是 reasoning 模型
如果你已經更新了 key 或地址，但 Cursor 仍顯示舊狀態，可以關閉並重新打開 Cursor，再次 Verify
如果你需要終端中的編碼代理接入方式，也可以參考 Codex 配置文檔、Claude 配置文檔和 OpenCode 配置文檔