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

# Cursor

> Use Cursor with Lyceum's inference models

Point Cursor at Lyceum's serverless endpoint to chat with any of our open-source models directly inside the editor. The endpoint is OpenAI-compatible, so Cursor talks to it through its built-in OpenAI provider.

<Note>
  This requires a paid Cursor plan. The custom OpenAI key and base-URL override are not available on Cursor's free tier. Cursor also only routes its **Ask / chat** panel to custom OpenAI models: Agent, Composer, Tab completion, and the cloud agents stay on Cursor's own models. For a full agentic coding workflow on Lyceum models, use [Claude Code](/docs/inference/claude-code).
</Note>

## Setup

In the Cursor desktop app, open **Cursor Settings** (`Cmd + ,`) and go to **Models**, then scroll to **API Keys**:

1. Under **Model Names**, add a Lyceum model ID, for example `z-ai/glm-5.2`.

2. In **OpenAI API Key**, paste your Lyceum key (`lk_...`). Get it from the [dashboard](https://dashboard.lyceum.technology).

3. Enable **Override OpenAI Base URL** and set it to:

   ```
   https://api.lyceum.technology/api/v2/external/serverless
   ```

4. Click **Verify**. Cursor sends a test request to the endpoint using your first custom model, so the model ID has to be valid before this succeeds.

Once verified, pick the model from the model dropdown in the Ask panel and chat as usual. Your requests are billed to your Lyceum credit balance.

## Models

Add any model ID from the [serverless catalog](https://lyceum.technology/products/inference/models). Common choices:

```
z-ai/glm-5.2
moonshotai/kimi-k2.7-code
minimax/minimax-m3
deepseek/deepseek-v4-pro
moonshotai/kimi-k2.6
```

IDs are case-insensitive. If Cursor rejects a model name containing a slash, use the slash-free variant instead (`z-ai-glm-5.2`).

## Troubleshooting

**"Model name is not valid" / "AI Model Not Found."** You are in the Agent or cloud-agent surface, which does not support custom OpenAI models. Use the Ask / chat panel instead, and make sure the base URL override is verified in Settings.

**Verify fails or times out.** Confirm the base URL is exactly `https://api.lyceum.technology/api/v2/external/serverless` (no trailing `/v1`, no `/chat/completions`) and that the API key is a valid `lk_` key from the dashboard.
