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

# 在 Cursor 和 VS Code 中配置 Sub2API

> 在 Cursor 编辑器和 VS Code AI 扩展中配置 Sub2API，在代码编辑环境中直接使用多种 AI 模型。

Cursor 和 VS Code 是目前最受欢迎的 AI 代码编辑器。你可以在 Cursor 内置的 AI 功能或 VS Code 的 AI 扩展中配置 Sub2API，直接在编写代码时调用 GPT、Claude、Gemini 等多种模型。

## 前置条件

* 已安装 Cursor 或 VS Code
* 已获取 Sub2API API Key（详见 [创建 API Key](/getting-started/create-api-key)）

<Tabs>
  <Tab title="Cursor">
    Cursor 内置了 AI 功能，支持通过 OpenAI 兼容格式连接自定义 API。

    <Steps>
      <Step title="打开 Cursor 设置">
        点击右上角齿轮图标，或按 `Cmd/Ctrl + ,` 打开设置面板。

        > 截图占位：此处可插入实际客户端配置截图
      </Step>

      <Step title="进入模型设置">
        在设置中找到「Models」或「模型」选项卡。

        > 截图占位：此处可插入实际客户端配置截图
      </Step>

      <Step title="配置 OpenAI API">
        找到 OpenAI API Key 设置项：

        * 输入你的 Sub2API API Key
        * 将「Override OpenAI Base URL」设置为 `https://sub2api.ruilinlu.com`

        > 截图占位：此处可插入实际客户端配置截图
      </Step>

      <Step title="添加自定义模型">
        如需使用特定模型，在自定义模型列表中添加模型名称，例如：

        * `gpt-4o`
        * `claude-opus-4-5`

        <Note>
          Cursor 使用 OpenAI 兼容格式调用 API。Sub2API 会自动处理不同模型的请求格式转换，你只需填写正确的模型名称即可。
        </Note>

        > 截图占位：此处可插入实际客户端配置截图
      </Step>

      <Step title="保存并测试">
        保存设置后，在编辑器中按 `Cmd/Ctrl + L` 打开 AI 面板，发送测试消息验证连接。
      </Step>
    </Steps>
  </Tab>

  <Tab title="VS Code">
    VS Code 本身不内置 AI 功能，需要通过扩展来实现。以下是使用 Continue 扩展的示例配置。

    <Steps>
      <Step title="安装 AI 扩展">
        在 VS Code 扩展市场中搜索并安装 Continue 或其他支持自定义 OpenAI 兼容 API 的扩展。

        <Note>
          TODO：请在后台确认实际配置后填写。（确认推荐的具体扩展名称及版本）
        </Note>
      </Step>

      <Step title="配置扩展">
        打开扩展的设置面板，配置自定义 API：

        <CodeGroup>
          ```json Continue 配置示例 theme={null}
          {
            "models": [
              {
                "title": "Sub2API",
                "provider": "openai",
                "model": "gpt-4o",
                "apiKey": "your_sub2api_key",
                "apiBase": "https://sub2api.ruilinlu.com"
              }
            ]
          }
          ```
        </CodeGroup>

        <Note>
          TODO：请在后台确认实际配置后填写。（具体配置格式请以所安装扩展的官方文档为准）
        </Note>

        > 截图占位：此处可插入实际客户端配置截图
      </Step>

      <Step title="测试使用">
        配置完成后，使用扩展提供的快捷键（如 `Cmd/Ctrl + L`）打开 AI 面板进行测试。
      </Step>
    </Steps>
  </Tab>
</Tabs>

## 故障排查

<Accordion title="Cursor 提示 401 错误">
  * 确认 API Key 是 Sub2API 控制台生成的 Key
  * 参考 [401 错误排查](/troubleshooting/401)
</Accordion>

<Accordion title="VS Code 扩展无法连接">
  * 确认扩展中填写的 apiBase 为 `https://sub2api.ruilinlu.com`
  * 参考 [Base URL 配置](/configuration/base-url)
</Accordion>

<Accordion title="自定义模型无法使用">
  * 确认模型名称与 Sub2API 支持的名称完全一致
  * 参考 [模型不可用排查](/troubleshooting/model-unavailable)
</Accordion>

<Accordion title="补全功能不工作">
  * 确认在 Cursor/扩展设置中已启用代码补全功能
  * 检查模型是否支持代码补全场景
</Accordion>