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

# Cursor

> AI-powered code editor

Cursor is an AI coding IDE. Connect it to QwenCloud via Token Plan (Personal Edition), Token Plan (Team Edition), or pay-as-you-go billing.

## Install Cursor

Download and install Cursor from the [Cursor official website](https://cursor.com/features).

## Configure access credentials

In Cursor, click the settings icon and go to **Cursor Settings** > **Models**. Enable **OpenAI API Key** and **Override OpenAI Base URL**, then enter the API Key, Base URL, and model name corresponding to your selected plan.

### Token Plan (Personal Edition)

| Parameter            | Value                                                                                                                                                                                                                         |
| -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **API Key**          | Token Plan (Personal Edition) dedicated [API Key](https://home.qwencloud.com/api-keys)                                                                                                                                        |
| **Base URL**         | `https://token-plan.maas.qwencloudapi.com/compatible-mode/v1`                                                                                                                                                                 |
| **Available models** | Token Plan (Personal Edition) [supported models](/token-plan/personal/token-plan-personal-overview#supported-models). Some model names need adjustment: glm-5.3 should be written as **glm-5-3**, and glm-5.2 as **glm-5-2**. |

### Token Plan (Team Edition)

| Parameter            | Value                                                                                                                                                                                                                                                                                                               |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **API Key**          | Token Plan (Team Edition) dedicated [API Key](https://home.qwencloud.com/api-keys)                                                                                                                                                                                                                                  |
| **Base URL**         | `https://token-plan.maas.qwencloudapi.com/compatible-mode/v1`                                                                                                                                                                                                                                                       |
| **Available models** | Token Plan (Team Edition) [supported models](/token-plan/team/token-plan-team-overview#supported-models). Some model names need adjustment: kimi-k2.6 should be written as **kimi-k2-6**, kimi-k2.5 as **kimi-k2-5**, glm-5.3 as **glm-5-3**, glm-5.2 as **glm-5-2**, glm-5.1 as **glm-5-1**, glm-5 as **glm-5-0**. |

### Pay-as-you-go

The following uses the Singapore (ap-southeast-1) endpoint. For another region, replace ap-southeast-1 and use an API key from that region. See [Regions and endpoints](/developer-guides/getting-started/regions).

| Parameter            | Value                                                                                                                                                                                                                                                                                  |
| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **API Key**          | Your [QwenCloud API Key](https://home.qwencloud.com/api-keys)                                                                                                                                                                                                                          |
| **Base URL**         | `https://ap-southeast-1.maas.qwencloudapi.com/compatible-mode/v1`                                                                                                                                                                                                                      |
| **Available models** | Enter a [supported model](/developer-guides/getting-started/text-generation-models). Some model names need to be adjusted: write kimi-k2.6 as **kimi-k2-6**, kimi-k2.5 as **kimi-k2-5**, glm-5.3 as **glm-5-3**, glm-5.2 as **glm-5-2**, glm-5.1 as **glm-5-1**, glm-5 as **glm-5-0**. |

## FAQ

### Error codes

If you encounter errors during configuration, refer to the FAQ documentation for the corresponding billing plan:

- Pay-as-you-go: [Error codes and troubleshooting](/api-reference/preparation/error-messages)
- Token Plan (Personal Edition): [Token Plan FAQ](/token-plan/personal/token-plan-personal-faq)
- Token Plan (Team Edition): [Token Plan (Team Edition) FAQ](/token-plan/team/token-plan-team-faq)

### Cannot invoke an added model in Cursor

Error messages:

- The model xxx does not work with your current plan or api key.
- Named models unavailable Free plans can only use Auto. Switch to Auto or upgrade plans to continue.

**Cause**: The free version of Cursor only supports Auto mode and does not support invoking custom models.

**Solution**: Upgrade to **Cursor Pro or a higher plan**.

### Cannot find the added model after configuration

In the chat panel, click to disable **Auto** mode, then select the desired model from the model dropdown.

### Model invocation error: "We're having trouble connecting to the model provider." or "Unauthorized User API key"

Troubleshoot the following items:

- Verify that the API Key, Base URL, and model name match the selected billing plan. Credentials are not interchangeable between plans.
- Some model names conflict with Cursor's built-in model names or contain dots that need replacement. Refer to the available models section above for details.
