Cursor
Cursor lets you override the OpenAI base URL, so its chat can talk to OpusGate's OpenAI-compatible side. Configuration lives inside Cursor's own settings UI (there is no config file to script — set it up once by hand).
Required values
Base URL:
API key: your
https://api.opusgate.dev/v1 — keep the /v1, Cursor appends /chat/completions itself.API key: your
sk-og-... from the Keys page.Setup
- Open Settings (
Cmd/Ctrl + ,) → Models in the left sidebar. - Click + Add Model and type the exact model ID you want (e.g.
claude-opus-5-5,claude-sonnet-5-5). IDs are case-sensitive — copy them from the models page. - Turn on Override OpenAI Base URL and enter
https://api.opusgate.dev/v1. - In the OpenAI API Key field, paste your
sk-og-...key. (Despite the "OpenAI" label, the key goes to OpusGate.) - Click Verify — Cursor sends a test request through OpusGate. A green check means you're done.
What routes through OpusGate — and what doesn't
- A custom API key does not replace every Cursor service. Check which modes and features use a custom provider in your installed Cursor version.
- Cursor controls its subscription requirements and feature availability separately from OpusGate API billing.
- Alternative setup guides are available for Claude Code, Cline and Roo Code.
Troubleshooting
Verify fails
Three usual causes: the base URL is missing /v1; the key was pasted with a space or is revoked (issue a fresh one); or your balance is empty (top up — verification makes a real, tiny billed request).
Model responds with "model not found"
The model name you added must match an OpusGate ID exactly — claude-opus-5-5, not claude-3-opus or a display name. Check the catalog.
Custom model works, then Cursor switches back
Cursor re-enables its built-in models after some updates. Re-select your custom model in the picker at the bottom of the chat panel.