How to Install Windsurf on Mac (2026 Guide)

Windsurf installs on Mac like any standard macOS app: download the .dmg, drag it to Applications, and sign in with a free account. It supports both Intel and Apple Silicon Macs. The whole process takes under five minutes.

• Windsurf is a VS Code-based AI IDE built by Codeium
• Free tier available; paid plans start at $15/month
• Works on macOS 12 Monterey and later (Intel and Apple Silicon)

What are the system requirements for Windsurf on Mac?

Windsurf requires macOS 12 Monterey or later. It runs natively on both Apple Silicon (M1, M2, M3, M4) and Intel Macs. You need at least 4 GB RAM, though 8 GB is recommended for smooth AI autocomplete. A stable internet connection is required for AI features.

• OS: macOS 12 Monterey or later
• Architecture: Apple Silicon (arm64) or Intel (x86_64)
• RAM: 4 GB minimum, 8 GB recommended
• Disk: ~500 MB free space
• Internet: Required for Cascade AI and model inference

How do you install Windsurf on Mac?

Go to windsurf.com/download, click the macOS download button, open the downloaded .dmg file, drag Windsurf into your Applications folder, and launch it from Spotlight or Finder. Sign in with a free Codeium account to activate AI features.

Step 1: Download the installer

Visit windsurf.com/download. The site auto-detects your Mac architecture. Click the macOS button to download the .dmg file (roughly 400-500 MB).

Step 2: Open the .dmg and install

Double-click the downloaded .dmg file. A Finder window opens showing the Windsurf app icon and an Applications folder shortcut. Drag Windsurf into Applications. This copies the app to /Applications/Windsurf.app.

Step 3: Handle Gatekeeper on first launch

The first time you open Windsurf, macOS Gatekeeper may show a warning that the app was "downloaded from the internet." Click Open Anyway from System Settings > Privacy & Security, or right-click the app and choose Open. This prompt only appears once.

Step 4: Sign in and activate

Windsurf opens a browser tab asking you to sign in or create a free Codeium account. Complete the sign-in flow, and the IDE activates your plan automatically. The free tier gives you access to Cascade Base and basic autocomplete without a credit card.

Step 5: Import settings (optional)

Because Windsurf is VS Code-based, it can import your existing VS Code or Cursor settings, keybindings, and extensions on first launch. Select your previous editor when prompted and Windsurf will migrate the config automatically.

Can you install Windsurf via Homebrew?

As of September 2026, Windsurf does not have an official Homebrew cask in the main repository. The recommended install path is the direct .dmg download from windsurf.com. Some community members maintain unofficial casks, but these may lag behind official releases.

If you prefer the command line, watch windsurf.com and the official Windsurf docs for a Homebrew cask once one is officially published.

Does Windsurf run natively on Apple Silicon?

Yes. Windsurf ships a universal binary that includes both an arm64 build for Apple Silicon (M1 through M4) and an x86_64 build for Intel Macs. macOS automatically runs the correct slice. No Rosetta 2 translation is needed on Apple Silicon, so performance is fully native.

How does Windsurf compare to other AI editors on Mac?

Windsurf, Cursor, and Claude Code are the three most-used AI coding tools on macOS in 2026. Windsurf and Cursor are both GUI editors (VS Code forks); Claude Code is a terminal-based agent. The right pick depends on your workflow.

Tool	Type	Free Tier	Paid from	macOS Install
Windsurf	GUI IDE (VS Code-based)	Yes (Cascade Base)	$15/mo	.dmg download
Cursor	GUI IDE (VS Code-based)	Yes (limited)	$20/mo	.dmg download
Claude Code	Terminal agent (CLI)	No (requires Pro/Max)	$20/mo (Claude Pro)	npm install -g
GitHub Copilot	VS Code extension	Yes (limited)	$10/mo	VS Code extension

For a deeper comparison, see Windsurf vs Claude Code and Cursor vs Windsurf.

What to do if Windsurf won't open on Mac?

The most common issue is Gatekeeper blocking the app. Go to System Settings > Privacy & Security, scroll to the Security section, and click Open Anyway next to the Windsurf entry. If the app crashes on launch, delete the app and re-download to rule out a corrupt installer.

• Gatekeeper warning: System Settings > Privacy & Security > Open Anyway
• App won't launch after update: Delete ~/Library/Application Support/Windsurf cache folder and relaunch
• AI features not working: Check your internet connection and confirm you're signed in to your Codeium account
• Extensions missing: Re-run the import from a previous editor via Help > Import Settings
• Slow performance on Intel Mac: Disable unused extensions and reduce autocomplete trigger delay in Settings

Related guides for AI coding tools on Mac

If you're evaluating multiple AI editors, these guides cover installation and usage for the other major tools:

• How to install Claude Code on Mac
• Antigravity vs Windsurf
• Kiro vs Windsurf
• Lovable vs Windsurf
• When does Windsurf usage reset?

Key takeaways

1. Download the .dmg from windsurf.com/download.
2. Drag Windsurf to /Applications.
3. On first launch, approve Gatekeeper via System Settings > Privacy & Security.
4. Sign in with a free Codeium account to activate AI features.
5. Optionally import VS Code or Cursor settings during setup.
6. Windsurf runs natively on both Intel and Apple Silicon with no Rosetta needed.

Sources

• https://windsurf.com/download - Official Windsurf download page
• https://windsurf.com - Windsurf official site
• https://usagebar.com/blog/windsurf-vs-claude-code - Windsurf vs Claude Code comparison
• https://usagebar.com/blog/cursor-vs-windsurf-which-is-better-in-2026 - Cursor vs Windsurf 2026