Skip to main content
Steps to integrate Cursor with Pioneer:

​
Setup

This integration only covers Cursor’s chat / plan panel (Cmd/Ctrl+L). Composer, inline edit (Cmd/Ctrl+K), tab completion, and apply/edit are locked to Cursor’s own backend and cannot be routed to Pioneer. If you need a full coding agent backed by Pioneer, use Claude Code or Codex CLI instead.
1

Open the Cursor desktop app

Make sure you’re using the Cursor desktop app (the code editor, with a file tree and sidebar) — not the Cursor CLI agent (agent command) and not the cursor.com web account dashboard. Neither of those has the Models settings described below. If you only have the Cursor CLI agent installed, download the desktop app from cursor.com.
2

Open Cursor Settings

Press Cmd+, (macOS) or Ctrl+, (Windows/Linux), or click the gear icon in the top-right toolbar. You can also use Cmd/Ctrl+Shift+J.Make sure you land on Cursor Settings, not VS Code Settings — only Cursor Settings has a Models tab.
3

Go to Models

In the Cursor Settings sidebar, click Models. Scroll down to the API Keys section and expand it.
4

Set your Pioneer key and base URL

Under the OpenAI provider section:
  • Enable the OpenAI API Key toggle and paste your Pioneer API key
  • Enable Override OpenAI Base URL and enter:
Save / verify. Cursor will send a test request.
5

Add your Pioneer model

Back in the Models list, click + Add Custom Model and enter this exact model name:
Toggle it on, then click Verify / save.
Type the model name exactly as pioneer/auto-claude-opus-4, character for character. This is the Pioneer autorouter alias — it still routes across Claude, GPT, and DeepSeek — but the embedded claude-opus-4 slug is required: Cursor only emits Anthropic cache_control prompt-caching markers when the model name contains a recognized Claude model slug (a real family plus numeric major version), and the autorouter depends on those markers to cache prompts. Renaming it, dropping the version, or using a plain pioneer/auto name silently disables prompt caching.

​
Using the model

Open the chat/plan panel with Cmd+L (or Ctrl+L), then click the model picker dropdown at the bottom of the panel (where it shows the current model, e.g. “Auto” or “Sonnet 4.5”) and select your Pioneer model from the list.

​
Troubleshooting

You’re likely in the wrong app. The Cursor CLI agent’s settings (~/.cursor/cli-config.json) and the cursor.com web account dashboard (Plan & Usage, Active Sessions, etc.) both lack a Models tab. Open the Cursor desktop app itself and use Cmd+, from inside it.
Double-check that the base URL includes /v1 and that your Pioneer API key is correct and active. If errors persist, try disabling other enabled models in the Models list to rule out conflicts, then re-enable only your Pioneer custom model.