| name | windsurf-install-auth |
| description | Install Windsurf IDE and configure Codeium authentication.
Use when setting up Windsurf for the first time, logging in to Codeium,
or configuring API keys for team/enterprise deployments.
Trigger with phrases like "install windsurf", "setup windsurf",
"windsurf auth", "codeium login", "windsurf API key".
|
| allowed-tools | Read, Write, Edit, Bash(npm:*), Bash(brew:*), Bash(curl:*), Grep |
| version | 1.11.0 |
| license | MIT |
| author | Jeremy Longshore <jeremy@intentsolutions.io> |
| tags | ["saas","windsurf","codeium","authentication","ide-setup"] |
| compatibility | Designed for Claude Code, also compatible with Codex and OpenClaw |
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
Windows: Download installer from https://windsurf.com/download
Step 2: Authenticate with Codeium
On first launch, Windsurf prompts for Codeium authentication:
- Click "Sign In" in the welcome tab or Windsurf widget (bottom-right status bar)
- Browser opens to Codeium auth page
- Sign in with Google, GitHub, or email
- 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:
{
"codeium.apiServer": "https://codeium.yourcompany.com",
"codeium.portal.url": "https://portal.yourcompany.com",
"codeium.enterpriseMode": true
}
Enterprise API key (headless / CI environments):
