Cursor

Cursor is a VS Code-based AI editor. It bundles its own subscription model, but allows you to override Chat / Composer / Agent to a custom OpenAI-compatible endpoint — that's the WRouter integration point.

Prerequisites

Item	Requirement
Cursor	≥ 0.42 (UI paths follow latest stable)
WRouter	A working token

Configure

Open Settings (Cmd , / Ctrl ,) → Models:

1. Set the OpenAI-compatible endpoint

Scroll to OpenAI API Key:

Field	Value
OpenAI API Key	sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Override OpenAI Base URL	https://wrouter.ai/v1

Click Verify. A green ✓ confirms connectivity.

The trailing /v1 is required; without it Verify fails.

2. Add custom models

At the bottom of Models → Add model, add the ones you'll use:

• gpt-5.5, gpt-5.4, gpt-5.4-mini
• claude-fable-5, claude-sonnet-4-6, claude-opus-4-8, claude-haiku-4-5
• gemini-2.5-pro, gemini-2.5-flash
• deepseek-v4-flash, deepseek-v4-pro
• qwen3-coder

Enable each one. Disable Cursor's defaults you won't use to avoid accidental billing.

Verify

1. Open any project; Cmd L (Chat) or Cmd I (Composer)
2. Bottom-right model picker → choose claude-sonnet-4-6
3. Prompt "Summarize this repo" — should return a reasonable summary

Recommended models

Model	Use for
claude-sonnet-4-6	Daily Chat / Composer driver
claude-opus-4-8	Large refactors
gpt-5.5	Reasoning-heavy debugging
qwen3-coder	Lower-latency coding (China network)
gemini-2.5-flash	Long-context (1M) batch rewriting

Known limitations (important)

Some Cursor features do not route through your custom endpoint — they keep calling Cursor's proprietary models:

Feature	Through WRouter?
Chat, Composer, Agent	✓ Yes
Cmd-K inline edit	✓ Yes
Tab autocomplete	✗ No (Cursor's own cursor-small)
Apply / Smart Rewrite	✗ No
Bug Finder / Codebase index	✗ No

To fully isolate from Cursor's account:

1. Settings → disable Cursor Tab
2. Sign out of your Cursor account
3. Trade-off: you lose Tab autocomplete — a core Cursor feature

Troubleshooting

Symptom	Likely cause	Fix
Verify returns 401	Bad token	Re-copy from console; check for trailing whitespace
Verify returns 404 / timeout	Missing /v1	Use https://wrouter.ai/v1
Model picker doesn't show WRouter models	Not added under Models	Add via the Add model flow
model not found after selecting	Wrong ID for upstream	Check spelling at https://wrouter.ai/models
Image messages do nothing	Model doesn't support vision	Use gpt-5.4 / claude-sonnet-4-6 / gemini-2.5-pro

See also

• Cursor official docs: https://docs.cursor.com
• WRouter Chat Completions