Windsurf Install & Auth

Windsurf Install & Auth

Overview

Windsurf is an AI-powered code editor by Codeium (now Cognition AI), built on VS Code. It features Cascade (agentic AI assistant), Supercomplete (intent-aware autocomplete), and deep codebase indexing. Authentication is handled through Codeium accounts, not raw API keys.

Prerequisites

• macOS, Windows, or Linux (64-bit)
• 8GB RAM minimum (16GB recommended for large codebases)
• Internet connection for AI features

Instructions

Step 1: Install Windsurf

macOS:

brew install --cask windsurf

Linux (Debian/​Ubuntu):

curl -fsSL https://windsurf.com/​install.sh | bash
# Or download .deb from https://windsurf.com/​download

Windows: Download installer from https://windsurf.com/download

Step 2: Authenticate with Codeium

On first launch, Windsurf prompts for Codeium authentication:

1. Click "Sign In" in the welcome tab or Windsurf widget (bottom-right status bar)
2. Browser opens to Codeium auth page
3. Sign in with Google, GitHub, or email
4. Authorization token is stored locally at ~/​.codeium/

Verify authentication:

• Check the Windsurf widget in the status bar -- it should show a checkmark
• Open Cascade (Cmd/​Ctrl+L) and send a test message

Step 3: Configure for Enterprise / Team

For team deployments with centralized auth:

// Settings > Windsurf Settings (or ~/​.codeium/​config.json)
{
  "codeium.apiServer": "https://codeium.yourcompany.com",
  "codeium.portal.url": "https://portal.yourcompany.com",
  "codeium.enterpriseMode": true
}

Enterprise API key (headless / CI environments):

# Set via environment variable for non-interactive use
export CODEIUM_API_KEY="your-enterprise-api-key"

Step 4: Verify AI Features Are Working

1. Open any project folder in Windsurf
2. Type in a code file -- Supercomplete suggestions should appear
3. Press Cmd/​Ctrl+L to open Cascade chat
4. Type "explain this project" -- Cascade should respond with codebase analysis
5. Check status bar widget shows model name (e.g., SWE-1, Claude, GPT)

Step 5: Select Your AI Model

Cascade supports multiple models. Configure via the model selector dropdown in the Cascade panel:

Error Handling

Examples

Migrate Settings from VS Code

# Windsurf inherits VS Code extensions and settings
# Import on first launch or manually:
# Windsurf > Command Palette > "Import VS Code Settings"

Verify Installation

# Check Windsurf CLI is available
windsurf --version

# Open project in Windsurf from terminal
windsurf /​path/​to/​project

Resources

• Windsurf Download
• Windsurf Documentation
• Codeium Account Portal
• Windsurf Pricing

Next Steps

After authentication, proceed to windsurf-hello-world for your first Cascade interaction.