# Claude Desktop

> Route Claude Desktop's inference and tools through Archestra

Claude Desktop uses a downloadable setup helper or a terminal command. The setup script supports macOS, Windows, and Linux. Linux requires Anthropic's official Desktop beta.

## Requirements

Install Claude Desktop. The downloadable installer uses Desktop’s built-in runtime. You do not need Node.js, Python, or Claude Code. Subscription access requires your existing Claude subscription.

MCP sign-in requires HTTPS, including local deployments. Use a trusted local HTTPS reverse proxy for development. Inference alone supports HTTP on localhost and loopback IP addresses. The Anthropic proxy must forward to Anthropic, without a Vertex AI endpoint override.

## Setup

Connecting the LLM Proxy switches Desktop to third-party inference mode. That mode keeps its own conversation history, so your Claude.ai conversations do not appear there at first. See [Import Conversations](#import-conversations) to bring them over, and [Revert](#revert) before switching. Tools-only setup does not require third-party inference.

Open **Connect** and select **Claude Desktop**. Use **Choose what to include** to pick another gateway or leave parts out. Download the installer on the computer you set up. Finish active Desktop tasks before installing, because setup closes Desktop. Click **Download installer**, then open **Settings → Extensions** in standard Claude Desktop and install the downloaded .MCPB file. The setup helper opens your browser for sign-in and restart confirmation. You can remove the helper from Desktop’s Extensions settings afterward.

The **Use terminal setup** option requires Python 3.9+ and Claude Code for subscription sign-in. It remains available for existing third-party profiles that cannot install Desktop extensions. To set up another computer, switch between the Windows and the macOS / Linux command. Terminal setup never forces Desktop to quit. On Windows, it asks you to choose **Exit** from the Claude icon in the system tray, and stops without changes if Desktop still runs after two minutes.

The installer checks inference before changing your configuration. It backs up changed files, preserves manually created profiles, and restarts Desktop. Rerunning setup replaces the installer-managed connection, including its gateway, skills, and plugins. Installing from another deployment replaces the previous managed connection. If macOS rejects automatic quitting, the installer waits for you to quit from Desktop’s menu. On Windows, the setup helper also closes Desktop in the system tray, the way Windows closes apps before an update. If Desktop has not quit after about 20 seconds, the setup helper forces it to quit. You do not download or import a profile manually. Keep the download and generated command private; they contain an expiring setup ticket. Installation redeems the ticket once. The installer and the command expire after 15 minutes. Download a new installer, or click **Regenerate** for a new command.

## Subscription Inference

Subscription setup opens Claude’s browser authorization page. Its consent screen names the subscription connection “Claude Code”. The CLI does not need to be installed. Only inference access is requested. The resulting token stays on your computer. You do not copy it into Archestra. Valid existing tokens are reused when you rerun setup. Rerun setup if subscription authorization expires or is revoked.

Model access and usage limits depend on your Anthropic account. Send a message and check **Logs → LLM Proxy** for its response and billing mode. Subscription credentials are recorded with subscription billing mode.

## API-Key Inference

Your admin decides which one Desktop uses. When an admin picks provider keys for Claude Desktop under **Settings → Connect Page**, setup uses a personal Archestra virtual key backed by those keys, if you hold [`llmVirtualKey:create`](https://archestra.ai/docs/reference/permissions#llmVirtualKey:create). The installer applies it without a Claude subscription sign-in. Otherwise setup uses your Claude subscription.

<span id="tools-and-skills"></span>

## Tools, Skills, and Plugins

After Desktop restarts, open **Settings → Connectors**, select the gateway's connector, and sign in. It is named **archestra** for your personal gateway, or after the gateway you picked. In each conversation, enable it under **+ → Connectors**. After you download the installer or copy the command, **Connect** lists these steps with a starter prompt for your first conversation. A connected checkmark in Settings confirms the connection, not its selection for your conversation.

Ask Claude to list the gateway's tools to verify availability. When [Guardrails](https://archestra.ai/docs/agents/guardrails) are enabled, Desktop's **Code** and **Cowork** sessions need this connector enabled to receive remedy plans and approval reviews.

The skills and [plugins](https://archestra.ai/docs/agents/plugins) selected on **Connect** install automatically after Desktop restarts, and plugins show under **Customize → Plugins**. Setup pins the selected snapshot; rerun **Connect** to install an updated snapshot.

## Import Conversations

Setup turns on **Settings → Import** in Desktop. Desktop also offers an import when you start a new chat or task. Sign in to Claude.ai there to copy your chats and projects. You can also import a Claude.ai data export, or earlier Cowork and Code sessions from this computer.

Import is a one-time copy, not a sync. Rerun it any time to add newer conversations — it skips the ones already imported. New messages in an already imported conversation are not copied. Conversations you start in third-party mode stay on this computer and never appear on Claude.ai.

Importing from Claude.ai needs network access to `claude.ai`, `api.anthropic.com`, and `storage.googleapis.com`. Claude.ai can refuse or delay an export — when your organization disables data export, for example.

## Revert

To return to standard Claude Desktop, choose Anthropic sign-in on Desktop's sign-in screen. Sign in with your original Claude account to access its conversations. Setup and import delete nothing, so your original Claude.ai history is still there. This is [Anthropic's documented return path](https://claude.com/docs/third-party/claude-desktop/installation#single-machine-setup). If your Desktop version does not expose that option, contact your administrator or Anthropic support. Organization policy can hide Claude sign-in.

Keep the `Claude-3p` application data directory. Deleting it can remove conversations created in third-party mode. Removing the setup extension alone does not revert your inference settings.

To use another third-party profile, select it in **Configure Third-Party Inference** and restart Desktop. To return to another deployment, run its installer again. The installer keeps `.before-archestra` backups of existing configuration files it changes. These backups do not include conversation history.

## Verify the Connection

Send `Reply with connection verified.` In **Logs → LLM Proxy**, filter by **Claude Desktop** to review its requests. Claude Code has a separate filter. Older requests with generic Claude attribution appear as **Claude Code**.
