Cursor Setup Guide
Cursor supports custom OpenAI-compatible API endpoints. This guide covers connecting Cursor to Claudexia with model aliases.
Custom API access in Cursor requires a paid Pro plan or higher. The Pro trial does not support custom API endpoints.
Configuration
| Setting | Value |
|---|---|
| Connection mode | OpenAI Compatible |
| Override OpenAI Base URL | https://api.claudexia.tech/v1 |
| OpenAI API Key | Your key from Dashboard > API Keys |
Model aliases
Claudexia provides short aliases that map to full model IDs. Add these in Cursor's model settings:
| Alias | Model |
|---|---|
cursor47 | claude-opus-4.7 |
cursor46 | claude-opus-4.6 |
cursor45 | claude-opus-4.5 |
cursor46s | claude-sonnet-4.6 |
cursor45s | claude-sonnet-4.5 |
cursor45h | claude-haiku-4.5 |
cursorgpt54 | gpt-5.4 |
cursorgpt55 | gpt-5.5 |
Step-by-step
- Open Cursor and go to Settings > Models.
- Set the OpenAI API Key to your Claudexia key.
- Set Override OpenAI Base URL to https://api.claudexia.tech/v1.
- Click Add Model and enter one of the aliases above.
- Select the model in the chat or composer pane.
Troubleshooting
model_not_found error
Verify you typed the alias or model ID exactly as shown. Use GET /v1/models to see all available IDs.
Authentication errors
- Verify your key starts with sk_cdx_.
- Make sure there are no extra spaces or line breaks.
- Confirm the key is active (not frozen or deleted) in the dashboard.
Custom API not working on trial
The free Cursor trial does not support custom API endpoints. Upgrade to a paid Pro plan to use Claudexia.