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

> Configure Cursor with Moxus AI's OpenAI-compatible endpoint.

Cursor can call Moxus AI through a custom OpenAI API key and Base URL. This mainly affects Chat, Composer, and Agent workflows. Tab completion behavior depends on Cursor's current version and plan rules.

<Warning>
  Cursor's custom API key and manual model selection features usually require a paid Cursor plan. Free plans may only allow Auto mode, even after you enter your own Moxus AI API key.
</Warning>

## Values

| Field                    | Value                                       |
| ------------------------ | ------------------------------------------- |
| OpenAI API Key           | `sk-your-key`                               |
| Override OpenAI Base URL | `https://moxus.cloud/v1`                    |
| Model name               | Copy the exact name from Models and pricing |

## Setup

<Steps>
  <Step title="Open model settings">
    In Cursor, go to 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 model settings entry" width="3000" height="1556" data-path="images/cursor-model-settings.png" />
  </Step>

  <Step title="Enable OpenAI API Key">
    Turn on OpenAI API Key and paste your Moxus AI `sk-` key.
  </Step>

  <Step title="Set the Base URL">
    Enable Override OpenAI Base URL and enter `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 and Base URL settings" width="2694" height="1536" data-path="images/cursor-api-settings.png" />
  </Step>

  <Step title="Add or enable models">
    First search the existing model list and enable the model you want to use. Only add a model manually in the search box if the target model is not already listed. The model name should match the exact name shown in Moxus AI's Models and pricing page.

    <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 model list and custom model entry" width="2396" height="1120" data-path="images/cursor-model-list.png" />
  </Step>

  <Step title="Test a request">
    Open Chat or Composer, choose a model, and send a short test message.

    <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 test entry" width="2558" height="826" data-path="images/cursor-chat-test.png" />
  </Step>
</Steps>

## How to use it

* `Cmd/Ctrl + L`: open chat for code explanation and project questions.
* `Cmd/Ctrl + I`: open Composer for code edits.
* Agent mode: useful for multi-file tasks, but it may produce more requests and higher cost.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Free plans can only use Auto">
    This is a Cursor plan limitation, not a Moxus AI key error. Switch to Auto or upgrade Cursor before selecting a specific model manually.
  </Accordion>

  <Accordion title="The model I want is missing">
    First check whether the model already exists in Cursor's built-in model list. If it is already listed, enable it instead of adding it again. Only add the exact model name from Models and pricing when it is truly absent.
  </Accordion>

  <Accordion title="The model does not appear after I add it">
    This usually means Cursor already has the same or an equivalent model built in, so adding it again does not create a new list item. Search the existing model list and enable it there.
  </Accordion>

  <Accordion title="The model list is very short">
    This is usually related to your Cursor plan, client version, or regional availability, not a Moxus AI API key error. Update Cursor, confirm your paid plan status, or reopen Models from a supported network region.
  </Accordion>

  <Accordion title="Requests fail after setup">
    Open [Usage](/en/platform/dashboard-and-usage) and check whether the request reached Moxus AI, which key was used, and which model was called.
  </Accordion>
</AccordionGroup>

## Next steps

* [Quickstart](/en/overview/quickstart)
* [Models and pricing](/en/overview/models-and-pricing)