Text of code.claude.com › docs › en › hipaa-setup as Styx crawled it on Nov 19, 2026. The page may have changed since. Only its words are kept, without pictures or layout, and only the first part of a long page.

Open the live page

Set up Claude Code (local mode) for a HIPAA-ready organization - Claude Code Docs

Documentation Index Fetch the complete documentation index at: /docs/llms.txt Use this file to discover all available pages before exploring further. Skip to main content Assistant Responses are generated using AI and may contain mistakes. The HIPAA configuration is an organization setting on Claude Enterprise plans, for organizations that handle protected health information (PHI) and have a Business Associate Agreement (BAA) with Anthropic.

It applies to Claude Code (local mode) and Cowork (local mode), and it restricts features in both products. “(local mode)” means a local session, not a cloud session . Local sessions run in one of these places: Claude Code in the terminal Claude Code in the Code tab of Claude Desktop Cowork in Claude Desktop The Claude Code extensions for VS Code and JetBrains aren’t part of (local mode). They keep working with the HIPAA configuration applied, but your BAA doesn’t cover them.

See the Implementation Guide for the full list of Eligible Services. This page is for the IT or security administrator who prepares developers’ computers. The Primary Owner of your Claude organization applies the configuration itself. Use Claude Code (local mode) and Cowork (local mode) on a HIPAA-ready Enterprise plan explains what your BAA includes, how the configuration is applied, and how to schedule the date it’s applied.

If members of your organization also use Cowork, follow Set up Cowork (local mode) for a HIPAA-ready organization as well. It covers the Claude Desktop policy and Cowork’s local data. The table shows when to do each part of the setup: When What to do Before the configuration is applied Prepare computers : check how developers connect, update the apps, allow network access, deploy managed settings, and restrict Claude Desktop sign-in After it’s applied The Code tab is off until an Owner turns it back on.

Confirm the configuration on a computer Ongoing Manage local session data Prepare computers before the HIPAA configuration is applied We recommend you start with the tasks in this section and complete them before the configuration is applied. Check how developers sign in and connect The HIPAA configuration takes effect only in sessions where a developer signs in with a Claude Enterprise account and Claude Code connects directly to the Claude API.

On any other connection, developers can keep using Claude Code, but it doesn’t apply the HIPAA configuration . The table shows which connections are eligible. To find out whether your BAA covers a session in a “No” row, see Use Claude Code (local mode) and Cowork (local mode) on a HIPAA-ready Enterprise plan . How Claude Code connects Eligible for the HIPAA configuration A Claude Enterprise account, connecting directly to the Claude API Yes Amazon Bedrock, Google Cloud’s Agent Platform, Microsoft Foundry, Claude Platform on AWS, or a Claude apps gateway No An LLM gateway or any other custom ANTHROPIC_BASE_URL No ANTHROPIC_AUTH_TOKEN or apiKeyHelper , on a computer with no Claude Enterprise sign-in No A Claude Console API key or federation credentials No.

These sessions belong to a Claude Console organization, which has its own agreement and settings Check how a computer connects Open a terminal on the computer, run claude , and enter /status at the prompt. The Status tab shows these lines: Line When it appears Login method and Organization The session is signed in with a claude.ai account. For a Claude Enterprise account, Login method reads Claude Enterprise account and Organization shows your organization API provider Only when the session uses a cloud provider or a Claude apps gateway Anthropic base URL Only when ANTHROPIC_BASE_URL is set If a computer uses a connection that isn’t eligible for the HIPAA configuration, you can use managed settings to block cloud providers, gateways, and credentials set with ANTHROPIC_API_KEY , ANTHROPIC_AUTH_TOKEN , or apiKeyHelper .

Update Claude Code and Claude Desktop The HIPAA configuration requires Claude Code v2.1.285 or later and Claude Desktop v2.19675.0 or later. If your organization uses both the terminal and the Claude Desktop app , update both. To read the installed Claude Code version, run this command in a terminal. It’s the same in Bash, Zsh, and PowerShell: claude --version A supported installation prints 2.1.285 (Claude Code) or a higher number.

To read the installed Claude Desktop version, see Check your version . What developers see on an older version For organizations with the HIPAA configuration, Anthropic’s servers reject requests from versions older than the minimum version. Anthropic raises the minimum version over time, and there’s nothing for you to configure. App What a developer sees on an older version Claude Code Each request fails with an API Error that says the version is older than the minimum version your organization’s policy requires Claude Desktop An Update required dialog that tells the developer to update Claude Desktop to continue using the Code tab To keep developers on a supported version, keep Claude Code updated .

For Claude Desktop, see Update Claude Desktop . Allow network access Allow the hosts in this table through your proxy and firewall, over HTTPS on port 443. Allow each whole host, not individual paths. Host Needed for api.anthropic.com Claude API requests, telemetry, and the organization policy that tells Claude Code the HIPAA configuration is on claude.ai , claude.com , platform.claude.com Sign-in and token refresh sso.claude.com Sign-in, when your organization uses single sign-on downloads.claude.ai The native installer and its updates mcp-proxy.anthropic.com Connectors from claude.ai This table lists the hosts a native install of Claude Code needs in the terminal to sign in, run, and update.

These pages list the rest: Other install methods and optional features : Network access requirements lists the hosts that npm and Homebrew installs check for updates, and the hosts for features such as plugin installs The Code tab and Cowork : Desktop network access requirements lists the additional hosts Claude Desktop needs Proxies that inspect TLS : Custom CA certificates shows how to trust your proxy’s certificate Sessions that go through a corporate HTTPS proxy are still eligible for the HIPAA configuration, as long as the proxy can reach the hosts in the table.

Claude Code learns that your organization has the HIPAA configuration by fetching your organization’s policy from api.anthropic.com , when it starts and again about every hour while the session is in use. The policy is a record of your organization’s HIPAA status and the feature restrictions that follow from it. To check whether one computer has fetched the policy, see Confirm the configuration on a computer . Deploy managed settings You can use managed settings to direct developers to sign in with a Claude Enterprise account, to block cloud providers and gateways, and to set how many days every computer keeps local session data.

The settings apply whether or not the HIPAA configuration is in effect. The settings in this section are a sample that we recommend as a starting point. Your organization is responsible for deciding what its own environment needs and for confirming that its configuration meets those needs. The following sample sets four keys that you could add to the managed settings your organization deploys: { "forceLoginMethod" : "claudeai" , "forceLoginOrgUUID" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" , "allowedProviders" : [ "anthropic" ], "cleanupPeriodDays" : 30 } For a fuller managed-settings.json with sandboxing, a network allowlist, credential protections, and local data retention, see settings-hipaa.json and README-hipaa.md in the settings examples repository .

What each key does The table shows what to set each key to and what Claude Code enforces for it. Key Set it to What Claude Code enforces forceLoginMethod "claudeai" Claude Code directs developers to claude.ai sign-in in

The rest of this page is on the live site.