Claude Code desktop and web

Claude Code is not terminal-only. Desktop and web surfaces add visual diff review, parallel sessions, cloud handoff, and mobile continuation when a GUI fits the task better than a shell.

Last verified
Applies to
Claude Code 2.1.x. CLI spellings were checked on local version 2.1.198; official docs may describe newer 2.1.x behavior.
Verification method
Desktop Code-tab, local/SSH sessions, worktrees, connectors, provider differences, and handoff behavior were reviewed in official docs. The desktop app and external accounts were not operated.
Official sources
Desktop applicationSessionsChangelog

Reproducible practice

Run one disposable desktop session with a reviewable filesystem boundary

Prove repository selection, change isolation, evidence review, and cleanup before using parallel or remote desktop workflows.

Prerequisites

  • Claude Desktop on a supported OS and an authorized account.
  • A trusted repository with a clean baseline and no production secrets.
  • A disposable branch or worktree and one targeted verification command.

Steps

  1. Create the isolation boundary

    Use normal git tooling before opening Desktop so the baseline remains independently verifiable.

    Step 1
    git status --short
    git switch -c desktop-lab
  2. Open the exact repository

    Confirm displayed path, provider, permission mode, and session type before sending a task.

  3. Request one bounded change

    Require the same test command and diff evidence used outside Desktop; GUI behavior was not tested in this audit.

  4. Review outside the app

    Inspect status, diff, and tests in a trusted terminal before keeping or sharing the session.

    Step 4
    git status --short
    git diff --check
    git diff --stat

Expected result

The session affects only the disposable branch or worktree, produces a reviewable diff, and passes the named external verification command.

Validation

  • Compare repository path and branch inside and outside Desktop.
  • Inspect every changed file with git.
  • Confirm session sharing, connectors, and remote access remain off unless explicitly required.

Failure handling

Wrong repository opens

Stop before granting tools and reselect the exact path.

Provider differs from CLI

Check Desktop provider configuration separately; do not assume CLI environment variables apply.

Cleanup or rollback

  • Close the session, inspect the diff, then delete only the disposable branch or worktree through normal git review.
  • Revoke connectors or remote access enabled solely for the exercise.

Boundaries and when not to use it

  • Desktop and CLI differ in providers, connectors, plugins, and authentication behavior; validate the active surface.
  • Parallel sessions can still conflict when they share files or external systems; use worktrees and scoped credentials.

Desktop app

The desktop app supports parallel sessions, git-isolated worktrees, integrated terminal and file editing, visual diff review, and handoff from terminal sessions.

CommandDescription
/desktopContinue the current session in Claude Code Desktop.
/appAlias for /desktop on supported platforms.

Visual review

Inspect proposed edits in a GUI when side-by-side diff review is faster than terminal output.

Read guide

Web and cloud sessions

Claude Code on the web runs in Anthropic-managed environments. It is useful for tasks that benefit from cloud isolation, PR workflows, or working without local setup.

CommandDescription
claude --cloudCreate a new web session with a task description.
/teleportPull a web session into the current terminal.
/remote-controlContinue a local session from another device or browser.

Choose the right surface

Terminal remains best for scriptable automation and deep shell workflows. Desktop and web are stronger for visual review, parallel work, and mobility.

Setup checks

Desktop and web features depend on account access, platform support, and sometimes an existing CLI install for handoff commands.

Verify CLI before handoff
claude auth status --text
claude --version

Desktop and web checklist

Related topics