SpyBara
Go Premium

desktop.md 2025-11-21 00:04 UTC to 2025-11-24 21:01 UTC

75 added, 0 removed.

2025
Thu 27 06:02 Wed 26 00:04 Tue 25 03:22 Mon 24 21:01 Fri 21 00:04 Thu 20 18:02 Wed 19 03:21 Tue 18 18:02 Mon 17 03:24 Sun 16 00:04 Fri 14 21:26 Thu 6 18:02 Tue 4 18:02 Mon 3 21:01 Sun 2 18:01 Sat 1 21:01

Claude Code on desktop

Run Claude Code tasks locally or on secure cloud infrastructure with the Claude desktop app

Claude Code on desktop interface

Claude Code on desktop (Preview)

The Claude desktop app provides a native interface for running multiple Claude Code sessions on your local machine and seamless integration with Claude Code on the web.

Features

Claude Code on desktop provides:

  • Parallel local sessions with git worktrees: Run multiple Claude Code sessions simultaneously in the same repository, each with its own isolated git worktree
  • Include .gitignored files in your worktrees: Automatically copy gitignored files like .env to new worktrees using .worktreeinclude
  • Launch Claude Code on the web: Kick off secure cloud sessions directly from the desktop app

Installation

Download and install the Claude Desktop app from claude.ai/download

Using Git worktrees

Claude Code on desktop enables running multiple Claude Code sessions in the same repository using Git worktrees. Each session gets its own isolated worktree, allowing Claude to work on different tasks without conflicts. The default location for worktrees is ~/.claude-worktrees but this can be configured in your settings on the Claude desktop app.

Copying files ignored with .gitignore

When Claude Code creates a worktree, files ignored via .gitignore aren't automatically available. Including a .worktreeinclude file solves this by specifying which ignored files should be copied to new worktrees.

Create a .worktreeinclude file in your repository root:

.env
.env.local
.env.*
**/.claude/settings.local.json

The file uses .gitignore-style patterns. When a worktree is created, files matching these patterns that are also in your .gitignore will be copied from your main repository to the worktree.

Launch Claude Code on the web

From the desktop app, you can kick off Claude Code sessions that run on Anthropic's secure cloud infrastructure. This is useful for:

To start a web session from desktop, select a remote environment when creating a new session.

For more details, see Claude Code on the web.

Bundled Claude Code version

Claude Code on desktop includes a bundled, stable version of Claude Code to ensure a consistent experience for all desktop users. The bundled version is required and downloaded on first launch even if a version of Claude Code exists on the computer. Desktop automatically manages version updates and cleans up old versions.