Back to guides

Cursor Setup Guide

Configure Cursor IDE to use your own AI subscriptions through KorProxy

1Overview

Cursor is an AI-powered code editor built on VS Code, designed for pair programming with AI.

KorProxy lets you use your own AI subscriptions (OpenAI, Anthropic, Google) instead of Cursor's built-in models. This gives you more control over costs and access to the latest models.

Cursor works with OpenAI-compatible endpoints, which KorProxy provides at localhost:1337/v1.

2Prerequisites

  • KorProxy app installed and running
  • Cursor IDE installed
  • At least one provider authenticated in KorProxy

3Configuration Steps

Step 1: Open Cursor Settings

  • Press Cmd/Ctrl + , to open settings
  • Or go to Cursor → Settings → Cursor Settings

Step 2: Configure OpenAI Base URL

  • Navigate to the "Models" section
  • Find "OpenAI API Base" or similar setting
  • Set the value to:
http://localhost:1337/v1

Step 3: Set API Key

  • You can use any string as the API key (e.g., korproxy)
  • KorProxy handles authentication via OAuth—the API key is just a placeholder

Alternative: Environment Variables

You can also configure Cursor using environment variables:

export OPENAI_API_BASE=http://localhost:1337/v1
export OPENAI_API_KEY=korproxy

4Selecting Models

Available Models

Use model names directly—KorProxy routes requests to the appropriate provider based on the model name:

claude-opus-4-5-thinking-high

Anthropic (premium)

claude-sonnet-4-5-thinking

Anthropic (balanced)

gpt-5.1-codex-max-xhigh

OpenAI (max reasoning)

gemini-3-pro-image-preview

Google (with image gen)

5Troubleshooting

Common Issues

  • 1

    Connection refused

    Check that KorProxy is running—look for the status indicator in the menu bar

  • 2

    Authentication errors

    Verify the provider is authenticated in KorProxy for the model you're using

  • 3

    Settings not applied

    Try restarting Cursor after changing the API base URL settings