SpyBara
Go Premium

hipaa-setup.md 2026-10-04 23:58 UTC to 2026-10-05 17:59 UTC

This page contains 305 additions and 0 deletions.

2026
Mon 5 18:57

為 HIPAA-ready 組織設定 Claude Code（本機模式）

準備開發人員的電腦，以在 HIPAA 設定下執行 Claude Code（本機模式）。涵蓋版本、網路存取、受管設定及本機資料。

HIPAA 設定是 Claude Enterprise 方案上的一項組織設定，適用於處理受保護健康資訊（PHI）並與 Anthropic 簽訂商業夥伴協議（BAA）的組織。此設定適用於 Claude Code（本機模式）和 Cowork（本機模式），並會限制這兩項產品中的功能。

本頁面適用於負責準備開發人員電腦的 IT 或安全管理員。設定本身由您 Claude 組織的主要擁有者（Primary Owner）套用。在 HIPAA-ready Enterprise 方案上使用 Claude Code（本機模式）和 Cowork（本機模式）說明了您的 BAA 包含哪些內容、設定如何套用，以及如何排定套用日期。

如果您組織的成員也使用 Cowork，請同時依照為 HIPAA-ready 組織設定 Cowork（本機模式）進行操作。該文件涵蓋 Claude Desktop 政策及 Cowork 的本機資料。

下表列出各項設定工作的執行時機：

時機 執行事項
套用設定之前 準備電腦：檢查開發人員的連線方式、更新應用程式、允許網路存取，並部署受管設定
套用之後 Code 分頁會保持關閉，直到擁有者（Owner）重新開啟。在電腦上確認設定
持續進行 管理本機工作階段資料

在套用 HIPAA 設定之前準備電腦

我們建議您從本節的工作開始，並在套用設定之前完成這些工作。

檢查開發人員的登入與連線方式

HIPAA 設定僅在開發人員以 Claude Enterprise 帳戶登入，且 Claude Code 直接連線至 Claude API 的工作階段中生效。在任何其他連線方式下，開發人員仍可繼續使用 Claude Code，但不會套用 HIPAA 設定。

下表列出哪些連線方式符合資格。若要了解您的 BAA 是否涵蓋「否」列中的工作階段，請參閱在 HIPAA-ready Enterprise 方案上使用 Claude Code（本機模式）和 Cowork（本機模式）。

Claude Code 的連線方式 是否符合 HIPAA 設定資格
Claude Enterprise 帳戶，直接連線至 Claude API 是
Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry、Claude Platform on AWS，或 Claude apps 閘道 否
LLM 閘道或任何其他自訂的 ANTHROPIC_BASE_URL 否
在沒有 Claude Enterprise 登入的電腦上使用 ANTHROPIC_AUTH_TOKEN 或 apiKeyHelper 否
Claude Console API 金鑰或聯合憑證 否。這些工作階段屬於 Claude Console 組織，該組織有其自己的協議與設定

檢查電腦的連線方式

在電腦上開啟終端機，執行 claude，並在提示字元中輸入 /status。Status 分頁會顯示以下各行：

行 出現時機
Login method 和 Organization 工作階段以 claude.ai 帳戶登入。若為 Claude Enterprise 帳戶，Login method 會顯示 Claude Enterprise account，而 Organization 會顯示您的組織
API provider 僅在工作階段使用雲端供應商或 Claude apps 閘道時出現
Anthropic base URL 僅在設定了 ANTHROPIC_BASE_URL 時出現

如果電腦使用的連線方式不符合 HIPAA 設定資格，您可以使用受管設定來封鎖雲端供應商、閘道，以及透過 ANTHROPIC_API_KEY、ANTHROPIC_AUTH_TOKEN 或 apiKeyHelper 設定的憑證。

更新 Claude Code 和 Claude Desktop

HIPAA 設定需要 Claude Code v2.1.285 或更新版本，以及 Claude Desktop v2.19675.0 或更新版本。如果您的組織同時使用終端機和 Claude Desktop 應用程式，請兩者都更新。

