SpyBara
Go Premium

desktop.md 2026-01-21 21:05 UTC to 2026-01-22 21:03 UTC

11 added, 0 removed.

2026
Sat 31 03:42 Fri 30 18:07 Thu 29 21:03 Wed 28 15:06 Tue 27 21:01 Mon 26 21:03 Sun 25 03:34 Sat 24 03:29 Fri 23 21:01 Thu 22 21:03 Wed 21 21:05 Tue 20 21:03 Mon 19 21:01 Fri 16 21:01 Wed 14 06:02 Mon 12 21:02 Sun 11 18:02 Sat 10 21:01 Fri 9 21:01 Thu 8 21:02 Wed 7 21:01 Tue 6 21:01 Sat 3 18:02

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.

Installation

Download the Claude desktop app for your platform:

apple macOS

Universal build for Intel and Apple Silicon
windows Windows

For x64 processors

For Windows ARM64, download here.

Features

Claude Code on desktop provides:

  • Diff view: Review Claude's changes file by file before creating a pull request, and comment on specific lines to iterate further
  • Parallel local sessions with git worktrees: Run multiple Claude Code sessions simultaneously in the same repository, each with its own isolated git worktree
  • Include files listed in your .gitignore in your worktrees: Automatically copy files in your .gitignore, like .env, to new worktrees using .worktreeinclude
  • Launch Claude Code on the web: Kick off secure cloud sessions directly from the desktop app

Review changes with diff view

After Claude makes changes to your code, the diff view lets you review modifications file by file before creating a pull request.

When Claude makes changes to files, a diff stats indicator appears showing the number of lines added and removed (for example, +12 -1). Click this indicator to open the diff viewer, which displays a file list on the left and the changes for each file on the right.

Comment on specific lines

Click on any line in the diff to open a comment box. Type your feedback and press Enter to send. In the full diff view, press Enter to accept each comment, then Cmd+Enter to send them all. Claude reads your comments and makes the requested changes, which appear as a new diff you can review.

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.

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.

Environment configuration

For local environments, Claude Code on desktop automatically extracts your $PATH environment variable from your shell configuration. This allows local sessions to access development tools like yarn, npm, node, and other commands available in your terminal without additional setup.

Custom environment variables

Select "Local" environment, then to the right, select the settings button. This will open a dialog where you can update local environment variables. This is useful for setting project-specific variables or API keys that your development workflows require. Environment variable values are masked in the UI for security reasons.

Enterprise configuration

Organizations can disable local Claude Code use in the desktop application with the isClaudeCodeForDesktopEnabled enterprise policy option. Additionally, Claude Code on the web can be disabled in your admin settings.

To find navigation and other pages in this documentation, fetch the llms.txt file at: https://code.claude.com/docs/llms.txt