Corveil Docs

Appearance

Cursor IDE ​

Cursor is an AI-powered code editor with built-in support for custom OpenAI-compatible endpoints.

Mode ​

Direct mode only. Cursor uses the OpenAI-compatible API and does not support custom headers for passthrough authentication.

1. Open Model Settings ​

In Cursor, go to Settings > Models (or press Cmd+Shift+P / Ctrl+Shift+P and search for "Models").

2. Configure the OpenAI endpoint ​

  1. Set "Override OpenAI Base URL" to https://your-corveil-host/v1
  2. Set "OpenAI API Key" to sk-citadel-your-key-here
  3. Click "+ Add Model" to add models available through your Corveil instance (e.g., or-claude-haiku-4.5, or-gpt-5.1)

Troubleshooting ​

  • 401 Unauthorized: Verify the "OpenAI API Key" field contains a valid Corveil virtual API key
  • No models available: You must manually add model names via "+ Add Model" — they must match models configured in your Corveil instance
  • Falling back to Cursor's models: Make sure the base URL override is saved and Cursor is not using its built-in API keys