若要查看已安裝的 Claude Code 版本，請在終端機中執行此命令。此命令在 Bash、Zsh 和 PowerShell 中皆相同：

claude --version

受支援的安裝會輸出 2.1.285 (Claude Code) 或更高的版本號。

若要查看已安裝的 Claude Desktop 版本，請參閱檢查您的版本。

開發人員在舊版本上會看到的情況

對於套用 HIPAA 設定的組織，Anthropic 的伺服器會拒絕來自低於最低版本的請求。Anthropic 會隨時間提高最低版本，您不需要進行任何設定。

應用程式 開發人員在舊版本上會看到的情況
Claude Code 每個請求都會失敗並顯示 API Error，說明該版本低於您組織政策所要求的最低版本
Claude Desktop 出現 Update required 對話方塊，告知開發人員須更新 Claude Desktop 才能繼續使用 Code 分頁

若要讓開發人員維持在受支援的版本，請持續更新 Claude Code。關於 Claude Desktop，請參閱更新 Claude Desktop。

允許網路存取

請透過您的代理伺服器和防火牆，允許下表中的主機透過 HTTPS 連接埠 443 連線。請允許整個主機，而非個別路徑。

主機 用途
api.anthropic.com Claude API 請求、遙測，以及告知 Claude Code 已開啟 HIPAA 設定的組織政策
claude.ai、claude.com、platform.claude.com 登入及 token 重新整理
downloads.claude.ai 原生安裝程式及其更新
mcp-proxy.anthropic.com 來自 claude.ai 的連接器

此表列出原生安裝的 Claude Code 在終端機中登入、執行和更新所需的主機。其餘主機列於下列頁面：

  • 其他安裝方式與選用功能：網路存取需求列出 npm 和 Homebrew 安裝檢查更新時使用的主機，以及外掛安裝等功能所需的主機
  • Code 分頁與 Cowork：Desktop 網路存取需求列出 Claude Desktop 額外需要的主機
  • 檢查 TLS 的代理伺服器：自訂 CA 憑證說明如何信任您代理伺服器的憑證

透過企業 HTTPS 代理伺服器的工作階段仍符合 HIPAA 設定資格，只要該代理伺服器能連線至表中的主機即可。

Claude Code 會在啟動時，以及工作階段使用期間約每小時一次，從 api.anthropic.com 擷取您組織的政策，藉此得知您的組織已套用 HIPAA 設定。該政策記錄了您組織的 HIPAA 狀態及隨之而來的功能限制。

若要檢查某台電腦是否已擷取政策，請參閱在電腦上確認設定。

部署受管設定

您可以使用受管設定來引導開發人員以 Claude Enterprise 帳戶登入、封鎖雲端供應商和閘道，以及設定每台電腦保留本機工作階段資料的天數。無論 HIPAA 設定是否生效，這些設定都會套用。

本節中的設定是我們建議作為起點的範例。您的組織須自行決定其環境的需求，並確認其設定符合這些需求。

以下範例設定了四個設定鍵，您可以將其加入組織部署的受管設定中：

{
  "forceLoginMethod": "claudeai",
  "forceLoginOrgUUID": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "allowedProviders": ["anthropic"],
  "cleanupPeriodDays": 30
}

各設定鍵的作用

下表列出各設定鍵應設定的值，以及 Claude Code 對其強制執行的內容。

設定鍵 設定值 Claude Code 強制執行的內容
forceLoginMethod "claudeai" Claude Code 引導開發人員使用 claude.ai 登入，而非 Claude Console
forceLoginOrgUUID 您的組織 ID，擁有者可從 claude.ai 管理設定中複製 當 claude.ai 登入屬於其他組織時，Claude Code 會在啟動時結束
allowedProviders ["anthropic"] Claude Code 拒絕在雲端供應商或閘道上啟動
cleanupPeriodDays 您的記錄政策允許電腦保留工作階段資料的天數 每台電腦都會在相同天數後刪除舊的工作階段資料

