> ## Documentation Index
> Fetch the complete documentation index at: https://docs.teamsoclo.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Cursor

> 在 Cursor 中覆蓋 OpenAI Base URL

<Steps>
  <Step title="開啟 Settings → Models">
    按 `Ctrl + Shift + J`（macOS：`Cmd + Shift + J`）開啟 Cursor Settings，選擇 **Models** 標籤。
  </Step>

  <Step title="填寫 Base URL 和 Key">
    滾動到 **OpenAI API Key**：

    1. 開啟 **Override OpenAI Base URL**
    2. 貼上 Base URL：

    ```
    https://gpt.teamsoclo.site/v1
    ```

    3. 把 API Key 粘到 Key 輸入框
    4. 點選 **Verify**

    Verify 成功即表示連線正常。
  </Step>

  <Step title="新增模型並關閉預設模型">
    點選 **+ Add model**，輸入你套餐對應的準確模型名：

    ```
    gpt-5.6-sol
    ```

    Astra 套餐輸入 `gpt-astra`。然後**關閉所有預設模型**（gpt-4o、claude...、o1...），只保留剛新增的這個。
  </Step>
</Steps>

<Warning>
  必須關閉預設模型。若保持開啟，Cursor 仍會用你的 Key 請求真正的 OpenAI 並報 Key 無效，你會誤以為配置錯了，其實只是選錯了模型。
</Warning>

<Warning>
  模型名錯一個字元就會立即報錯。請從 [模型表](/zh-tw/models) 複製，不要手打。
</Warning>

<Tip>
  Cursor 會隱式傳送大量上下文。想省 Token，在 Settings 中關閉 **Codebase Indexing**，並用 `@file` 指定要改的檔案，不要讓它掃描整個專案。
</Tip>

## 不可用的功能

Tab 補全與 Composer Agent 執行在 Cursor 自己的基礎設施上，不經過你設定的 Base URL。Key 只作用於 **Chat** 面板和你手動新增的模型。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.