SpyBara
Go Premium

Documentation 2025-12-04 21:02 UTC to 2025-12-05 00:04 UTC

6 files changed +37 −56. View all changes and history on the product overview
2025
Sat 27 06:02 Tue 23 18:02 Sat 20 00:04 Fri 19 21:01 Thu 18 21:01 Wed 17 15:02 Tue 16 21:01 Mon 15 21:01 Sat 13 06:02 Fri 12 21:01 Thu 11 21:02 Wed 10 09:03 Tue 9 18:01 Mon 8 21:01 Sat 6 18:02 Fri 5 00:04 Thu 4 21:02 Wed 3 00:04 Tue 2 21:01 Mon 1 03:31

iam.md +1 −5

Details

171 171 

172For enterprise deployments of Claude Code, we support enterprise managed policy settings that take precedence over user and project settings. This allows system administrators to enforce security policies that users cannot override.172For enterprise deployments of Claude Code, we support enterprise managed policy settings that take precedence over user and project settings. This allows system administrators to enforce security policies that users cannot override.

173 173 

174System administrators can deploy policies to:174System administrators can deploy policies to the [managed settings file locations](/en/settings#settings-files).

175 

176* macOS: `/Library/Application Support/ClaudeCode/managed-settings.json`

177* Linux and WSL: `/etc/claude-code/managed-settings.json`

178* Windows: `C:\ProgramData\ClaudeCode\managed-settings.json`

179 175 

180These policy files follow the same format as regular [settings files](/en/settings#settings-files) but cannot be overridden by user or project settings. This ensures consistent security policies across your organization.176These policy files follow the same format as regular [settings files](/en/settings#settings-files) but cannot be overridden by user or project settings. This ensures consistent security policies across your organization.

181 177 

mcp.md +2 −10

Details

640 640 

641### Setting up enterprise MCP configuration641### Setting up enterprise MCP configuration

642 642 

643System administrators can deploy an enterprise MCP configuration file alongside the managed settings file:643System administrators can deploy an enterprise MCP configuration file alongside the managed settings file. See [settings files](/en/settings#settings-files) for the `managed-mcp.json` file locations on each platform.

644 

645* **macOS**: `/Library/Application Support/ClaudeCode/managed-mcp.json`

646* **Windows**: `C:\ProgramData\ClaudeCode\managed-mcp.json`

647* **Linux**: `/etc/claude-code/managed-mcp.json`

648 644 

649The `managed-mcp.json` file uses the same format as a standard `.mcp.json` file:645The `managed-mcp.json` file uses the same format as a standard `.mcp.json` file:

650 646 


673 669 

674### Restricting MCP servers with allowlists and denylists670### Restricting MCP servers with allowlists and denylists

675 671 

676In addition to providing enterprise-managed servers, administrators can control which MCP servers users are allowed to configure using `allowedMcpServers` and `deniedMcpServers` in the `managed-settings.json` file:672In addition to providing enterprise-managed servers, administrators can control which MCP servers users are allowed to configure using `allowedMcpServers` and `deniedMcpServers` in the [managed settings file](/en/settings#settings-files):

677 

678* **macOS**: `/Library/Application Support/ClaudeCode/managed-settings.json`

679* **Windows**: `C:\ProgramData\ClaudeCode\managed-settings.json`

680* **Linux**: `/etc/claude-code/managed-settings.json`

681 673 

682#### Restriction options674#### Restriction options

683 675 

memory.md +3 −7

Details

9Claude Code offers four memory locations in a hierarchical structure, each serving a different purpose:9Claude Code offers four memory locations in a hierarchical structure, each serving a different purpose:

10 10 

11| Memory Type | Location | Purpose | Use Case Examples | Shared With |11| Memory Type | Location | Purpose | Use Case Examples | Shared With |

12| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------- | -------------------------------------------------------------------- | ------------------------------- |12| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------- | -------------------------------------------------------------------- | ------------------------------- |

13| **Enterprise policy** | macOS: `/Library/Application Support/ClaudeCode/CLAUDE.md`<br />Linux: `/etc/claude-code/CLAUDE.md`<br />Windows: `C:\ProgramData\ClaudeCode\CLAUDE.md` | Organization-wide instructions managed by IT/DevOps | Company coding standards, security policies, compliance requirements | All users in organization |13| **Enterprise policy** | macOS: `/Library/Application Support/ClaudeCode/CLAUDE.md`<br />Linux: `/etc/claude-code/CLAUDE.md`<br />Windows: `C:\Program Files\ClaudeCode\CLAUDE.md` | Organization-wide instructions managed by IT/DevOps | Company coding standards, security policies, compliance requirements | All users in organization |

14| **Project memory** | `./CLAUDE.md` or `./.claude/CLAUDE.md` | Team-shared instructions for the project | Project architecture, coding standards, common workflows | Team members via source control |14| **Project memory** | `./CLAUDE.md` or `./.claude/CLAUDE.md` | Team-shared instructions for the project | Project architecture, coding standards, common workflows | Team members via source control |

15| **User memory** | `~/.claude/CLAUDE.md` | Personal preferences for all projects | Code styling preferences, personal tooling shortcuts | Just you (all projects) |15| **User memory** | `~/.claude/CLAUDE.md` | Personal preferences for all projects | Code styling preferences, personal tooling shortcuts | Just you (all projects) |

16| **Project memory (local)** | `./CLAUDE.local.md` | Personal project-specific preferences | Your sandbox URLs, preferred test data | Just you (current project) |16| **Project memory (local)** | `./CLAUDE.local.md` | Personal project-specific preferences | Your sandbox URLs, preferred test data | Just you (current project) |


92 92 

93To set up organization-level memory management:93To set up organization-level memory management:

94 94 

951. Create the enterprise memory file in the appropriate location for your operating system:951. Create the enterprise memory file at the **Enterprise policy** location shown in the [memory types table above](#determine-memory-type).

96 

97* macOS: `/Library/Application Support/ClaudeCode/CLAUDE.md`

98* Linux/WSL: `/etc/claude-code/CLAUDE.md`

99* Windows: `C:\ProgramData\ClaudeCode\CLAUDE.md`

100 96 

1012. Deploy via your configuration management system (MDM, Group Policy, Ansible, etc.) to ensure consistent distribution across all developer machines.972. Deploy via your configuration management system (MDM, Group Policy, Ansible, etc.) to ensure consistent distribution across all developer machines.

102 98 

Details

41 41 

42## Administrator Configuration42## Administrator Configuration

43 43 

44Administrators can configure OpenTelemetry settings for all users through the managed settings file. This allows for centralized control of telemetry settings across an organization. See the [settings precedence](/en/settings#settings-precedence) for more information about how settings are applied.44Administrators can configure OpenTelemetry settings for all users through the [managed settings file](/en/settings#settings-files). This allows for centralized control of telemetry settings across an organization. See the [settings precedence](/en/settings#settings-precedence) for more information about how settings are applied.

45 

46The managed settings file is located at:

47 

48* macOS: `/Library/Application Support/ClaudeCode/managed-settings.json`

49* Linux and WSL: `/etc/claude-code/managed-settings.json`

50* Windows: `C:\ProgramData\ClaudeCode\managed-settings.json`

51 45 

52Example managed settings configuration:46Example managed settings configuration:

53 47 

settings.md +4 −2

Details

19 settings. System administrators can deploy policies to:19 settings. System administrators can deploy policies to:

20 * macOS: `/Library/Application Support/ClaudeCode/managed-settings.json`20 * macOS: `/Library/Application Support/ClaudeCode/managed-settings.json`

21 * Linux and WSL: `/etc/claude-code/managed-settings.json`21 * Linux and WSL: `/etc/claude-code/managed-settings.json`

22 * Windows: `C:\ProgramData\ClaudeCode\managed-settings.json`22 * Windows: `C:\Program Files\ClaudeCode\managed-settings.json`

23 * `C:\ProgramData\ClaudeCode\managed-settings.json` will be deprecated in a future version.

23* Enterprise deployments can also configure **managed MCP servers** that override24* Enterprise deployments can also configure **managed MCP servers** that override

24 user-configured servers. See [Enterprise MCP configuration](/en/mcp#enterprise-mcp-configuration):25 user-configured servers. See [Enterprise MCP configuration](/en/mcp#enterprise-mcp-configuration):

25 * macOS: `/Library/Application Support/ClaudeCode/managed-mcp.json`26 * macOS: `/Library/Application Support/ClaudeCode/managed-mcp.json`

26 * Linux and WSL: `/etc/claude-code/managed-mcp.json`27 * Linux and WSL: `/etc/claude-code/managed-mcp.json`

27 * Windows: `C:\ProgramData\ClaudeCode\managed-mcp.json`28 * Windows: `C:\Program Files\ClaudeCode\managed-mcp.json`

29 * `C:\ProgramData\ClaudeCode\managed-mcp.json` will be deprecated in a future version.

28* **Other configuration** is stored in `~/.claude.json`. This file contains your preferences (theme, notification settings, editor mode), OAuth session, [MCP server](/en/mcp) configurations for user and local scopes, per-project state (allowed tools, trust settings), and various caches. Project-scoped MCP servers are stored separately in `.mcp.json`.30* **Other configuration** is stored in `~/.claude.json`. This file contains your preferences (theme, notification settings, editor mode), OAuth session, [MCP server](/en/mcp) configurations for user and local scopes, per-project state (allowed tools, trust settings), and various caches. Project-scoped MCP servers are stored separately in `.mcp.json`.

29 31 

30```JSON Example settings.json theme={null}32```JSON Example settings.json theme={null}

vs-code.md +26 −25

Details

414. Review and accept edits directly in the interface414. Review and accept edits directly in the interface

42 * **Tip**: Drag the sidebar wider to see inline diffs, then click on them to expand for full details42 * **Tip**: Drag the sidebar wider to see inline diffs, then click on them to expand for full details

43 43 

44### Using Third-Party Providers44### Configuration

45 45 

46The VS Code extension supports using Claude Code with third-party providers like Amazon Bedrock, Microsoft Foundry, and Google Vertex AI. When configured with these providers, the extension will not prompt for login. To use third-party providers, configure environment variables in the VS Code extension settings:46The VS Code extension reads the same `settings.json` files as the CLI. See the [settings documentation](/en/settings) for details.

47 47 

481. Open VS Code settings48#### Third-Party Providers and Gateways

492. Search for "Claude Code: Environment Variables"49 

503. Add the required environment variables50To use the VS Code extension with third-party providers (Amazon Bedrock, Google Vertex AI, Microsoft Foundry) or gateways that handle authentication:

51 51 

52#### Environment Variables521. Add the appropriate environment variables for your provider or gateway to your Claude Code `settings.json`:

53 53 ```json theme={null}

54| Variable | Description | Required | Example |54 {

55| :---------------------------- | :------------------------------------- | :----------------------------- | :----------------------------------------------- |55 "env": {

56| `CLAUDE_CODE_USE_BEDROCK` | Enable Amazon Bedrock integration | Required for Bedrock | `"1"` or `"true"` |56 "CLAUDE_CODE_USE_BEDROCK": "1",

57| `CLAUDE_CODE_USE_FOUNDRY` | Enable Microsoft Foundry integration | Required for Foundry | `"1"` or `"true"` |57 "AWS_REGION": "us-east-2",

58| `CLAUDE_CODE_USE_VERTEX` | Enable Google Vertex AI integration | Required for Vertex AI | `"1"` or `"true"` |58 "AWS_PROFILE": "your-profile"

59| `AWS_REGION` | AWS region for Bedrock | | `"us-east-2"` |59 }

60| `AWS_PROFILE` | AWS profile for Bedrock authentication | | `"your-profile"` |60 }

61| `CLOUD_ML_REGION` | Region for Vertex AI | | `"global"` or `"us-east5"` |61 ```

62| `ANTHROPIC_VERTEX_PROJECT_ID` | GCP project ID for Vertex AI | | `"your-project-id"` |62 

63| `ANTHROPIC_FOUNDRY_RESOURCE` | Azure resource name for Foundry | Required for Microsoft Foundry | `"your-resource"` |632. Disable the VS Code extension login prompt via [`vscode://settings/claudeCode.disableLoginPrompt`](vscode://settings/claudeCode.disableLoginPrompt) or in VS Code's settings:

64| `ANTHROPIC_FOUNDRY_API_KEY` | API key for Microsoft Foundry | Optional for Microsoft Foundry | `"your-api-key"` |64 ```json theme={null}

65| `ANTHROPIC_MODEL` | Override primary model | Override model ID | `"us.anthropic.claude-sonnet-4-5-20250929-v1:0"` |65 {

66| `ANTHROPIC_SMALL_FAST_MODEL` | Override small/fast model | Optional | `"us.anthropic.claude-3-5-haiku-20241022-v1:0"` |66 "claudeCode.disableLoginPrompt": true

67| `CLAUDE_CODE_SKIP_AUTH_LOGIN` | Disable all prompts to login | Optional | `"1"` or `"true"` |67 }

68 ```

68 69 

69For detailed setup instructions and additional configuration options, see:70For detailed setup instructions and additional configuration options, see:

70 71 

71* [Claude Code on Amazon Bedrock](/en/amazon-bedrock)72* [Claude Code on Amazon Bedrock](/en/amazon-bedrock)

72* [Claude Code on Microsoft Foundry](/en/microsoft-foundry)

73* [Claude Code on Google Vertex AI](/en/google-vertex-ai)73* [Claude Code on Google Vertex AI](/en/google-vertex-ai)

74* [Claude Code on Microsoft Foundry](/en/microsoft-foundry)

74 75 

75### Not Yet Implemented76### Not Yet Implemented

76 77