HIPAA 設定不會限制 cleanupPeriodDays，因此開發人員可以在自己的設定中調高此值。當您在受管設定中設定它時，Claude Code 會忽略開發人員設定的值。

設定了 forceLoginMethod 或 forceLoginOrgUUID 後，Claude Code 也會拒絕以 ANTHROPIC_API_KEY、ANTHROPIC_AUTH_TOKEN 或 apiKeyHelper 進行身分驗證的工作階段。

確認設定已載入

在具有這些設定的電腦上執行 claude，以 Claude Enterprise 帳戶登入，然後輸入 /status。Setting sources 行會列出 Enterprise managed settings，後面以括號標示來源，例如 (file)，而 Allowed providers 行會顯示 Anthropic API (managed allowedProviders)。如果 Setting sources 未列出該項，或缺少 Allowed providers 行，請參閱檢查政策是否生效。

受管設定鍵無法封鎖的工作階段

即使部署了這些設定鍵，某些工作階段仍可在沒有 HIPAA 設定的情況下執行：

若要了解您的 BAA 是否涵蓋在沒有 HIPAA 設定的情況下執行的工作階段，請參閱在 HIPAA-ready Enterprise 方案上使用 Claude Code（本機模式）和 Cowork（本機模式）。

在電腦上確認設定

在設定套用至您的組織後，請在一台受管電腦上執行此檢查。

1

重新啟動 Claude Code

結束任何執行中的工作階段，開啟終端機，然後執行 claude。使用中的執行中工作階段約在一小時內即可取得設定，無須重新啟動。重新啟動時，Claude Code 會立即擷取設定。

2

檢查啟動通知

確認 Claude Code 啟動時會輸出 Per your organization's policy, some features are limited · /status for details。

3

檢查頁尾

確認提示字元下方的頁尾右側出現 HIPAA configured 標籤。在 v2.1.286 之前，該標籤顯示為 HIPAA。

4

執行 /status

在提示字元中輸入 /status。確認 Status 分頁在 Organization configuration 行上列出 HIPAA。

5

檢查 Claude Desktop

套用 HIPAA 設定會關閉您組織的 Code 分頁。如果您的組織有使用此分頁，請請擁有者前往 Organization settings > Claude Code 並開啟 Desktop 切換開關。關於 Cowork，請參閱在 Claude Desktop 中確認 HIPAA 設定。

重新載入 Claude Desktop 或重新登入。確認標題列顯示 HIPAA configured 標籤。在 Mac 上，請開啟側邊欄以查看此標籤。

如果 /status 中缺少 HIPAA，請依序檢查以下原因：

  1. 帳戶或連線方式錯誤：確認 /status 在 Organization 行上顯示您的組織，且沒有 API provider 或 Anthropic base URL 行。檢查開發人員的登入與連線方式列出了不符合設定資格的連線方式。
  2. 政策擷取遭到封鎖：在 /status 中尋找 Organization policy 行，該行會說明原因。在工作階段之外，請執行 claude doctor 並查看同一行，該行會說明 Claude Code 從何處載入政策，或政策為何未載入。請透過您的代理伺服器允許 api.anthropic.com，然後重新啟動 Claude Code。
  3. 設定尚未套用：詢問主要擁有者是否已套用設定。

開發人員在 Claude Code 中會看到的情況

套用 HIPAA 設定後，部分 Claude Code 功能在終端機中會關閉或運作方式有所不同。下表列出開發人員最可能向您詢問的變更。HIPAA 功能可用性表列出了所有 Claude Code 和 Cowork 功能，包括擁有者可以重新開啟的功能。

開發人員注意到的情況 原因
WebFetch 工具無法使用 WebFetch 已關閉。網頁搜尋仍可運作
--cloud、/teleport 和 Remote Control 遭到拒絕 雲端工作階段和 Remote Control 已關閉
/feedback 和 /bug 無法使用 意見回饋提交已關閉
Claude 無法發佈 artifact Artifact 發佈已關閉
讀取 ANTHROPIC_API_KEY 的 MCP 伺服器或 hook 無法再進行身分驗證 Claude Code 會從其啟動的程序中移除 Anthropic 憑證
以 /login 登入其他組織後限制仍然存在 HIPAA 狀態會持續到 Claude Code 重新啟動為止

