Back to guides

Windsurf Setup Guide

Configure Windsurf IDE to use your own AI subscriptions through KorProxy

1Overview

Windsurf is an AI-native code editor by Codeium, designed for seamless AI-assisted development.

KorProxy lets you use your own AI subscriptions (OpenAI, Anthropic, Google) with Windsurf. This gives you more control over costs and access to the latest models.

Configure Windsurf via settings or environment variables to point to KorProxy at localhost:1337/v1.

2Prerequisites

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

3Configuration Steps

Step 1: Open Windsurf Settings

  • Press Cmd/Ctrl + , to open settings
  • Search for "AI" or "Model" settings

Step 2: Configure Custom Endpoint

  • Look for OpenAI/API configuration section
  • Set API Base URL to:
http://localhost:1337/v1

Step 3: Set API Key

  • Set API Key to any string (e.g., korproxy)
  • KorProxy handles authentication via OAuth—the API key is just a placeholder

Recommended: Environment Variables

Add to your shell profile (~/.zshrc or ~/.bashrc):

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

Then restart Windsurf for changes to take effect.

4Model Selection

Supported Models

Use model names directly—KorProxy automatically routes requests to the correct provider:

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

    Settings not applied

    Restart Windsurf after making configuration changes

  • 2

    Connection refused

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

  • 3

    Authentication errors

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