Configuration reference changedthird-party/claude-desktop/configuration
Nearest release: v2.1.310, published 4 hours after 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 23 Oct 2026 16:59 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 23 Oct 2026 18:07 UTC.
Upstream edited
Recorded here
Lines+25added
Lines−25removed
From line
356
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits59to this page, all time
The whole hunk
from line 356, old and new numbered
/
This page is larger than the 256 KiB this site keeps, so one side of the diff below stops where the stored text does.
from line 356
356356
357357**Proxy server URL.** Send the app’s and the agent’s traffic through this HTTP proxy instead of the operating system’s proxy settings.
358358
359[Guide for this setting](/docs/third-party/claude-desktop/network-proxy.md)
359[Guide for this setting](https://claude.com/docs/third-party/claude-desktop/network-proxy.md)
360360
361361[Self-hosted install](#self-hosted-column): MDM profile. Names the proxy for the person's computer, and a host's network belongs to its operator.
362362
from line 382
382382
383383**Proxy auto-config (PAC) URL.** URL of a PAC file that decides the proxy per request. Wins over the proxy server URL when both are set.
384384
385[Guide for this setting](/docs/third-party/claude-desktop/network-proxy.md)
385[Guide for this setting](https://claude.com/docs/third-party/claude-desktop/network-proxy.md)
386386
387387[Self-hosted install](#self-hosted-column): MDM profile. Describes the network of the person's computer, which Desktop applies to its own traffic.
388388
from line 503
503503>
504504> * Use inferenceIdpOidc with inferenceCredentialKind: "external-idp" once every desktop in the fleet is on a release that reads them. The original spelling will keep working; no end date has been set.
505505
506[Guide for this setting](/docs/third-party/claude-desktop/gateway.md#single-sign-on-with-your-identity-provider)
506[Guide for this setting](https://claude.com/docs/third-party/claude-desktop/gateway.md#single-sign-on-with-your-identity-provider)
507507
508508[Self-hosted install](#self-hosted-column): Not supported. Deprecated name for a sign-in that runs on the person's computer.
509509
from line 1455
14551455
14561456**SSH host allowlist.** SSH hosts for Code sessions. Unset: off unless the device’s Claude Code managed settings list hosts. An admin’s empty list: off even then. \* allows any host.
14571457
1458[Guide for this setting](/docs/third-party/claude-desktop/ssh-remote-sessions.md)
1458[Guide for this setting](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions.md)
14591459
14601460[Self-hosted install](#self-hosted-column): Not supported. Governs SSH sessions started from the person's computer, which self-hosted installs never offer.
14611461
from line 1483
14831483
14841484**SSH client program.** Absolute path to the OpenSSH ssh program the app runs for SSH sessions. Unset: the first ssh on the user’s PATH.
14851485
1486[Guide for this setting](/docs/third-party/claude-desktop/ssh-remote-sessions.md)
1486[Guide for this setting](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions.md)
14871487
14881488[Self-hosted install](#self-hosted-column): Not supported. Names the ssh program on the person's computer, and self-hosted installs offer no SSH sessions.
14891489
from line 1505
15051505
15061506One of: `auto`, `system-openssh`, `builtin`
15071507
1508[Guide for this setting](/docs/third-party/claude-desktop/ssh-remote-sessions.md)
1508[Guide for this setting](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions.md)
15091509
15101510[Self-hosted install](#self-hosted-column): Not supported. Chooses the SSH engine on the person's computer, and self-hosted installs offer no SSH sessions.
15111511
from line 1577
15771577
15781578**Allowed egress hosts.** Hosts agent tools may reach in Cowork and Chat (Code: in part). An empty list acts as unset for tools, but stops Claude opening sites in the built-in browser.
15791579
1580[Guide for this setting](/docs/third-party/claude-desktop/web-tools.md#web-fetch)
1580[Guide for this setting](https://claude.com/docs/third-party/claude-desktop/web-tools.md#web-fetch)
15811581
15821582[Self-hosted install](#self-hosted-column): Server side. Tools in the host's sessions make the network calls, so the host limits which addresses they may reach.
15831583
from line 1953
19531953
19541954**Enable tool search.** Load MCP tool schemas on demand (tool search) instead of inlining every schema into context.
19551955
1956[Guide for this setting](/docs/third-party/claude-desktop/gateway.md#mcp-tool-search)
1956[Guide for this setting](https://claude.com/docs/third-party/claude-desktop/gateway.md#mcp-tool-search)
19571957
19581958[Self-hosted install](#self-hosted-column): Server side. The host starts Claude Code, so it turns tool search on or off for its sessions.
19591959
from line 2367
23672367>
23682368> OAuth for a remote server: true to auto-register a client, a pre-registered client ID with tenant and scope, or mode “hosted” for an Anthropic-signed identity.
23692369>
2370> [Guide for this setting](/docs/third-party/claude-desktop/mcp-sign-in.md)
2370> [Guide for this setting](https://claude.com/docs/third-party/claude-desktop/mcp-sign-in.md)
23712371>
23722372> > **More detail**
23732373> >
from line 2833
28332833
28342834**Block essential telemetry.** Crash and performance reports to Anthropic.
28352835
2836[Guide for this setting](/docs/third-party/claude-desktop/telemetry.md#essential-telemetry)
2836[Guide for this setting](https://claude.com/docs/third-party/claude-desktop/telemetry.md#essential-telemetry)
28372837
28382838[Self-hosted install](#self-hosted-column): MDM profile. Desktop starts its crash reports to Anthropic at launch, before sign-in, and a host's sessions never send any.
28392839
from line 2853
28532853
28542854**Block nonessential telemetry.** Product-usage analytics (no message content) and diagnostic-report uploads.
28552855
2856[Guide for this setting](/docs/third-party/claude-desktop/telemetry.md#non-essential-telemetry)
2856[Guide for this setting](https://claude.com/docs/third-party/claude-desktop/telemetry.md#non-essential-telemetry)
28572857
28582858[Self-hosted install](#self-hosted-column): MDM profile. Desktop sends usage analytics to Anthropic from before sign-in, and a host's sessions never send any.
28592859
from line 3411
34113411
34123412booleanDefault: falseSince 1.21459.0
34133413
3414**Hide feature announcements.** Suppress unprompted feature-announcement UI: the post-update “What’s new” nudge and new-feature tips. Users can still open release notes themselves.
3415
3416[Self-hosted install](#self-hosted-column): Server side. Desktop hides its own announcements of new f
3414**Hide feature announcements.** Suppress unprompted feature-announcement UI: the post-updat
No line in this hunk matches that.