Skip to content

Cursor IDE

Cursor IDE supports custom OpenAI-compatible endpoints, making it easy to use Claude models through Claudexia.

Requirements

  • Cursor Pro plan — the trial plan does not support custom API endpoints. You must have an active Pro subscription.
  • A Claudexia API key.

Setup

  1. Open Cursor and go to Settings → Models.
  2. Set the OpenAI API Key to your Claudexia key:
    text
    sk_cdx_YOUR_KEY
  3. Set the Override OpenAI Base URL to:
    text
    https://api.claudexia.tech/v1
  4. Click Add Model and add the model IDs you want to use.

Model IDs

Add these model IDs in Cursor's model settings:

Model IDDescription
claude-sonnet-4.5Claude Sonnet 4 — balanced speed and intelligence.
claude-haiku-4.5Claude 3.5 Haiku — fast and cost-effective.
claude-3-5-sonnet-20241022Claude 3.5 Sonnet — previous generation.

Check Models for the full list of available model IDs.

Troubleshooting

"Could not connect to custom API"

Ensure the base URL is exactly https://api.claudexia.tech/v1 — no trailing slash, no /chat/completions suffix. Cursor appends the path automatically.

"Invalid API key"

Verify your key starts with sk_cdx_. Keys from other providers will not work.

"Model not found"

Make sure the model ID you added matches exactly. Use GET /v1/models to see available IDs.

Trial plan limitations

Cursor's free trial does not allow custom API endpoints. Upgrade to Cursor Pro to use Claudexia as a backend.

Slow responses

If responses are slow, try a smaller model like claude-3-5-haiku-20241022 for autocomplete tasks, and reserve larger models for chat and complex code generation.