Walkthrough

Claude Code desktop: download it, open the Code tab, and learn its limits

Updated November 17, 20269 min read

Claude Code desktop is the Code tab inside Anthropic's Claude app for Mac, Windows and Linux (beta). You download Claude, sign in with a paid plan, click Code, and point it at a project folder. The steps below take you from the download link to your first finished change, then show what the app does well and where it runs out of room.

Download Claude Code desktop on Windows and Mac

There is no separate "Claude Code" installer. The Claude desktop download gives you one app with three parts: chat, Cowork and Claude Code. Before you start, check your plan. Anthropic's quickstart says the Code tab requires a Pro, Max, Ultra, Team or Enterprise subscription, so a free account will only see an upgrade prompt.

  1. 1

    Open the official download page

    Go to the Claude Code desktop quickstart. Download links from anywhere else may be fake, so use Anthropic's page.

  2. 2

    Pick the right file

    For Claude Code desktop on Mac, choose Download for macOS. It is one universal file that works on both Intel and Apple silicon Macs. For the Claude Code desktop Windows download, choose Download for Windows for normal x64 PCs, or the separate ARM64 installer for Windows laptops with an ARM chip.

  3. 3

    Run the installer

    Open the downloaded file and follow the prompts. On Windows, that is the setup file you just saved. If Windows says another installation is in progress when none is, Anthropic suggests running the installer as Administrator.

  4. 4

    Open Claude and sign in

    Start Claude from the Applications folder on a Mac or the Start menu on Windows. Sign in with your Anthropic account, the same one you use on claude.ai.

  5. 5

    Click the Code tab

    It sits at the top of the left sidebar. If the tabs show only icons, hover over them to see their names. An upgrade prompt here means your plan doesn't include Claude Code.

  6. 6

    Choose where Claude works

    In the row under the message box, open the environment picker and choose the top entry under Local. Then click the folder control, choose Open folder… and pick your project. A small project you know well is the best first test.

  7. 7

    Pick a model and a permission mode

    The model picker sits at the right of the same row. The mode picker sets how much Claude may do without asking: Manual asks before every edit and command, Accept edits applies file changes on its own, Plan only proposes an approach, and Auto lets a background checker block risky actions instead of asking you.

  8. 8

    Give it a first job and review it

    Type something small, such as "Add tests for the main function". When Claude changes files, a counter like +12 -1 appears. Click it to open the diff view, read each change, and leave comments on lines you want changed. Claude reads the comments and revises.

Tip

You don't need Node.js or the command-line version of Claude Code for the desktop app. The app downloads and updates its own copy. To update, use Claude > Check for Updates… on a Mac or Help > Check for Updates… on Windows.

Claude Code desktop on Linux (beta)

Linux support is a beta as of November 2026. You need Ubuntu 22.04 or later, or Debian 12 or later, on an x86_64 or arm64 machine. Anthropic installs it through its own apt repository, so updates arrive with your normal system updates. The commands from Anthropic's Linux page are:

sudo apt install curl gnupg
sudo curl -fsSLo /usr/share/keyrings/claude-desktop-archive-keyring.asc https://downloads.claude.ai/claude-desktop/key.asc
echo "deb [arch=amd64,arm64 signed-by=/usr/share/keyrings/claude-desktop-archive-keyring.asc] https://downloads.claude.ai/claude-desktop/apt/stable stable main" | sudo tee /etc/apt/sources.list.d/claude-desktop.list
sudo apt update && sudo apt install claude-desktop

Then start Claude from your app launcher, or type claude-desktop in a terminal, and sign in. The Linux beta does not yet include computer use (letting Claude click around your screen), dictation, or support for Fedora and RHEL. On those systems, Anthropic points you to the command-line version instead.

What you can and can't do in the Code tab

Once your first session works, these are the features worth learning if you want to use Claude Code desktop every day. Each one comes from Anthropic's desktop docs as of November 2026.

Run sessions in parallel

Click + New or press Ctrl+N (Cmd+N on Mac). Switch with Ctrl+Tab. Alt-click (Option-click on Mac) a session to open it side by side in split view.

Give each session its own copy

Turn on Worktree before starting a session in a git project. Claude then edits a separate copy of the folder, so two sessions don't trample each other. Needs Git installed.

Review in a diff

Read changes file by file, comment on single lines, and send all comments back at once. Type /code-review to have Claude check its own work.

Preview your app

When your dev server starts, your app opens in the Browser pane. Claude can look at the running app and test it.

Use a terminal and editor

Press Ctrl and the backtick key for a terminal inside the app. Click a file path to open it in the file pane. Drag panes into any layout you like.

Ask a side question

Press Ctrl+; (Cmd+; on Mac) to open a side chat without throwing the main session off course.

Run work elsewhere

Pick Cloud to keep a task going after you close the app, SSH to work on a remote server, or WSL on Windows to work inside Linux.

Schedule and watch PRs

Set scheduled tasks, such as a daily review. After a pull request opens, the app can watch its checks and fix failures (needs the GitHub gh tool).

What the app leaves out

Agent teams

Teams where a lead Claude hands tasks to teammates exist only in the command-line version, not in the desktop app.

