Desktop application changeddesktop
Nearest release: v2.1.312, published 23 hours before upstream edited the page. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.
Upstream edited this page at 28 Oct 2026 18:06 UTC, give or take a minute or two: the time comes from Anthropic’s own sitemap rather than from a commit. This site recorded the change at 28 Oct 2026 18:37 UTC.
Upstream edited
Recorded here
Lines+7added
Lines−7removed
From line
39
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits97to this page, all time
The whole hunk
from line 39, old and new numbered
/
from line 39
3939Before you send your first message, choose the environment, project folder, permission mode, and model in the row under the prompt box:
4040
4141* **Environment**: use the environment selector, the first control in the row, to choose where Claude runs. See [environment configuration](#environment-configuration).
42 * If a new session has no environment selector under the prompt box, follow the [earlier layout's steps](#check-which-layout-you-have).
42 * If a new session shows no environment under the prompt box, follow the [earlier layout's steps](#check-which-layout-you-have).
4343* **Project folder**: click the project folder control, next to the environment selector, to choose the folder Claude works in.
4444 * **Cloud session**: select [repositories](#run-long-running-tasks-in-the-cloud) instead of a folder
4545 * **[Saved local or SSH environment](#create-a-saved-environment)**: the environment already holds its folders, so the row shows no project folder control. To change the folders, [edit the environment](#use-edit-or-remove-a-saved-environment).
from line 857
857857
858858> [!NOTE]
859859>
860> If your environment selector is above the prompt box, you have the [earlier layout](#check-which-layout-you-have), which has no saved local environments. Use the [local environment editor](#use-the-local-environment-editor) instead.
860> If a new session shows no environment under the prompt box, you have the [earlier layout](#check-which-layout-you-have), which has no saved local environments. Use the [local environment editor](#use-the-local-environment-editor) instead.
861861
862862**1. Open a local environment's form**
863863
from line 959
959959>
960960> If you use Desktop with a [third-party provider](https://code.claude.com/docs/en/third-party-integrations.md), SSH sessions need their own setup. See [SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions).
961961
962Add an SSH connection in the [**New environment** dialog](#create-a-saved-environment), then start a session on that connection. If a new session has no environment selector under the prompt box, you have the earlier layout. See [Check which layout you have](#check-which-layout-you-have).
962Add an SSH connection in the [**New environment** dialog](#create-a-saved-environment), then start a session on that connection. If a new session shows no environment under the prompt box, you have the earlier layout. See [Check which layout you have](#check-which-layout-you-have).
963963
964964**1. Open the New environment dialog**
965965
from line 2118
21182118
21192119### Check which layout you have
21202120
2121If a new session has no [environment selector](#start-a-session) under the prompt box, you have the earlier layout:
2121If a new session shows the [environment](#start-a-session) above the prompt box instead of under it, you have the earlier layout:
21222122
21232123* **[Desktop older than v2.37337.0](#check-your-version)**: update to get the current layout. Select **Claude > Check for Updates…** on macOS or **Help > Check for Updates…** on Windows.
21242124* **[Third-party provider](https://code.claude.com/docs/en/third-party-integrations.md) with sessions on your computer**: the current layout requires Claude Desktop v3.1623.0 or later, so [check your version](#check-your-version). To update, select **Claude > Check for Updates…** on macOS or **Help > Check for Updates…** on Windows. If your organization [turns off auto-updates](#device-management-policies), **Check for Updates…** is hidden, so ask your administrator for v3.1623.0 or later.
2125* **Third-party provider with sessions on your organization's infrastructure**: when your organization runs sessions on its own infrastructure rather than on your computer, Desktop keeps the earlier layout, and updating doesn't change the layout. If you don't know where your sessions run, ask your administrator.
2125* **Third-party provider with sessions on your organization's infrastructure**: the current layout requires Claude Desktop v4.29.0 or later, so [check your version](#check-your-version). If you're on an older version, ask your administrator for v4.29.0 or later. If you don't know where your sessions run, ask your administrator.
21262126
2127In the earlier layout, choose the environment and project folder above the prompt box, and the permission mode and model in the row under it. The earlier layout lacks the [session details panel](#see-session-details) and [saved local and SSH environments](#create-a-saved-environment).
2127In the earlier layout, choose the environment and any project folder or repository above the prompt box, and the permission mode and model in the row under it. The earlier layout lacks the [session details panel](#see-session-details) and [saved local and SSH environments](#create-a-saved-environment).
21282128
21292129### 403 or authentication errors in the Code tab
21302130
No line in this hunk matches that.