Page history
Configuration changelog
third-party/claude-desktop/configuration-changelog
History
third-party/claude-desktop/configuration-changelog First recorded · 722 lines, first recorded
# Configuration changelog
The first capture of this source. The page was already there, and this is what it said.
# Configuration changelog
> Managed configuration keys by the Claude Desktop release they first shipped in
Configuration keys by Claude Desktop release. Each section lists keys added in that release, with the MDM key name (for plist/registry deployment) and the equivalent JSON shape (for local-file or bootstrap remote configuration).
<Update label="v1.30096.1" description="2026-08-13">
<div className="cfg-keys">
| MDM key | Type | Description |
| ------------------------------------------------------------------------------------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [`otlpAuthMode`](/docs/third-party/claude-desktop/configuration#otlpauthmode) | `enum` | Collector authentication |
| [`otlpHeadersHelper`](/docs/third-party/claude-desktop/configuration#otlpheadershelper) | `string` | OpenTelemetry headers helper script |
| [`inferenceGatewayOidc.resource`](/docs/third-party/claude-desktop/configuration#inferencegatewayoidc) | `string` | New subfield: RFC 8707 resource indicator sent on gateway sign-in and token refresh so the IdP audience-restricts the access token to the gateway; leave unset for Microsoft Entra ID. |
</div>
**JSON (e.g. for non-MDM users or Bootstrap):**
```json theme={null}
{
"otlp": {
"authMode": "<none|inference-credential>",
"headersHelper": "<string>"
},
"inference": {
"credential": {
"oidc": {
"resource": "<string>"
}
}
}
}
```
**Changed:**
* `inferenceBedrockBaseUrl` and `inferenceVertexBaseUrl`: only affects users who entered the bootstrap server URL themselves (in Settings or a local config file). Those users are now asked once to allow a Bedrock or Vertex endpoint that server delivers (and again if it changes) before it takes effect, the same `trustBootstrapDelivery` consent prompt `inferenceGatewayBaseUrl` already shows; the provider's default endpoint is used until they allow it. Managed deployments (bootstrap URL set by device management, or `trustBootstrapDelivery: true`) see no change.
</Update>
<Update label="v1.28929.0" description="2026-08-11">
<div className="cfg-keys">
| MDM key | Type | Description |
| ------------------------------------------------------------------------------------------- | --------- | -------------------------------------------------------------------------------------------------------------------- |
| [`modelPrefer1mContext`](/docs/third-party/claude-desktop/configuration#modelprefer1mcontext) | `boolean` | Default to 1M context |
| [`claudeAiImport.enabled`](/docs/third-party/claude-desktop/configuration#claudeaiimport) | `boolean` | New subfield: turns history import on; the banner and import actions stay off until set to `true` (default `false`). |
| [`claudeAiImport.bannerBehavior`](/docs/third-party/claude-desktop/configuration#claudeaiimport) | `enum` | New subfield: when the import banner appears: `off` (default), `detect`, or `show`. |
</div>
**JSON (e.g. for non-MDM users or Bootstrap):**
```json theme={null}
{
"models": {
"prefer1mContext": "<boolean>"
},
"claudeAiImport": {
"enabled": "<boolean>",
"bannerBehavior": "<off|detect|show>"
}
}
```
**Changed:**
* `inferenceGatewayBaseUrl` delivered by a bootstrap server now goes through the `trustBootstrapDelivery` consent prompt: unless the bootstrap URL came from device management or `trustBootstrapDelivery` is `true`, each user is asked once to allow the address, and again if it changes, before it takes effect.
</Update>
<Update label="v1.26832.0" description="2026-08-06">
<div className="cfg-keys">
| MDM key | Type | Description |
| ----------------------------------------------------------------------------------------------------- | --------- | --------------------------------------------------------------------------------------- |
| [`updateViaUpdatesHost`](/docs/third-party/claude-desktop/configuration#updateviaupdateshost) | `boolean` | Check for updates on releases.claude.com |
| [`allowedWorkspaceFolders[].mode`](/docs/third-party/claude-desktop/configuration#allowedworkspacefolders) | `enum` | New subfield: `ro` makes the folder read-only in Cowork; Code enforces file tools only. |
</div>
**JSON (e.g. for non-MDM users or Bootstrap):**
```json theme={null}
{
"autoUpdate": {
"viaUpdatesHost": "<boolean>"
}
}
```
`trustBootstrapLocalExec` was renamed to `trustBootstrapDelivery`; the previous name is still accepted.
</Update>
<Update label="v1.25927.0" description="2026-08-04">
<div className="cfg-keys">
| MDM key | Type | Description |
| ---------------------------------------------------------------------------------------------------------------- | --------- | ---------------------------------------- |
| [`inferenceGatewayOidcAuthFlow`](/docs/third-party/claude-desktop/configuration#inferencegatewayoidcauthflow) | `enum` | Gateway sign-in flow |
| [`inferenceVertexWorkforceAuthFlow`](/docs/third-party/claude-desktop/configuration#inferencevertexworkforceauthflow) | `enum` | Workforce Identity sign-in flow |
| [`trustBootstrapLocalExec`](/docs/third-party/claude-desktop/configuration#trustbootstrapdelivery) | `boolean` | Trust bootstrap-delivered local commands |
| [`skillCreationEnabled`](/docs/third-party/claude-desktop/configuration#skillcreationenabled) | `boolean` | Allow user-created skills |
</div>
**JSON (e.g. for non-MDM users or Bootstrap):**
```json theme={null}
{
"inference": {
"credential": {
"authFlow": "<browser|broker>"
}
},
"bootstrap": {
"trustBootstrapLocalExec": "<boolean>"
},
"workspace": {
"skillCreationEnabled": "<boolean>"
}
}
```
**Changed:**
* `claudeAiImport`, `deploymentDisplayName`, and `deploymentDisplaySubtitle` now accept values from MDM and a local configuration file as well as a bootstrap server, and `disableDeepLinkRegistration`, `microsoftAuthBroker`, `userContentRendererUrl`, `inferenceFoundryTenantId`, `inferenceFoundryClientId`, `inferenceCredentialHelper` (with its TTL, timeout, and silent-refresh keys), `inferenceBedrockProfile`, `inferenceBedrockAwsDir`, `inferenceBedrockAwsCliPath`, and `inferenceVertexCredentialsFile` can now be delivered by a bootstrap server. The keys that name a local executable go through the `trustBootstrapLocalExec` consent prompt.
* `managedMcpServers` gains a built-in `github` server: set `server` to `github` and supply your own GitHub OAuth app client ID with the device flow enabled. The new `host`, `toolsets`, and `readOnly` subfields point the connector at a GitHub Enterprise Server instance, choose which toolsets load, and offer read tools only.
* `managedMcpServers[].oauth.authFlow` is a new subfield that lets a managed connector sign in through the operating system's Microsoft Entra account broker on Windows and macOS, so Conditional Access policies that require a managed device no longer block it. Devices without a broker keep using browser sign-in.
* `enduserAttribution` is renamed to the corrected spelling `endUserAttribution`. The previous spelling is still accepted and now records a configuration warning.
* `organizationPluginsUrl` is deprecated and removed from the configuration reference. The key is still honored, but organization plugins are better configured with `allowedPluginMarketplaces`.
</Update>
<Update label="v1.24012.11" description="2026-08-03">
No configuration changes in this release.
</Update>
<Update label="v1.24012.9" description="2026-07-24">
<div className="cfg-keys">
| MDM key | Type | Description |
| -------------------------------------------------------------------------------------------------------------- | --------- | ------------------------------- |
| [`mcpPersistentAlwaysAllowEnabled`](/docs/third-party/claude-desktop/configuration#mcppersistentalwaysallowenabled) | `boolean` | Allow persistent tool approvals |
</div>
**JSON (e.g. for non-MDM users or Bootstrap):**
```json theme={null}
{
"mcp": {
"persistentAlwaysAllowEnabled": "<boolean>"
}
}
```
</Update>
<Update label="v1.24012.0" description="2026-07-21">
<div className="cfg-keys">
| MDM key | Type | Description |
| -------------------------------------------------------------------------------------------- | --------- | ------------------------------ |
| [`enduserAttribution`](/docs/third-party/claude-desktop/configuration#enduserattribution) | `boolean` | End-user attribution |
| [`userContentRendererUrl`](/docs/third-party/claude-desktop/configuration#usercontentrendererurl) | `string` | Artifact preview iframe origin |
</div>
**JSON (e.g. for non-MDM users or Bootstrap):**
```json theme={null}
{
"deploymentDisplayName": "<string>",
"deploymentDisplaySubtitle": "<string>",
"enduserAttribution": "<boolean>",
"userContentRendererUrl": "<string>"
}
```
</Update>
<Update label="v1.22209.3" description="2026-07-19">
No configuration changes in this release.
</Update>
<Update label="v1.22209.0" description="2026-07-16">
<div className="cfg-keys">
| MDM key | Type | Description |
| ---------------------------------------------------------------------------------- | --------- | -------------------- |
| [`otlpTracesEnabled`](/docs/third-party/claude-desktop/configuration#otlptracesenabled) | `boolean` | Export traces (beta) |
</div>
**JSON (e.g. for non-MDM users or Bootstrap):**
```json theme={null}
{
"otlp": {
"tracesEnabled": "<boolean>"
}
}
```
</Update>
<Update label="v1.21459.3" description="2026-07-16">
No configuration changes in this release.
</Update>
<Update label="v1.21459.0" description="2026-07-14">
<div className="cfg-keys">
| MDM key | Type | Description |
| ------------------------------------------------------------------------------------------------------------------ | --------- | ------------------------------------------------------------------------------------------------------------ |
| [`disableFeatureDiscovery`](/docs/third-party/claude-desktop/configuration#disablefeaturediscovery) | `boolean` | Hide feature announcements |
| [`inferenceModels[].prefer1m`](/docs/third-party/claude-desktop/configuration#inferencemodels) | `boolean` | New subfield: make the 1M-context variant the default picker selection when this model is the default entry. |
| [`managedMcpServers[].envHelper`](/docs/third-party/claude-desktop/configuration#managedmcpservers) | `string` | New subfield: helper executable that prints environment variables as JSON for a managed stdio server. |
| [`managedMcpServers[].envHelperTtlSec`](/docs/third-party/claude-desktop/configuration#managedmcpservers) | `integer` | New subfield: maximum age in seconds of a cached `envHelper` result (default 300). |
| [`managedMcpServers[].headersHelperRefreshBufferSec`](/docs/third-party/claude-desktop/configuration#managedmcpservers) | `integer` | New subfield: how many seconds before credential expiry the `headersHelper` re-runs (default 60). |
| [`toolSearchEnabled`](/docs/third-party/claude-desktop/configuration#toolsearchenabled) | `boolean` | Enable tool search |
</div>
**JSON (e.g. for non-MDM users or Bootstrap):**
```json theme={null}
{
"featureDiscovery": {
"disabled": "<boolean>"
},
"workspace": {
"toolSearchEnabled": "<boolean>"
}
}
```
**Changed:**
* `chatTabEnabled` and `chatAdvancedFileAnalysisEnabled` are no longer Beta: the Chat tab and advanced file analysis are generally available. Availability and defaults are unchanged, and both remain opt-in.
* `orgPluginSettings[].tools.permission` accepts a new `ask-session` value. In this release the value is accepted but behaves as `ask` (a prompt on every use); the once-per-session approval flow is not yet enabled.
</Update>
<Update label="v1.20186.9" description="2026-07-14">
No configuration changes in this release.
</Update>
<Update label="v1.20186.0" description="2026-07-09">
No configuration changes in this release.
</Update>
<Update label="v1.19367.0" description="2026-07-07">
<div className="cfg-keys">
| MDM key | Type | Description |
| ------------------------------------------------------------------------------------------------------ | --------- | --------------------------------------------------------------------------------- |
| [`inferenceFoundryAuthFlow`](/docs/third-party/claude-desktop/configuration#inferencefoundryauthflow) | `enum` | Entra ID sign-in flow |
| [`microsoftAuthBroker`](/docs/third-party/claude-desktop/configuration#microsoftauthbroker) | `enum` | Microsoft 365 native sign-in broker |
| [`managedMcpServers[].startupTimeoutSec`](/docs/third-party/claude-desktop/configuration#managedmcpservers) | `integer` | New subfield: maximum wait in seconds for the server to start and list its tools. |
</div>
**JSON (e.g. for non-MDM users or Bootstrap):**
```json theme={null}
{
"inference": {
"credential": {
"authFlow": "<device-code|browser>"
}
},
"authentication": {
"microsoftAuthBroker": "<auto|disabled>"
}
}
```
**Changed:**
* `isDesktopExtensionEnabled` — default changed from `true` to `false`: Desktop Extensions (`.dxt`, `.mcpb`) no longer load unless explicitly enabled.
* `allowedPluginMarketplaces` (beta) — can now be delivered per-user through the bootstrap server; previously MDM-only.
</Update>
<Update label="v1.18286.2" description="2026-07-07">
No configuration changes in this release.
</Update>
<Update label="v1.18286.0" description="2026-07-02">
**Removed:**
* `disableDefaultPlugins` — third-party deployments always skip the default plugin marketplaces and standard deployments always include them, so the key no longer has an effect.
</Update>
<Update label="v1.17377.2" description="2026-07-01">
No configuration changes in this release.
</Update>
<Update label="v1.17377.1" description="2026-06-30">
<div className="cfg-keys">
| MDM key | Type | Description |
| -------------------------------------------------------------------------------------------------------------------------- | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| [`allowedPluginMarketplaces`](/docs/third-party/claude-desktop/configuration#allowedpluginmarketplaces) | `object[]` | Admin-configured plugin marketplace git URLs appear under the Directory's Organization tab. (MDM-only; not settable via bootstrap JSON.) |
| [`inferenceVertexWorkforceOidc.omitOfflineAccess`](/docs/third-party/claude-desktop/configuration#inferencevertexworkforceoidc) | `boolean` | New subfield: omit `offline_access` from the OIDC scope request. |
</div>
**JSON (Non-MDM User, Bootstrap Remote):**
```json theme={null}
{
"inference": {
"credential": {
"oidc": {
"omitOfflineAccess": "<boolean>"
}
}
}
}
```
</Update>
<Update label="v1.15962.2" description="2026-06-30">
No configuration changes in this release.
Cut at 300 lines.