Scripting

There is no equivalent of --print or JSON output. The app is for interactive work only.

Some permission tricks

The dontAsk mode is CLI only, and Shift+Tab does not cycle modes the way it does in the terminal.

Inline autocomplete

It does not suggest code as you type. You work by asking and reviewing.

Other AI agents

It runs Claude only. Codex, Gemini CLI or Grok need their own windows.

A free tier

The Code tab needs a paid Claude plan. On Linux, computer use and dictation are missing too.

Claude Code desktop vs terminal: one engine, two habits

Anthropic says the desktop app runs the same engine as the terminal version. You can run both at once on the same project. They read the same setup files:

  • Your project's CLAUDE.md notes (the file Claude reads first for your rules).
  • MCP servers (add-ons that connect Claude to other tools) set in ~/.claude.json or .mcp.json.
  • Hooks, skills and settings in ~/.claude/settings.json.

Each keeps its own list of sessions, though. To move a terminal session into the app, type /desktop in the terminal (Mac and x64 Windows, signed in with a Claude plan). From inside the app, type /resume to pick up a session you started in the terminal. One catch: the Code tab runs its own copy of Claude Code, so its version can differ from the claude command in your terminal. Type /status in a session to see which one you have.

Anthropic's own advice is to use the app when you want parallel sessions in one window and visual review, and the terminal when you need scripts and automation. Our desktop vs terminal comparison goes through it feature by feature, and how to use Claude Code covers prompting habits that work in both.

Fixing the first problems people hit

  • Error 403 in the Code tab: sign out and back in from the app menu. If the terminal version works but the app doesn't, quit the whole app (closing the window is not enough) and sign in again.
  • "Git is required": you turned on Worktree without Git. Install Git (Git for Windows on a PC) and try again.
  • Claude can't find npm or node: check those commands work in your normal terminal, then restart the app so it reloads your PATH (the list of folders where your computer looks for programs).
  • "Failed to load session": the folder may have moved, or the repo needs Git LFS. Pick the folder again, or install Git LFS and run git lfs install.
  • Blank screen on launch: restart the app and check for updates. On Windows, crash details are in Event Viewer under Windows Logs, Application.

For a steadier first week, start bigger jobs in Plan mode so you approve the approach before files change. Our plan mode guide shows how.

When one desktop window isn't enough

The desktop app is comfortable with a handful of sessions. The sidebar lists them, split view shows two at once, and a new window holds a third. Things change when you look after many projects. Picture a shop site, a blog, a client dashboard and a side project, each with one or two agents running. Now the sidebar is long, most sessions are out of view, and the only way to know which one stopped to ask permission is to click through them.

Three more limits show up at this size. Every session in the app is a Claude session, so if you use Codex for a second opinion it lives in another program. Usage is tied to the account you signed in with, so a second Claude login means signing out and in. And each project has its own dev server, notes and to-do list that the app doesn't keep together for you.

If that sounds like your week, the fix is usually a layout that shows every agent at once. The ways to do that, from free terminal tricks to apps, are in running multiple Claude Code agents.

VibeCodingDeck: a cockpit for many projects at once

VibeCodingDeck was built for the many-projects case. It is a desktop app for Windows 10/11 and Apple silicon Macs that sits around the coding agents already on your computer. It does not replace Claude Code desktop and it is not an AI model. It uses your own Claude and ChatGPT subscriptions.

  • A grid of up to 12 agents, each in its own pane on its own project, and up to 6 decks you switch between with one click.
  • A status light on every pane and three alert sounds, plus a jump straight to the agent that is waiting on you.
  • Claude Code next to Codex, Gemini CLI, Grok, GitHub Copilot, Qwen, Kimi and Antigravity.
  • Several logins per AI, with a live daily and weekly usage meter for each.
  • Per project: a task board, notes, your app's live preview inside the pane, and an editor for the CLAUDE.md file your AI reads first.
  • Close the app and the layout and real conversations come back next time.

As of November 2026 the price is $29/month or $249/year, and every plan includes every feature. You can keep both: the official app for one focused Claude session, and VibeCodingDeck when the whole fleet is running. See pricing.

Desktop app questions, answered

Where do I download Claude Code desktop?

+

From Anthropic's Claude Code desktop quickstart page at code.claude.com. It has a universal Mac file, a Windows x64 installer, a separate Windows ARM64 installer, and apt instructions for the Linux beta.

Is Claude Code desktop free?

+

The app is free to download, but the Code tab needs a Pro, Max, Ultra, Team or Enterprise plan. Your sessions count against that plan's usage.

Does Claude Code desktop work on Linux?

+

Yes, as a beta on Ubuntu 22.04+ and Debian 12+ (x86_64 or arm64), installed with apt. Fedora, RHEL and Arch are not supported yet, so use the command-line version there.

Can I use Claude Code desktop and the terminal on the same project?

+

Yes. They share CLAUDE.md, MCP servers, hooks and settings. Each keeps its own session list, and /desktop moves a terminal session into the app.

Sources

Run up to 12 AI coding agents in one window.

Claude Code, Codex, Gemini, Grok and more, side by side. Windows and Mac. From $29 a month.

Get started

Keep reading