Cursor

Cursor supports a custom OpenAI-compatible base URL for its models. Point it at VCodeX to funnel editor traffic through the same budgets and guardrails as your apps.

Prerequisites

• Cursor 0.40+ installed.
• A VCodeX API key (sk-...).

1 · Get your VCodeX key

Dashboard → Settings → External Keys → Create key.

2 · Configure Cursor

1. Open Settings → Models (or Cmd+, → Models).
2. Toggle Override OpenAI Base URL on.
3. Set base URL: https://app.vcodex.ai/v1.
4. Set OpenAI API Key: sk-... (your VCodeX key).
5. Under Model Names, add the models you want to route through VCodeX (e.g. vcodex/auto, anthropic/claude-sonnet-4.5).
6. Click Verify — Cursor probes /v1/models.

3 · Verify

Open a file, hit Cmd+K, prompt something small ("rename this variable to foo"). The request should appear in Observability → Requests with client_source: cursor.

Troubleshooting

• Verify fails — Cursor probes /v1/models. Make sure your key isn't restricted to a single model.
• Cursor's Tab / Composer still uses Cursor cloud — those features use Cursor's own models and cannot be redirected. Chat and Cmd+K respect the custom base URL.
• 401 unauthorized — the API key field pastes with a trailing space; re-paste it.