@anthropic-ai/claude-agent-sdk 0.3.319 → 0.3.321

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/manifest.json CHANGED
@@ -1,53 +1,52 @@
1
1
  {
2
- "version": "2.1.319",
2
+ "version": "2.1.321",
3
3
  "manifestSignatureEnforcement": "flag",
4
- "commit": "fbdd7e02e8530e4c2ade8cc67d30104e53d2c8f2",
5
- "buildDate": "2026-11-05T19:38:09Z",
4
+ "commit": "76bc735070b3499364675700dea5f5a133152e2e",
5
+ "buildDate": "2026-11-09T17:01:59Z",
6
6
  "platforms": {
7
7
  "darwin-arm64": {
8
8
  "binary": "claude",
9
- "checksum": "1f53587e92dee8e089fa349188a4cda64fa34ace6e7b0ca2ee278ddaa3cc2ebd",
10
- "size": 321995200
9
+ "checksum": "abc9feeeca8091d51b623291e044cf0528c2f6b74e0c1d6ef671d52c73f7cd3c",
10
+ "size": 323686048
11
11
  },
12
12
  "darwin-x64": {
13
13
  "binary": "claude",
14
- "checksum": "af6f1f5510ae98d56a155bf8f007aa9d5b44efccc9c10c8e10ef35039e95a940",
15
- "size": 336699808
14
+ "checksum": "f4e04d8726ee1343999679ad745eca2f6d263c2941f132b1fdca4283ee6d5f02",
15
+ "size": 338384032
16
16
  },
17
17
  "linux-arm64": {
18
18
  "binary": "claude",
19
- "checksum": "a7e687fd1cb054d651c7588223de3786c99d4c682365e3c3ae1e59ce7f3a591f",
20
- "size": 339797432
19
+ "checksum": "6bea0633074627ba79328e00115ed0588c3acf906a8463612b25db696dbfd3f0",
20
+ "size": 341501368
21
21
  },
22
22
  "linux-x64": {
23
23
  "binary": "claude",
24
- "checksum": "dabafec82ca1319fa43d8be36a10fc61b1d11821cb98ad5df04ad95e199b8eed",
25
- "size": 340226576
24
+ "checksum": "426c33815ca6645a772f722fbff10dbf2cbdb124a8aeab733c1365dbf8bbf61f",
25
+ "size": 341910032
26
26
  },
27
27
  "linux-arm64-musl": {
28
28
  "binary": "claude",
29
- "checksum": "244e1aaedb73cb73571c2d5f2380f7ad251ba7e010d2747a203d631a1e7bd2e8",
30
- "size": 324104456
29
+ "checksum": "d223ea603b4fe8521d35a47f1972fbb36f1028a40927f16160e6258e0b92d597",
30
+ "size": 325808392
31
31
  },
32
32
  "linux-x64-musl": {
33
33
  "binary": "claude",
34
- "checksum": "b0f74e3c97fc4df46101bc7bcd0054d0f63733261cd63e5a0413cd50d66197f2",
35
- "size": 326687304
34
+ "checksum": "efc4a3d94daf10c550cde589a4add37f67519be54252ba88f27e9627f7ad62b4",
35
+ "size": 328366664
36
36
  },
37
37
  "win32-x64": {
38
38
  "binary": "claude.exe",
39
- "checksum": "2e055732c9d03d22700d9046251a8370b673607bfcc9e4d16a1b0e8fb1345cbd",
40
- "size": 344807072
39
+ "checksum": "e6dae5fc45902b15751f2591a02f51760351c4788c5fd8291b3f1443d40c13a4",
40
+ "size": 346487456
41
41
  },
42
42
  "win32-arm64": {
43
43
  "binary": "claude.exe",
44
- "checksum": "59b1ace11fad7f95c17a4ba01cf50eb48af20cd133df93129b34aa8e633bd6b1",
45
- "size": 327968928
44
+ "checksum": "670a397b3a4ce02ad400f37abd7dd7b57a21791abf29b8551fe43204fd0bebae",
45
+ "size": 329652384
46
46
  }
47
47
  },
48
48
  "sdkCompat": {
49
49
  "testedWrapperVersions": [
50
- "0.3.286",
51
50
  "0.3.287",
52
51
  "0.3.288",
53
52
  "0.3.289",
@@ -76,7 +75,8 @@
76
75
  "0.3.315",
77
76
  "0.3.316",
78
77
  "0.3.317",
79
- "0.3.318"
78
+ "0.3.318",
79
+ "0.3.319"
80
80
  ],
81
81
  "harnessSchema": 1
82
82
  }
package/manifest.zst.json CHANGED
@@ -1,61 +1,60 @@
1
1
  {
2
- "version": "2.1.319",
2
+ "version": "2.1.321",
3
3
  "manifestSignatureEnforcement": "flag",
4
- "commit": "fbdd7e02e8530e4c2ade8cc67d30104e53d2c8f2",
5
- "buildDate": "2026-11-05T19:39:56Z",
4
+ "commit": "76bc735070b3499364675700dea5f5a133152e2e",
5
+ "buildDate": "2026-11-09T17:03:57Z",
6
6
  "platforms": {
7
7
  "darwin-arm64": {
8
8
  "binary": "claude.zst",
9
- "checksum": "82a59698bcec8a2074cb7bacbd130cf557c103523f1a450ad113ab8dd8778a8e",
10
- "size": 111335285,
9
+ "checksum": "2bc9e7541b21ab5a96a77b007f55211c59b5013276f14632f89ce67bf0507e01",
10
+ "size": 111928716,
11
11
  "bundle": {
12
- "checksum": "604ca06d6a5bb0b844644ec45230cb0f111e0add43070cb3b960254524b9c31a",
13
- "size": 111334988
12
+ "checksum": "ddbdf2b334e13d8bcd8f7957cbeaa6ebaa5be64e4859e63f9e362bbfee23d4e8",
13
+ "size": 111941707
14
14
  }
15
15
  },
16
16
  "darwin-x64": {
17
17
  "binary": "claude.zst",
18
- "checksum": "7e0ce461550d322fabb9f762f420b1599970cce2d54ca544862b98885a23a957",
19
- "size": 118519141,
18
+ "checksum": "af28fbe38aae061afd6a3f9af10475b42d22fb2e09de479e7f981d36eb51a922",
19
+ "size": 119128550,
20
20
  "bundle": {
21
- "checksum": "ef9da45c0f87263ebac1313e017afc02e6278167ca2d09fcea63884b733d9cde",
22
- "size": 118520064
21
+ "checksum": "f6694539ba77354bb19bc9bf26dbebbb50ae1388dfc27b90e6ec795cad1b76cc",
22
+ "size": 119122698
23
23
  }
24
24
  },
25
25
  "linux-arm64": {
26
26
  "binary": "claude.zst",
27
- "checksum": "fdd8a686cb0d4bba6f2a59d5f120de976b5d5ef976df029e48b802dd15381130",
28
- "size": 122648933
27
+ "checksum": "2921f56ccb6f4a930cf1ccc9d53269ee1595b8b5da167780385aaddee06af0c4",
28
+ "size": 123265873
29
29
  },
30
30
  "linux-x64": {
31
31
  "binary": "claude.zst",
32
- "checksum": "9977d90303740415af76bc808536b34620d0b30b7f08b0813603689875372ea0",
33
- "size": 123849614
32
+ "checksum": "ded331c1fbf8bdd00518599ac80a888a1d1aff3c799f3a15934adb96662094ff",
33
+ "size": 124473095
34
34
  },
35
35
  "linux-arm64-musl": {
36
36
  "binary": "claude.zst",
37
- "checksum": "208399806e35f559bb2418564a4486f66ec9eb6da012231b07cf567fb6d8bdc1",
38
- "size": 116648141
37
+ "checksum": "6d80aee15ac60895bee01972daff89179aee3a41098e20700b65ff10720996a7",
38
+ "size": 117273356
39
39
  },
40
40
  "linux-x64-musl": {
41
41
  "binary": "claude.zst",
42
- "checksum": "37e7dd52ce5978369ba465a41491a2d410050fb4928fbc439170f07fa3f2e24a",
43
- "size": 118052300
42
+ "checksum": "df08608308f8fee8ce525acdca6090cbcebb6b609ddb6ea49db3fe9ff89216fb",
43
+ "size": 118666429
44
44
  },
45
45
  "win32-x64": {
46
46
  "binary": "claude.exe.zst",
47
- "checksum": "74100ed046e9c26d9f71bcf7459291232fafcb5f5d3833c4e6216adba98f835b",
48
- "size": 125727473
47
+ "checksum": "d0e23af87588ccfbc011e18adc0736999957df8d37618802e2e65a6364fb736d",
48
+ "size": 126378145
49
49
  },
50
50
  "win32-arm64": {
51
51
  "binary": "claude.exe.zst",
52
- "checksum": "b762fea3d1aa6388812b8451103eb3efd52053b6201043b6063ae28aa518d8d2",
53
- "size": 119791890
52
+ "checksum": "7689cf83002b2c434b68d94850e121281d1899dafb56b9f51b3d37652d59119c",
53
+ "size": 120408235
54
54
  }
55
55
  },
56
56
  "sdkCompat": {
57
57
  "testedWrapperVersions": [
58
- "0.3.286",
59
58
  "0.3.287",
60
59
  "0.3.288",
61
60
  "0.3.289",
@@ -84,7 +83,8 @@
84
83
  "0.3.315",
85
84
  "0.3.316",
86
85
  "0.3.317",
87
- "0.3.318"
86
+ "0.3.318",
87
+ "0.3.319"
88
88
  ],
89
89
  "harnessSchema": 1
90
90
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@anthropic-ai/claude-agent-sdk",
3
- "version": "0.3.319",
3
+ "version": "0.3.321",
4
4
  "main": "sdk.mjs",
5
5
  "types": "sdk.d.ts",
6
6
  "exports": {
@@ -61,14 +61,14 @@
61
61
  "zod": "^4.0.0"
62
62
  },
63
63
  "optionalDependencies": {
64
- "@anthropic-ai/claude-agent-sdk-linux-x64": "0.3.319",
65
- "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.3.319",
66
- "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.3.319",
67
- "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.3.319",
68
- "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.3.319",
69
- "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.3.319",
70
- "@anthropic-ai/claude-agent-sdk-win32-x64": "0.3.319",
71
- "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.3.319"
64
+ "@anthropic-ai/claude-agent-sdk-linux-x64": "0.3.321",
65
+ "@anthropic-ai/claude-agent-sdk-linux-arm64": "0.3.321",
66
+ "@anthropic-ai/claude-agent-sdk-linux-x64-musl": "0.3.321",
67
+ "@anthropic-ai/claude-agent-sdk-linux-arm64-musl": "0.3.321",
68
+ "@anthropic-ai/claude-agent-sdk-darwin-x64": "0.3.321",
69
+ "@anthropic-ai/claude-agent-sdk-darwin-arm64": "0.3.321",
70
+ "@anthropic-ai/claude-agent-sdk-win32-x64": "0.3.321",
71
+ "@anthropic-ai/claude-agent-sdk-win32-arm64": "0.3.321"
72
72
  },
73
73
  "files": [
74
74
  "sdk.mjs",
@@ -85,10 +85,10 @@
85
85
  "extractFromBunfs.d.ts",
86
86
  "manifest.json",
87
87
  "manifest.zst.json",
88
- "core-5fx2pfbt.mjs",
89
- "core-actjkrgm.mjs",
90
- "core-ed8v4zmx.mjs",
91
- "core-ytn251z7.mjs"
88
+ "core-4jkx88px.mjs",
89
+ "core-9cm2w1sd.mjs",
90
+ "core-hz6x1gbv.mjs",
91
+ "core-ke81nxtn.mjs"
92
92
  ],
93
- "claudeCodeVersion": "2.1.319"
93
+ "claudeCodeVersion": "2.1.321"
94
94
  }
package/sdk-tools.d.ts CHANGED
@@ -4200,6 +4200,7 @@ export interface CronCreateOutput {
4200
4200
  }
4201
4201
  export interface CronDeleteOutput {
4202
4202
  id: string;
4203
+ endedLoopWakeup?: true;
4203
4204
  }
4204
4205
  export interface CronListOutput {
4205
4206
  jobs: {
package/sdk.d.ts CHANGED
@@ -1261,6 +1261,7 @@ export declare type McpSdkServerConfig = {
1261
1261
  timeout?: number;
1262
1262
 
1263
1263
 
1264
+
1264
1265
  /**
1265
1266
  * Per-tool permission policy the host declares for this server's tools (not the tool definitions passed to createSdkMcpServer). always_ask: the CLI asks the host (canUseTool or the permission prompt tool) before each call, even where an allow rule or allowedTools covers the tool, and under bypassPermissions outside a hosted remote session (CLAUDE_CODE_REMOTE); under dontAsk the call is denied; in auto mode the classifier decides, except that by default a tool annotated destructiveHint still asks. always_deny: calls are denied. always_allow and org_max_permission are ignored on sdk servers; grant allows with allowedTools or canUseTool. Read from initialize (sdkMcpServerConfigs) and from each mcp_set_servers entry that names the server. On the wire an entry without tools states no policy: on initialize the stored list and the rules stand; on mcp_set_servers the rules are replaced without them. The Agent SDK always re-sends the registered list. An entry whose policy is not one of the three asks; an entry without a string name is dropped and the rest apply; a value that is not a list reads as absent.
1266
1267
  */
@@ -4724,7 +4725,7 @@ declare type SDKControlInitializeRequest = {
4724
4725
  hooks?: Partial<Record<coreTypes.HookEvent, SDKHookCallbackMatcher[]>>;
4725
4726
  sdkMcpServers?: string[];
4726
4727
  /**
4727
- * Settings for the SDK-hosted MCP servers named in sdkMcpServers, keyed by server name. Sent as a separate field so a CLI that predates it ignores it; entries whose name is not in sdkMcpServers, and values that do not match this shape, are ignored rather than rejected. timeout, disableAutoBackground and connectorId apply when the server is first registered; tools (the per-tool permission policy) adds its ask and deny rules on every initialize that names the server. An initialize never removes a rule; mcp_set_servers replaces them.
4728
+ * Settings for the SDK-hosted MCP servers named in sdkMcpServers, keyed by server name. Sent as a separate field so a CLI that predates it ignores it; entries whose name is not in sdkMcpServers, and values that do not match this shape, are ignored rather than rejected. timeout, disableAutoBackground, connectorId and autoModeVerdictTools apply when the server is first registered; tools (the per-tool permission policy) adds its ask and deny rules on every initialize that names the server. An initialize never removes a rule; mcp_set_servers replaces them.
4728
4729
  */
4729
4730
  sdkMcpServerConfigs?: Record<string, {
4730
4731
  /**
@@ -4733,6 +4734,7 @@ declare type SDKControlInitializeRequest = {
4733
4734
  timeout?: number;
4734
4735
 
4735
4736
 
4737
+
4736
4738
  /**
4737
4739
  * Per-tool permission policy the host declares for this server's tools (not the tool definitions passed to createSdkMcpServer). always_ask: the CLI asks the host (canUseTool or the permission prompt tool) before each call, even where an allow rule or allowedTools covers the tool, and under bypassPermissions outside a hosted remote session (CLAUDE_CODE_REMOTE); under dontAsk the call is denied; in auto mode the classifier decides, except that by default a tool annotated destructiveHint still asks. always_deny: calls are denied. always_allow and org_max_permission are ignored on sdk servers; grant allows with allowedTools or canUseTool. Read from initialize (sdkMcpServerConfigs) and from each mcp_set_servers entry that names the server. On the wire an entry without tools states no policy: on initialize the stored list and the rules stand; on mcp_set_servers the rules are replaced without them. The Agent SDK always re-sends the registered list. An entry whose policy is not one of the three asks; an entry without a string name is dropped and the rest apply; a value that is not a list reads as absent.
4738
4740
  */
@@ -4828,6 +4830,7 @@ export declare type SDKControlInitializeResponse = {
4828
4830
 
4829
4831
 
4830
4832
 
4833
+
4831
4834
  /**
4832
4835
  * Whether the `hooks` this initialize carried were registered: true on a session's first initialize, and on a repeated initialize from the process that owns the CLI's stdin (its set replaces the one registered earlier); false when a repeated initialize's hooks were ignored (a client joining a remote session another client configured). Absent when the request carried no hooks, and on CLIs that predate the field — those ignored `hooks` on every repeated initialize.
4833
4836
  */
@@ -4837,6 +4840,7 @@ export declare type SDKControlInitializeResponse = {
4837
4840
  */
4838
4841
  hook_on_failure_supported?: boolean;
4839
4842
 
4843
+
4840
4844
  /**
4841
4845
  * Whether every plugin this initialize listed is loaded: true when each one is among the plugins the process loaded at launch (from `plugins` under --await-initialize, or from --plugin-dir), so a re-sent initialize naming the launch set also reads true; false otherwise. The `plugins` field never loads anything after launch. Absent when the request listed no plugins, and on CLIs that predate the field (those never read `plugins`).
4842
4846
  */
@@ -4886,6 +4890,7 @@ declare type SDKControlInterruptRequest = {
4886
4890
 
4887
4891
 
4888
4892
 
4893
+
4889
4894
  };
4890
4895
 
4891
4896
  /**
@@ -4900,7 +4905,7 @@ export declare type SDKControlInterruptResponse = {
4900
4905
 
4901
4906
 
4902
4907
  /**
4903
- * Present only when the request set cancel_queued:true — uuids of main-thread commands cancelled by this interrupt: every survivor that would otherwise have appeared under `still_queued`, including any uuid that was mid-fold at the interrupt instant (this request also aborts, so the fold never delivers it). Each listed uuid has been removed (queue-resident), dropped before it was queued (a message this process had read and was still holding), or marked cancel-pending (the first-command prewait window, closed by the drain loop's backstop) and emits a terminal 'cancelled' lifecycle synchronously at the first such interrupt (a repeat interrupt over the same parked batch re-lists the uuid idempotently without re-emitting); none will run. Where one of them is the re-run of an interrupted turn that also answered for other client messages whose re-sent copies had been set aside for it, those messages' uuids are listed behind the commands' too: they were in no queue and never under `still_queued`, each has its terminal 'cancelled' lifecycle, and a repeat interrupt does not list them again. Same coverage caveats as `still_queued` (uuid-stamped main-thread only; internally-enqueued uuids may appear). Advertised by the `interrupt_cancel_queued_v1` capability.
4908
+ * Present only when the request set cancel_queued:true, with one exception that the last sentence names — uuids of main-thread commands cancelled by this interrupt: every survivor that would otherwise have appeared under `still_queued`, including any uuid that was mid-fold at the interrupt instant (this request also aborts, so the fold never delivers it). Each listed uuid has been removed (queue-resident), dropped before it was queued (a message this process had read and was still holding), or marked cancel-pending (the first-command prewait window, closed by the drain loop's backstop) and emits a terminal 'cancelled' lifecycle synchronously at the first such interrupt (a repeat interrupt over the same parked batch re-lists the uuid idempotently without re-emitting); none will run. Where one of them is the re-run of an interrupted turn that also answered for other client messages whose re-sent copies had been set aside for it, those messages' uuids are listed behind the commands' too: they were in no queue and never under `still_queued`, each has its terminal 'cancelled' lifecycle, and a repeat interrupt does not list them again. Same coverage caveats as `still_queued` (uuid-stamped main-thread only; internally-enqueued uuids may appear). Advertised by the `interrupt_cancel_queued_v1` capability. The exception, in a remote session and behind a flag: an interrupt with neither cancel_queued nor for_user_message_uuids, which no service wrote, also carries this field where it cancelled messages that the server had sent again and that this process held aside to run later; it then lists those alone, and no capability advertises it.
4904
4909
  */
4905
4910
  cancelled?: string[];
4906
4911
  };
@@ -5050,6 +5055,7 @@ declare type SDKControlMcpSetServersRequest = {
5050
5055
 
5051
5056
 
5052
5057
 
5058
+
5053
5059
  };
5054
5060
 
5055
5061
  /**
@@ -6128,6 +6134,7 @@ export declare type SDKResultSuccess = {
6128
6134
 
6129
6135
 
6130
6136
 
6137
+
6131
6138
 
6132
6139
 
6133
6140
  user_message_uuid?: string;
@@ -6137,6 +6144,7 @@ export declare type SDKResultSuccess = {
6137
6144
  request_sent_wall_ms?: number;
6138
6145
 
6139
6146
 
6147
+
6140
6148
  first_content_frame_ms?: number;
6141
6149
  first_stream_post_ms?: number;
6142
6150
  first_stream_post_ack_ms?: number;
@@ -9116,7 +9124,7 @@ export declare interface Settings {
9116
9124
  */
9117
9125
  pluginSuggestionMarketplaces?: string[];
9118
9126
  /**
9119
- * Force a specific login method: "claudeai" for Claude Pro/Max, "console" for Console billing, "gateway" for the Cloud gateway OIDC device flow
9127
+ * Force a specific login method: "claudeai" for a Claude subscription (individual, Team, or Enterprise plans), "console" for Console billing, "gateway" for the Cloud gateway OIDC device flow
9120
9128
  */
9121
9129
  forceLoginMethod?: 'claudeai' | 'console' | 'gateway';
9122
9130
  /**
@@ -9140,7 +9148,7 @@ export declare interface Settings {
9140
9148
  */
9141
9149
  forceLoginOrgUUID?: string | string[];
9142
9150
  /**
9143
- * Managed settings only (managed-settings.json, MDM, or server-managed). The API providers Claude Code may use on this machine: "anthropic" (the Anthropic API on Anthropic's own host, via a claude.ai or Console sign-in or an API key; pair it with forceLoginMethod / forceLoginOrgUUID to require a sign-in), "bedrock", "vertex", "foundry", "anthropicAws", "mantle" (each meaning that provider's own service: its regional, FIPS, private-endpoint and sovereign-cloud hosts), "customEndpoint" (the Anthropic API or a cloud provider's API sent to some other host — ANTHROPIC_BASE_URL, that provider's ANTHROPIC_*_BASE_URL, a Foundry resource name that is not a bare name, or for Bedrock the AWS SDK's AWS_ENDPOINT_URL[_BEDROCK[_RUNTIME]] — such as an LLM gateway; admitted only for the value pinned in the "env" block of the same managed source), or "gateway" (the Cloud gateway sign-in). A session on a provider that is not listed is refused at startup, at login, and when it next contacts the API, with a message naming what selected the provider and the entry that would allow it. Under a list, where first-party traffic goes (ANTHROPIC_BASE_URL, a gateway sign-in) is honored only when the same managed source pins it in "env" (or forceLoginGatewayUrl), and a claude ssh tunnel into the machine is refused. A cloud provider's credential and tenancy variables, and the network path and TLS trust (HTTPS_PROXY, NODE_EXTRA_CA_CERTS, CLAUDE_CODE_CERT_STORE), are not judged by this list; set those for the fleet in the managed "env" block, whose values replace the user's. To route Bedrock through a gateway for a fleet, pin ANTHROPIC_BEDROCK_BASE_URL there (it is what the clients use, ahead of an endpoint_url in ~/.aws/config, which this list does not judge); the AWS SDK's AWS_ENDPOINT_URL* pins only sanction where the SDK's own clients go and never stand in for the "bedrock" entry. Unset allows every provider; an empty array allows none. Only a list in managed-settings.json or MDM is enforcement on the machine: it cannot be widened or hidden by server-managed settings and reaches every session. A list set only in the admin console reaches only sessions that fetch your server-managed settings — not a session on a cloud provider, another organization or a non-Anthropic ANTHROPIC_BASE_URL, one authenticating only with apiKeyHelper or ANTHROPIC_AUTH_TOKEN, a Pro/Max login, --bare without an API key, or a first launch before the fetch lands — all conditions the user controls. Versions that predate this setting ignore it; pair it with a minimum-version policy on a mixed fleet. 'claude auth status' reports the Anthropic API as apiProvider "firstParty".
9151
+ * Managed settings only (managed-settings.json, MDM, or server-managed). The API providers Claude Code may use on this machine: "anthropic" (the Anthropic API on Anthropic's own host, via a claude.ai or Console sign-in or an API key; pair it with forceLoginMethod / forceLoginOrgUUID to require a sign-in), "bedrock", "vertex", "foundry", "anthropicAws", "mantle" (each meaning that provider's own service: its regional, FIPS, private-endpoint and sovereign-cloud hosts), "customEndpoint" (the Anthropic API or a cloud provider's API sent to some other host — ANTHROPIC_BASE_URL, that provider's ANTHROPIC_*_BASE_URL, a Foundry resource name that is not a bare name, or for Bedrock the AWS SDK's AWS_ENDPOINT_URL[_BEDROCK[_RUNTIME]] — such as an LLM gateway; admitted only for the value pinned in the "env" block of the same managed source), or "gateway" (the Cloud gateway sign-in). A session on a provider that is not listed is refused at startup, at login, and when it next contacts the API, with a message naming what selected the provider and the entry that would allow it. Under a list, where first-party traffic goes (ANTHROPIC_BASE_URL, a gateway sign-in) is honored only when the same managed source pins it in "env" (or forceLoginGatewayUrl), and a claude ssh tunnel into the machine is refused. A cloud provider's credential and tenancy variables, and the network path and TLS trust (HTTPS_PROXY, NODE_EXTRA_CA_CERTS, CLAUDE_CODE_CERT_STORE), are not judged by this list; set those for the fleet in the managed "env" block, whose values replace the user's. To route Bedrock through a gateway for a fleet, pin ANTHROPIC_BEDROCK_BASE_URL there (it is what the clients use, ahead of an endpoint_url in ~/.aws/config, which this list does not judge); the AWS SDK's AWS_ENDPOINT_URL* pins only sanction where the SDK's own clients go and never stand in for the "bedrock" entry. Unset allows every provider; an empty array allows none. Only a list in managed-settings.json or MDM is enforcement on the machine: it cannot be widened or hidden by server-managed settings and reaches every session. A list set only in the admin console reaches only sessions that fetch your server-managed settings — not a session on a cloud provider, another organization or a non-Anthropic ANTHROPIC_BASE_URL, one authenticating only with apiKeyHelper or ANTHROPIC_AUTH_TOKEN, a Pro/Max/Ultra login, --bare without an API key, or a first launch before the fetch lands — all conditions the user controls. Versions that predate this setting ignore it; pair it with a minimum-version policy on a mixed fleet. 'claude auth status' reports the Anthropic API as apiProvider "firstParty".
9144
9152
  */
9145
9153
  allowedProviders?: ('anthropic' | 'customEndpoint' | 'bedrock' | 'vertex' | 'foundry' | 'anthropicAws' | 'mantle' | 'gateway')[];
9146
9154
  /**