10 Minutes to Zed

Zed is a good editor to try lightly.

It does not ask you to learn a full modal editing system first. It also does not feel like a blank shell that needs dozens of extensions before it becomes useful. You open a project, the interface is fast, common features are already there, and AI plus collaboration are built into the editor.

This article does not cover everything Zed can do.

The goal is smaller: get Zed running and complete the first real pass in about ten minutes.

1. Install

On macOS, Homebrew is the easiest path:

brew install --cask zed

If you want the preview build:

brew install --cask zed@preview

On Windows, use winget:

winget install -e --id ZedIndustries.Zed

On Linux, use the official install script:

curl -f https://zed.dev/install.sh | sh

Open a project:

zed ~/projects/my-app

Or just open Zed:

zed

You can also press Cmd+O on macOS, or Ctrl+O on Windows and Linux, to open a folder from inside Zed.

2. Remember the Entry Points

You do not need to memorize many shortcuts at the beginning.

Start with these:

| Action | macOS | Windows / Linux |

| --- | --- | --- |

| Command palette | Cmd+Shift+P | Ctrl+Shift+P |

| Go to file | Cmd+P | Ctrl+P |

| Go to symbol | Cmd+Shift+O | Ctrl+Shift+O |

| Find in project | Cmd+Shift+F | Ctrl+Shift+F |

| Open settings | Cmd+, | Ctrl+, |

| Open extensions | Cmd+Shift+X | Ctrl+Shift+X |

| Open AI Agent Panel | Cmd+Shift+A | Ctrl+Shift+A |

| Inline Assistant | Cmd+Enter | Ctrl+Enter |

If you remember only one, remember the command palette.

Cmd+Shift+P or Ctrl+Shift+P is the main doorway. When you forget a shortcut, search for the action there.

3. Open a Real Project

Use a project you already know:

cd ~/projects/my-app
zed .

Then try this sequence:

Use Cmd+P to open a familiar file.
Use Cmd+Shift+F to search for a function name or config key.
Use Cmd+, to open settings.
Use Cmd+K Cmd+T to open the theme selector.
Use Ctrl + backtick to open the built-in terminal.

After this, you already understand the basic Zed workflow.

4. Change Three Settings First

Do not start by rewriting your entire editor config.

Change only the things that affect comfort immediately.

Theme

macOS:

Cmd+K Cmd+T

Windows / Linux:

Ctrl+K Ctrl+T

Pick something readable and move on.

Font

Open settings and search:

buffer_font_family

Use your preferred code font if you already have one.

Format on Save

Open settings and search:

format_on_save

If your project already has a formatter configured, turn it on. If not, leave it off for now so your first session does not create unrelated formatting diffs.

5. Install Language Extensions

Zed includes built-in support for many languages, but some workflows need extensions.

To install one:

Press Cmd+Shift+X or Ctrl+Shift+X.
Search for your language or tool, such as Vue, Svelte, or Tailwind.
Click Install.

If you are only editing Markdown, JavaScript, TypeScript, or small scripts, you can skip this at first.

Start using the editor before you optimize it.

6. Try the AI Panel

Open the Agent Panel:

Cmd+Shift+A

Windows / Linux:

Ctrl+Shift+A

Start with a small question:

Explain where the entry point of this project is.

Or:

Look at the current file and suggest obvious simplifications. Do not edit yet.

This is a good first interaction.

I would not start with a large refactor. First let the agent read, explain, and suggest. Once you trust the workflow, let it make smaller edits.

7. For Vim and Helix Users

If you already use Vim, you can enable Vim mode:

{
  "vim_mode": true
}

Zed also has a Helix mode. The official docs include separate pages for Vim Mode and Helix Mode.

My suggestion: do not rush to turn Zed into another editor.

Use the default Zed workflow for a few days, then decide whether you want to bring your old muscle memory over.

8. Where to Go Next

| Goal | Read |

| --- | --- |

| Move from VS Code | Coming from VS Code |

| Change shortcuts | Keybindings |

| Use AI coding features | Agent Panel |

| Configure language support | Languages |

| Run terminal, tasks, and tests | Running & Testing |

The ten-minute goal is not to master Zed.

The goal is to open a project, find files, search code, change the theme, open the terminal, and try AI once.

That is enough for the first day.