> ## Documentation Index
> Fetch the complete documentation index at: https://docs.moxus.ai/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 当前版本和套餐策略。

## 配置值

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

## 配置步骤

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

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

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

  <Step title="添加或启用模型">
    在模型列表中搜索或添加模型名称。模型名称应与 Moxus AI“模型广场”中展示的名称一致。
  </Step>

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

## 使用方式

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

<Warning>
  Cursor 免费套餐可能只允许使用 Auto 模式。即使你填写了自己的 API Key，也可能无法手动选择具体模型，这是 Cursor 客户端自身的套餐限制。
</Warning>

## 常见问题

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

  <Accordion title="模型列表里没有我想用的模型">
    点击添加或搜索模型，填写“模型广场”中的完整模型名称。不要用嵌入模型，例如 `text-embedding-3-small`，这类模型不能用于普通代码对话。
  </Accordion>

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

## 相关文档

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