claude/for
Search
Subscribe
Claude CodeUpdated

How do I open the current project in Claude Desktop with `claude --desktop`?

From Claude Code CLI v2.1.285+, `claude --desktop` opens the Claude desktop app on your current directory (or with `--continue` / `--resume` on an existing session). Requirements, `/desktop` vs shell flag, and how it differs from the full Desktop app and Channels.

Run claude --desktop from a project folder (Claude Code ≥2.1.285) to open Claude Desktop on that directory without starting a terminal session. Add --continue for the latest conversation in the folder, or --resume <session-id> (ID from /status, not a session name). In an active CLI session, /desktop saves and moves that session into Desktop.

Needs macOS or x64 Windows and a Claude subscription sign-in, not API-key / Bedrock / Agent Platform / Foundry. Claude Desktop itself now has a Linux beta, but these two commands don't list Linux. This guide covers the CLI→Desktop bridge, not a full Desktop tour, and not the Claude Tag Channels guide (Channels).

TL;DR: claude --desktop opens Desktop on cwd; --continue / --resume &lt;id> attach an existing conversation; /desktop moves an active CLI session. Version floor 2.1.285+. For the Desktop app itself, see Anthropic's Desktop docs. Checked 2026-10-22.

What claude --desktop does

CHANGELOG 2.1.285 (anthropics/claude-code):

Added claude --desktop to open the Claude desktop app on the current directory, or on a session with --continue / --resume &lt;id>

The docs (Desktop application · “Coming from the CLI?”): with no other args, the flag opens Desktop on the current directory. The docs show a printed message only for --resume <session-id>: Claude Code prints Opening session <session-id> in Claude Desktop, the session opens in the app, and the command exits. If Claude Desktop isn’t installed, the command prints a download link and exits (claude.com/download).

Version floor: Claude Code v2.1.285 or later. CHANGELOG HEAD on 2026-10-01 is 2.1.286 (additive UX/fixes elsewhere: bookmarks, Tag spend Add-channel, etc.). It does not redefine --desktop; this guide stays on the 2.1.285 landing.

--desktop vs /desktop

EntryWhen to useSession behavior
claude --desktopFrom the shellOpens Desktop on cwd without starting a terminal session
/desktopInside a running CLI sessionSaves the session, opens it in Desktop, exits the CLI
claude --desktop --continueFrom the shellMost recent conversation in this directory
claude --desktop --resume <session-id>From the shellSession ID from /status (session name does not work)

Shared requirements (official docs): available on macOS and x64 Windows when signed in with a Claude subscription. Not available with API key authentication or on Amazon Bedrock, Google Cloud’s Agent Platform, or Microsoft Foundry.

claude --desktop
claude --desktop --continue
claude --desktop --resume <session-id>

Continue and resume

  • --continue → most recent conversation in this directory.
  • --resume <session-id> → ID from /status. A session name is not accepted.
  • Claude Code does not move a session that is open in another terminal or still running in the background.
  • Inside Desktop (local sessions only, not SSH/WSL/cloud), /resume can pick up a CLI-started session.
  • Old sessions can only be resumed while their transcript exists. See how to keep Claude Code conversations past 30 days for the retention rules, including the Desktop exemption.

The Claude moves worth stealing, by email

Workflows tested on real jobs, sent only when they are worth it. Free.

Not these “Desktop / Channels”

ThingRoleWhere
Full Claude Desktop productCode tab panes, computer use, Dispatch, etc.Anthropic's docs: desktop · desktop-quickstart · download
Claude Tag “Channels Claude can search”Slack search adminChannels guide
MCP claude --channelsPush events into a local sessionDifferent product, not this page
Claude Mods / You should knowPlugins that modify deeper behavior (2.1.287+)Mods guide
Permissions / auto mode / memory / doctorOther guidesLinks below

Linux: Claude Desktop now ships a Linux beta, installed with apt. The bridge commands still don't cover it: the CLI reference and the official “Coming from the CLI?” section list only macOS and x64 Windows for /desktop and --desktop (checked 2026-10-22).

Pitfalls

  • Expecting API-key or Bedrock / Agent Platform / Foundry support for /desktop / --desktop
  • Using a session name with --resume instead of the ID from /status
  • Trying to move a still-running or other-terminal session
  • Expecting /desktop or --desktop to work on Linux, even with the Claude Desktop Linux beta installed

Related: permissions · stop auto mode · memory · doctor prompt-audit.

FAQ

Do I need Desktop installed first?

Yes, or follow the download link the command prints when the app is missing (claude.com/download).

What’s the difference between /desktop and claude --desktop?

/desktop moves an active CLI session into Desktop and exits the CLI. claude --desktop opens Desktop from the shell without starting a terminal session.

Can I use this on Bedrock / with an API key?

No. Official docs: Claude subscription sign-in only, not API key, Bedrock, Agent Platform, or Foundry.

Is this the same as Claude Code Channels?

No. Tag “Channels Claude can search” and MCP --channels are different products. See the Channels guide.

Does HEAD 2.1.286 change --desktop?

The feature landed in 2.1.285. HEAD 2.1.286 is additive elsewhere; it does not redefine this flag (checked 2026-10-01).

Sources

The Claude moves worth stealing, by email

Workflows tested on real jobs, sent only when they are worth it. Free.