命令、hook 和 MCP 伺服器中的 Anthropic 憑證

套用 HIPAA 設定後，Claude Code 會從其啟動的 shell 命令、hook 和 MCP 伺服器的環境中，移除其用來連線 Anthropic 的憑證，例如 ANTHROPIC_API_KEY 和 ANTHROPIC_AUTH_TOKEN。

HIPAA 設定不會移除雲端供應商或 GitHub 憑證，因此推送至 GitHub 或呼叫其他服務的命令仍會以該開發人員的存取權限運作。您與 Anthropic 簽訂的 BAA 不涵蓋其傳送至這些服務的資料。如需完整的合格服務清單，請參閱實作指南。

若要限制 Claude 可使用的命令和主機，請參閱權限規則和沙箱。

管理本機工作階段資料

Claude Code（本機模式）和 Cowork（本機模式）會將工作階段資料儲存在每位開發人員的電腦上。保護和刪除這些資料是您組織的責任。

Claude Code 資料

應用程式資料列出了 Claude Code（本機模式）在電腦上儲存的內容、其保留清除作業在 cleanupPeriodDays 之後會刪除哪些內容，以及哪些內容會保留到有人將其刪除為止。同一頁面也說明了在套用 HIPAA 設定的組織中有何不同。

保留清除作業僅在有人啟動 Claude Code 時執行，因此沒有人啟動 Claude Code 的電腦會保留其資料。

Code 分頁資料

Code 分頁會將資料儲存在以下位置：

  • 逐字稿：位於 ~/.claude/projects/，與終端機逐字稿放在一起。自動清除說明了保留清除作業何時會刪除這些逐字稿。
  • Claude Desktop 資料資料夾：在 macOS 上為 ~/Library/Application Support/Claude。在 Windows 上為 %APPDATA%\Claude，若是從 Anthropic 下載的安裝程式則為 %LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude，因此請兩者都檢查。套用 HIPAA 設定後，Claude Desktop 會刪除閒置時間超過 cleanupPeriodDays 的本機 Code 分頁工作階段，包括已加上星號的工作階段。它只會在執行期間刪除這些工作階段。Claude Desktop 會以下列其中一種方式處理已刪除工作階段的 worktree：
    • 沒有未提交的變更、工作階段未加上星號或釘選，且沒有其他工作階段正在使用該 worktree：Claude Desktop 會移除該 worktree
    • 其他任何情況：worktree 會保留在電腦上

在 Windows 上，~ 代表 %USERPROFILE%。

Cowork 資料

管理每台電腦上的 Cowork 資料列出了 Cowork（本機模式）儲存資料的位置，以及 Claude Desktop 會刪除的內容。

立即刪除工作階段資料

如果您的組織需要在保留清除作業刪除之前移除某位開發人員的工作階段資料，您可以用一個命令移除其中大部分資料。以該開發人員的身分登入電腦，並在任何 shell 中執行此命令：

claude purge --all --yes

在 v2.1.288 之前，此命令為 claude project purge。

此命令會刪除每個專案的逐字稿和自動記憶、tasks/、debug/ 和 file-history/ 中的項目、history.jsonl，以及 ~/.claude.json 中的專案項目。若未加上 --yes，它會先輸出計畫並詢問確認。

清除作業會留下其他可能包含工作階段內容的路徑，例如 paste-cache/ 中貼上的文字。清除本機資料列出了您可以手動刪除的路徑。若要完全清除一台電腦，例如在重新指派之前，請抹除該電腦。

開發人員離職處理

移除開發人員的席位或帳戶不會刪除其電腦上的任何內容，/logout 也不會刪除工作階段資料。若要移除所有資料，您可以使用裝置管理工具抹除該電腦。