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

# Cursor

> 在 Cursor 中配置 Moxus AI 的 OpenAI 兼容接口。

Cursor 可以通过自定义 OpenAI API Key 与 Base URL 调用 Moxus AI。该配置主要影响 Chat、Composer、Agent 等对话与代码编辑能力；Tab 补全是否走自定义 API，取决于 Cursor 当前版本和套餐策略。

<Warning>
  Cursor 的自定义 API Key 与手动选择模型能力通常需要 Cursor 会员套餐。免费套餐可能只能使用 Auto 模式，即使填写了自己的 Moxus AI API Key，也可能无法手动选择模型。
</Warning>

## 配置值

| 项                        | 值                        |
| ------------------------ | ------------------------ |
| OpenAI API Key           | `你的密钥`                   |
| Override OpenAI Base URL | `https://moxus.cloud/v1` |
| 模型名称                     | 在“模型广场”复制完整名称            |

## 配置步骤

<Steps>
  <Step title="打开模型设置">
    在 Cursor 中进入 Settings → Models。

    <img src="https://mintcdn.com/moxus-cloud/DgOc9Y6ZmJ9TiNBD/images/cursor-model-settings.png?fit=max&auto=format&n=DgOc9Y6ZmJ9TiNBD&q=85&s=ca4b7f6d77dd0b6fb22606b7e15775f1" alt="Cursor 模型设置入口" width="3000" height="1556" data-path="images/cursor-model-settings.png" />
  </Step>

  <Step title="启用 OpenAI API Key">
    找到 OpenAI API Key，开启开关，并填入 Moxus AI 的 `sk-` 密钥。
  </Step>

  <Step title="配置 Base URL">
    开启 Override OpenAI Base URL，填写 `https://moxus.cloud/v1`。

    <img src="https://mintcdn.com/moxus-cloud/DgOc9Y6ZmJ9TiNBD/images/cursor-api-settings.png?fit=max&auto=format&n=DgOc9Y6ZmJ9TiNBD&q=85&s=6f71301c81668257a4bc58e7a469f6f1" alt="Cursor API Key 和 Base URL 配置" width="2694" height="1536" data-path="images/cursor-api-settings.png" />
  </Step>

  <Step title="添加或启用模型">
    先在已有模型列表中搜索并启用要使用的模型；只有列表里没有目标模型时，才需要在搜索框中自行添加模型名称。模型名称应与 Moxus AI“模型广场”中展示的名称一致。

    <img src="https://mintcdn.com/moxus-cloud/DgOc9Y6ZmJ9TiNBD/images/cursor-model-list.png?fit=max&auto=format&n=DgOc9Y6ZmJ9TiNBD&q=85&s=7c463e3cd3ee9bf3ed6e91ca027be329" alt="Cursor 模型列表与自定义模型入口" width="2396" height="1120" data-path="images/cursor-model-list.png" />
  </Step>

  <Step title="测试调用">
    打开 Chat 或 Composer，选择可用模型后发送一句测试消息。

    <img src="https://mintcdn.com/moxus-cloud/DgOc9Y6ZmJ9TiNBD/images/cursor-chat-test.png?fit=max&auto=format&n=DgOc9Y6ZmJ9TiNBD&q=85&s=a9f0be8c10569f6d7017da18cef919c7" alt="Cursor Chat 测试调用入口" width="2558" height="826" data-path="images/cursor-chat-test.png" />
  </Step>
</Steps>

## 使用方式

* `Cmd/Ctrl + L`：打开聊天侧栏，适合解释代码、问项目问题。
* `Cmd/Ctrl + I`：打开 Composer，适合让模型直接修改代码。
* Agent 模式：适合跨文件任务，但会产生更多请求和消耗。

## 常见问题

<AccordionGroup>
  <Accordion title="提示 Free plans can only use Auto">
    这是 Cursor 的套餐限制，不是 Moxus AI 密钥错误。切换到 Auto，或升级 Cursor 套餐后再手动选择模型。
  </Accordion>

  <Accordion title="模型列表里没有我想用的模型">
    先确认 Cursor 已有模型列表中是否已经存在该模型。若模型已经在列表中，只需要开启它，不需要再次添加。只有列表中确实没有目标模型时，再在搜索框中添加“模型广场”里的完整模型名称。
  </Accordion>

  <Accordion title="添加模型后列表里还是没有该模型">
    通常是因为 Cursor 已经内置了同名或等价模型，重复添加不会生成新的列表项。回到已有模型列表中搜索并开启该模型即可。
  </Accordion>

  <Accordion title="模型列表显示的模型很少">
    这通常与 Cursor 账号套餐、客户端版本或所在地区可用性有关，不是 Moxus AI API Key 配置错误。可以先更新 Cursor、确认会员状态，或更换可用地区网络后重新打开 Models 页面。
  </Accordion>

  <Accordion title="请求失败但配置看起来正确">
    到 [控制台与用量](/zh/platform/dashboard-and-usage) 查看 API 活动记录，确认请求是否到达、使用了哪个密钥和模型，以及是否产生消耗。
  </Accordion>
</AccordionGroup>

## 相关文档

* [快速入门](/zh/overview/quickstart)
* [模型广场与定价](/zh/overview/models-and-pricing)