Last updated: 2026-07-14T04:44:43.140Z

How to Install and Set Up Cursor: The Complete 2026 Guide (Mac, Windows, Linux)

Cursor has become one of the most widely used AI-native code editors in 2026. Here's the full installation and setup walkthrough for every platform, a breakdown of its pricing tiers, and the mistakes that trip up most new users.

How to Install and Set Up Cursor: The Complete 2026 Guide (Mac, Windows, Linux)

Quick answer: Download Cursor from cursor.com, run the installer for your OS, sign in, and optionally import your VS Code settings in one click. The free Hobby plan is enough to evaluate it; most working developers move to Pro ($20/month) within the first week once they hit the Hobby plan's completion limits.

Cursor is a full AI-native code editor built on top of VS Code — not a plugin bolted onto it — and it's become one of the most widely adopted AI coding tools in 2026, reportedly used by over half of the Fortune 500. This guide covers the full setup process on every platform, first-run configuration, pricing, and the small mistakes that trip up new users.

*Researched by Nexorzo — verified against Cursor's official pricing and setup documentation.*

Who This Guide Is For

- Developers switching from VS Code, JetBrains, or another editor who want AI-native completions and agent workflows built in, not bolted on.
- Anyone evaluating whether to pay for Cursor Pro versus staying on the free Hobby tier.
- Teams considering a company-wide rollout who need to understand seat pricing and admin controls before committing.

What Cursor Actually Is

Built by Anysphere, Cursor forks VS Code's codebase, so the interface, keybindings, extensions, and settings will feel immediately familiar if you're coming from VS Code. The difference is that AI is woven into the core editing experience rather than added as an extension: inline "Tab" completions that predict multi-line edits, a chat panel that understands your whole codebase, and an autonomous Agent mode that can plan and execute multi-file changes, run terminal commands, and iterate on its own output. Cursor supports models from OpenAI, Anthropic (Claude), Google (Gemini), and xAI, alongside its own proprietary completion models, so you're not locked into a single provider.

Step 1: Check Requirements

Cursor runs on Windows, macOS, and Linux. Since it's built on the same foundation as VS Code, baseline hardware requirements are modest — but the AI features work best with at least 8 GB of RAM and a stable internet connection, since the heavier models run in the cloud rather than locally. Note that Cursor requires an internet connection for its AI features specifically; the base editor functions offline, but Tab completions, chat, and Agent mode all need connectivity.

Step 2: Download and Install

macOS and Windows

1. Go to cursor.com and click the download button for your operating system.
2. Windows: run the downloaded `CursorSetup.exe`, accept or change the install location, and click Install.
3. macOS: open the downloaded `.dmg` file and drag Cursor into your Applications folder, as with any standard Mac app.

Both macOS and Windows builds are signed and notarized, so you shouldn't hit unsigned-app security warnings during install.

Linux

Cursor ships Linux builds as an AppImage, `.deb`, or `.rpm`, depending on your distribution:

- AppImage — download, mark it executable (`chmod +x`), and run it directly; works across most distributions without installation.
- .deb — for Debian/Ubuntu-based systems, install with `sudo apt install ./cursor.deb` (or `dpkg -i` followed by `apt --fix-broken install` if needed).
- .rpm — for Fedora/RHEL-based systems, install with `sudo rpm -i cursor.rpm` or your distribution's package manager equivalent.

Step 3: First Launch and VS Code Import

On first launch, Cursor offers to import your existing VS Code settings, extensions, keybindings, and themes. This is safe to accept — Cursor maintains its own configuration directory (`~/.cursor/`) separately from VS Code's (`~/.vscode/`), so the two editors won't collide or interfere with each other even if you keep both installed.

Step 4: Sign In

Cursor uses a browser-based OAuth sign-in flow, linkable to a GitHub or Google account. A browser window opens automatically during setup — sign in there, and the editor will pick up your authenticated session. For teams, it's worth provisioning access through SSO rather than having individual developers self-register, since that keeps license and access management centralized from day one (available starting on the Business/Teams tier).

Step 5: Choose Your Plan

Every new account gets a 7-day free trial of Pro, after which it drops to the free Hobby tier unless you upgrade. Here's the full 2026 pricing breakdown:

