uai.sh
Documentation

Cursor IDE

OpenAI-compatible setup for Cursor. Full documentation

Cursor works with UAI as a normal OpenAI-compatible endpoint.

Normal setup
  1. Create a key at uai.sh/app/keys.
  2. Open Cursor Settings → Models.
  3. Set OpenAI API Key to your uai-... key.
  4. Enable Override OpenAI Base URL and set it to https://uai.sh/v1.
  5. When Cursor asks for a model, use the full model id from /v1/models or /models.
Model names to use

For OpenAI-family models in Cursor, prefer UAI aliases: uai-gpt41-mini, uai-gpt53-codex, uai-gpt54.

For other providers, use the full catalog id, for example anthropic/claude-opus-4.6.

If openai/gpt-5.3-codex shows Unauthorized User Openai API key, Cursor is trying to use OpenAI directly. Switch the model name to uai-gpt53-codex.

Codex / Agent mode

Start with uai-gpt53-codex.

If Cursor shows We're having trouble finding the resource you requested, switch Network → HTTP Compatibility Mode to HTTP/1.1.

If Cursor Agent still ignores the custom base URL, run node scripts/cursor-proxy.mjs, set base URL to http://localhost:4142/v1, and use model cus-gpt-5.3-codex.