Who this is for: IT administrators who install Claude Desktop on agency devices and connect it to Claude for Government.A fresh install of Claude Desktop connects to claude.ai. To connect it to Claude for Government instead, each device needs a setting that tells the app where to reach Claude for Government, and on managed devices the configuration profile also hides the claude.ai sign-in option. Once that setting is in place, everything else that governs the app (which products and features are available, model access, connectors, usage limits, a banner message) is controlled through the tenant and organization configuration pages in this portal and delivered to each user when they sign in.
Choose how to deploy
- Configure a single machine to confirm the app works on a representative device before a wider rollout, or to set up a small group of devices. An administrator installs the app on each device and enters the bootstrap address in the app’s built-in configuration window. On a device set up this way, the user can still sign in to claude.ai.
- Deploy to your fleet for a production rollout. Your device management system (for example Intune, Configuration Manager, or Jamf) installs the app with elevated rights and pushes the address as a configuration profile, so end users need no administrator rights to install it.
Before you begin
- User accounts exist. Claude Desktop signs users in to the same accounts as this portal. For each user, including your own test account, check with your tenant administrators that the user can sign in (a routing rule covers them) and has a seat tier with at least one model enabled.
- Devices and browsers can reach the hosts they need. Allow the hosts under Network access.
- The device meets Claude Desktop’s requirements. See the Claude Desktop system requirements for macOS and Windows device requirements. For a Windows fleet, work through the Windows fleet checklist.
- Devices used for Code have the software your users’ work needs. Code runs its commands with the software installed on the device. Cowork and Advanced file analysis in Chat run theirs in the app’s own virtual machine, which includes Python. For Git on Windows, see Installer and packaging.
- You have the installer. The macOS deployment guide and the Windows deployment guide cover where to download the installer and how to distribute it.
- The app is current. Deploy Claude Desktop 3.1623.4 or later.
Network access
Connections to the Claude for Government host and its sign-in service use HTTPS on port 443. Claude for Government does not publish IP addresses for its host or its sign-in service, so allowlist both by hostname.- App traffic. Allow Claude Desktop on every device to reach the Claude for Government host, which carries the app’s configuration and model inference.
- Browser sign-in traffic. Allow the browser on every device to reach the Claude for Government host, the Claude for Government sign-in service (a separate host that your Anthropic representative provides), and your agency’s identity provider. Sign-in happens in each user’s default browser, not in the app.
downloads.claude.ai. From this host the app downloads the agent helper described under Endpoint security software, which Chat, Cowork, and Code all need, and the Cowork workspace, which Cowork tasks and Advanced file analysis in Chat need. The app downloads each one whenever the device does not already have the version that the app needs. The offline installer for macOS and Windows includes them.- Hosts for icons, previews, and widgets. For connector icons, the artifact preview frame, and the interactive widgets that some connectors display, the app reaches the hosts listed under Non-essential services in Required egress paths, including
www.claudeusercontent.comandwww.google.com. If traffic is blocked, the app will run without icons, previews, and widgets. - Update hosts. On macOS and Windows, while automatic updates are on, also allow the hosts listed under Auto-updates in Required egress paths. The telemetry rows there never apply, because Claude for Government does not send telemetry to Anthropic.
- Hosts your tools and connectors use. Allow the hosts you add to Allowed network hosts (such as package registries), the addresses of any connectors you configure on the Config page (including Microsoft 365 if you set up that connector), and your telemetry collector if you set one.
- Proxies. The app supports routing its traffic through your network’s proxy server, as the Security and data handling page describes. If your proxy inspects TLS, validate sign-in, sending a message, and a shell command that Claude runs on a pilot device before rollout. See also Network proxy in the Claude Desktop documentation.
The bootstrap address
The setting that holds the address is calledbootstrapUrl, and its value is the Claude for Government host followed by the fixed path /gateway-api/user/bootstrap.
bootstrapUrl, and Claude for Government answers sign-in only on the host provided to your agency, so the app cannot sign in through such an alias.
How the app uses the bootstrap address
The address is the same for every device and user in your agency and carries no credentials or user information, so the same profile is safe to push to your whole fleet. A request to the address without a signed-in session is refused. When a user chooses Sign in with your organization, the app asks the Claude for Government host to start a sign-in, shows the pairing code it receives, and opens the host’s sign-in page in the user’s default browser. That page asks for the user’s agency email address, then sends the browser to the sign-in service and on to your agency’s identity provider. After signing in, the user acknowledges the system-use notification, confirms that the code shown in the browser matches the one in the app, and approves. Claude for Government then issues the app a session for that user, which the app stores encrypted on the device. The app presents that session, and nothing from the profile, when it downloads the user’s configuration from this address and for model inference on the same host. The configuration that the app downloads for a user includes product availability, tools, connectors, and plugins, network and folder limits, a banner message, and telemetry, update, and restart settings, all of which you manage in this portal. The models the user can choose come from the user’s seat tier.Configure a single machine
Video: Pilot Claude Desktop on one machine (1 min 34 s). Narrated with an AI-generated voice, with on-screen captions.
Launch the app without signing in
Enable developer mode
Open the configuration window
Enter the bootstrap address
trustBootstrapDelivery key) appears once the field has a value. Leave it off. With the switch on, the app trusts everything your Claude for Government host delivers without asking, including connectors and helper scripts that run on the device. That is the same trust the app extends when the bootstrap address comes from machine-wide device management. If you do turn it on, first confirm that the bootstrap address is on your Claude for Government host.Apply and sign in
Allow the gateway address
Run the verification checklist
Deploy to your fleet
Video: Deploy to your fleet (1 min 32 s). Narrated with an AI-generated voice, with on-screen captions.
true. The Linux file uses native JSON types.
- Keys for a separate sign-in provider, such as
bootstrapOidcandinferenceGatewayOidc, do not work with Claude for Government, because you cannot connect the app directly to your identity provider deploymentDisplayNameanddeploymentDisplaySubtitle, which name the connection in the app’s window, are discarded once the app downloads the user’s configuration after sign-indesktopHome, because the app’s home comes from Product availability on the Config page
macOS
Claude Desktop reads managed preferences in thecom.anthropic.claudefordesktop domain. Deploy a configuration profile that sets the keys in that domain. Have your management system install the profile for the whole computer, as a machine profile, not for one user account, and keep every key in that one profile.
.mobileconfig to start from, use the Export menu described under Configure a single machine. Before you upload the file, make sure it sets the keys above, and change PayloadScope to System if it says User.
Claude Desktop 6.6395.0 or later ignores a user-level profile on a Mac that also has a computer-level (machine) profile for the app. If you deployed a user-level profile, copy the keys you still need into the computer-level profile, install that profile, then remove the user-level one. On Macs that already have both, do this before the app updates.
Windows
Claude Desktop reads string (REG_SZ) values by name under HKLM\SOFTWARE\Policies\Claude. Deliver them with Intune, Group Policy, or any tool that writes machine policy. As a .reg file:
.reg file from the Export menu, check that the line in square brackets names HKEY_LOCAL_MACHINE, and change it if it does not. Under HKEY_CURRENT_USER, the app asks each user to allow the gateway address after sign-in, as in the Allow the gateway address step under Configure a single machine.
Keep every value in the same hive as bootstrapUrl, because once any value exists under HKLM\SOFTWARE\Policies\Claude the app ignores HKEY_CURRENT_USER entirely.
Cowork, the agentic workspace in Claude Desktop, requires the Virtual Machine Platform Windows optional feature. The Windows fleet checklist covers that feature and the remaining Windows prerequisites, and explains what to do if some devices are not ready for Cowork.
Linux
Place a JSON file at/etc/claude-desktop/managed-settings.json containing these keys at the top level.
"deploymentMode": "3p". Earlier versions treat a key they don’t recognize in this file as an error.
The file must be a regular file (not a symlink), and the file and its directory must be owned by root and must not be group- or world-writable. The Linux configuration file in the Claude Desktop documentation describes what the app does when the permissions are wrong.
Order of deployment
Deploy the configuration before the app wherever you can. A user whose device already has the profile opens Claude Desktop for the first time and lands directly on the Claude for Government sign-in screen, with no opportunity to sign in to claude.ai by mistake. The app reads managed configuration at launch. After you change the profile on a device where the app is already running, have the user fully quit it, including from the menu bar or system tray, and reopen it. Once the profile setsbootstrapUrl, disableDeploymentModeChooser, or any other key except the few that Claude Desktop exempts, the device is managed. The in-app configuration window becomes read-only, and the app ignores any configuration saved in that window.
Turning on developer mode does not change this: the configuration window stays read-only, so users can view the connection there but not change it. If a group of users needs a different connection, scope a different profile to their devices in your management system, or leave those devices without a profile and set them up as described under Configure a single machine. Removing the profile returns the device to local control.
Automatic updates
On macOS and Windows, Claude Desktop downloads and installs its own updates by default. On a Mac with the app in/Applications, macOS asks a user who is not an administrator for an administrator’s name and password before an update installs. Until someone enters them, the update does not install. If your agency distributes Claude Desktop updates itself, turn automatic updates off in both of the following places so that devices never update themselves.
- On the Config page. Have a tenant administrator turn on Block automatic updates and lock it, so that no level below theirs can turn updates back on. An organization owner can turn it on for their own organization, whose Config page offers no lock. Claude Desktop applies this setting once a user has signed in and the app has loaded their configuration from Claude for Government. With that configuration loaded, the app follows this setting alone, whether it is on or off, and ignores the profile value.
- In the profile. Add
disableAutoUpdateswith the valuetruebesidebootstrapUrlin your macOS and Windows profiles. The app applies the profile value only when it starts without a signed-in user, for example on a newly deployed device or when a user opens the app and has to sign in again because their session expired. Without the Config page setting, the profile value does not stop signed-in devices from updating.
disableAutoUpdates to true stops automatic updates for signed-in users too, until you remove the key.
On Linux, apt installs Claude Desktop updates, and the app does not download or install its own. The Block automatic updates setting and the disableAutoUpdates key do not change these updates. To stop the app’s own check of Anthropic’s update hosts for a new version, use both, with the key in the Linux file. To keep Linux devices on the versions your agency distributes, follow Auto-updates in the Claude Desktop documentation.
Confirm it worked
Video: Verify a managed device and spot common failures (1 min 40 s). Narrated with an AI-generated voice, with on-screen captions.
Check the sign-in screen
disableDeploymentModeChooser to true, the claude.ai sign-in option is hidden. If only the claude.ai sign-in appears, the configuration did not reach the app.Check that the device is managed
Generate a diagnostic report
.zip file, managed-config.txt shows where the configuration was read from and each key’s configured or default value, and lists anything it could not parse under Parse errors. Secret values are redacted. If the report has no such file, no configuration reached the app.Sign in and send a message
Confirm per-user settings arrived
Troubleshooting
~/Library/Logs/Claude-3p/main.log on macOS, %LOCALAPPDATA%\Claude-3p\logs\main.log on Windows, and ~/.config/Claude-3p/logs/main.log on Linux (~/.config/Claude/logs/main.log until the app is configured). The diagnostic report from the verification checklist produces a bundle that you can send to your Anthropic representative. Review it first.
Things to know
- Configuration changes made in this portal do not need to be pushed to devices. The app re-checks Claude for Government for changes about every 10 minutes (about every 30 minutes on Claude Desktop versions earlier than 1.46388.1) and at each launch. See When changes take effect.
- New and retired models appear in the model picker without any profile change; model access is controlled through seat tiers. Models in Claude Desktop covers a model that needs a newer version of Claude Desktop.