| Plan | Price | What you get |
|---|---|---|
| Hobby | Free | 2,000 Tab completions/month, 50 slow premium-model requests/month, full VS Code-based editor (extensions, Git, terminal) |
| Pro | $20/mo ($16/mo annual) | Unlimited Tab completions, unlimited Auto mode, $20/month credit pool for premium models |
| Pro+ | $60/mo | Everything in Pro, 3x the usage credits |
| Ultra | $200/mo | Everything in Pro+, ~20x Pro's credit pool, priority access to new features |
| Business (Teams) | $40/user/mo (standard), $120/user/mo (premium seats) | Pro-level AI access plus centralized billing, shared team rules, agentic code review, usage analytics, SSO |
| Enterprise | Custom | Everything in Business, plus pooled org-wide usage, invoice billing, SCIM seat management, dedicated support |

How the credit system works: since June 2025, Cursor bills paid plans through a monthly credit pool equal to the plan price in dollars, which drains based on which AI model you use — a routine question costs far less than an agent implementing a full feature. Critically, Auto mode is unlimited on Pro and above and doesn't draw from your credit pool, since it uses cheaper model routing behind the scenes. Most day-to-day usage on Pro can comfortably stay in Auto mode; you'd only reach for a specific frontier model (and start spending credits) for harder problems.

Realistic guidance on which tier to pick: start on Hobby to get a feel for the editor. If you hit its limits within the first week — which is common for anyone coding daily — Pro at $20/month is the default right answer for the overwhelming majority of individual developers. Pro+ only makes sense once you're regularly running $40+ of overages on Pro; Ultra is built for developers running Agent mode continuously throughout the day, not casual users.

Step 6: Configure Agent Mode and MCP (Optional but Recommended)

Two features are worth setting up once you're past the basics:

- Agent Mode — Cursor's autonomous multi-file editing capability, which can plan a change across your codebase, execute it, run tests, and iterate. It's available from the chat panel; just describe the outcome you want rather than a single edit.
- MCP (Model Context Protocol) — lets Cursor's agent reach into real external systems: querying a database, opening a GitHub PR, reading an error tracker, searching a project management tool. MCP servers are typically a single binary or npm package you install and register in Cursor's settings, after which the agent can call those tools as part of its own reasoning.

Both are optional for basic use but are where most of Cursor's real productivity gains show up once you're comfortable with the editor.

Common First-Week Mistakes

- Merging agent output without reading the diff. Like any LLM-driven coding tool, Cursor's agent can occasionally invent an API method that doesn't exist or claim a fix works when it ran the wrong test. Always read the diff and run your own tests before merging agent-generated changes — treat it like reviewing a capable but occasionally overconfident junior engineer's pull request.
- Not checking the credit dashboard before upgrading tiers. A lot of early frustration with Cursor's pricing comes from not realizing Auto mode is unlimited — if you're hitting credit limits, check whether you're manually selecting a premium model when Auto would have handled the task for free.
- Skipping Privacy Mode for sensitive codebases. Cursor is SOC 2 certified and offers a Privacy Mode that ensures code isn't stored on Cursor's servers or used for model training. It's off by default in some configurations — worth explicitly checking this setting if you're working with proprietary or client code.

Cursor vs. the Alternatives, Briefly

If you're deciding whether Cursor is the right editor at all before installing it: Cursor's edge is deep agent workflows, flexible model selection across providers, and a full IDE experience suited to large or complex codebases. GitHub Copilot is the better fit if your team is already deeply embedded in the GitHub ecosystem and mainly wants fast autocomplete without switching editors. Windsurf is worth a look if you want on-premise deployment or a stronger free tier on a tighter budget.

Final Verdict

Install Cursor if... you want AI woven directly into your coding environment rather than as an add-on, and you're comfortable with a VS Code-based interface.

Start on Hobby, upgrade to Pro when... you hit the 2,000 completions or 50 premium-request monthly limit — which happens fast for anyone using it daily.

Skip it (for now) if... you need fully offline AI coding assistance, since every AI feature in Cursor requires an internet connection to reach its models.

Official Sources

- Cursor download and pricing — cursor.com
- Cursor documentation — docs.cursor.com

Related Nexorzo Guides

You can find Cursor's full tool profile on the Nexorzo AI Tools Directory. Browse more AI coding tools and comparisons at nexorzo.com/tools.