> ## 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/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.