SSO、SCIM 佈建和座位分配在 Claude 帳戶級別進行配置。有關這些步驟,請參閱 Claude 企業管理員指南 和 座位分配。
選擇您的 API 提供者
Claude Code 透過多個 API 提供者之一連接到 Claude。您的選擇會影響計費、驗證、您繼承的合規狀況,以及您的開發人員可以使用的 Claude Code 功能。
某些 Claude Code 功能需要 claude.ai 帳戶。Cloud sessions、Routines、Code Review、Remote Control 和 Chrome extension 無法透過 Console API 金鑰或雲端提供者認證單獨使用。如果您透過 Amazon Bedrock、Google Cloud’s Agent Platform 或 Microsoft Foundry 部署,請規劃開發人員是否也需要 Claude for Teams 或 Enterprise 座位。每個功能頁面都列出其計畫要求。
有關涵蓋驗證、區域和功能奇偶性的完整提供者比較,請參閱 企業部署概述。每個提供者的驗證設定位於 Authentication。
無論提供者如何,網路配置 中的代理和防火牆要求都適用。如果您想要在多個提供者前面有單一端點或集中式請求日誌記錄,請參閱 LLM gateway。
決定設定如何到達裝置
受管設定定義組織政策。Claude Code 按優先順序檢查下表中的四個來源。Claude Code 如何合併受管來源說明其中哪些適用、政策協助程式變更的內容,以及如何組成每個來源。該表是決策地圖。
Claude Code 在啟動時擷取 server-managed 設定,並在工作階段期間每小時重新整理一次,無需部署端點基礎設施。透過 claude.ai 管理員控制台傳遞需要 Claude for Teams 或 Enterprise 計畫。在 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 上的部署可以透過執行 Claude apps gateway 獲得相同的遠端傳遞,或改用其中一個基於檔案或作業系統級別的機制。
如果您的組織混合使用提供者,請為 claude.ai 使用者設定 server-managed settings 加上 基於檔案或 plist/registry 的備援,以便其他使用者仍然接收受管政策。
plist 和 HKLM 登錄位置適用於任何提供者,並且由於需要管理員權限才能寫入,因此可以抵抗篡改。Windows 使用者登錄中的 HKCU 無需提升即可寫入,因此將其視為便利預設值而不是執行通道。
根據預設,WSL 僅讀取
/etc/claude-code 的 Linux 檔案路徑。若要將您的 Windows 登錄和 C:\Program Files\ClaudeCode 政策擴展到同一機器上的 WSL,請在這些僅限管理員的 Windows 來源之一中設定 wslInheritsWindowsSettings: true。
無論您選擇哪種機制,受管值都優先於使用者和專案設定,除了少數安全敏感的例外。陣列設定(例如 permissions.allow 和 permissions.deny)會合併來自所有來源的項目,因此開發人員可以擴展受管清單但無法從中移除。對於 fallbackModel、availableModels 和 modelPicker,受管值會取代較低層級而不是合併。
Claude Code Desktop 中的 WSL 工作階段
在 Windows 上,Claude Code Desktop 可以在 WSL 2 發行版內執行 Code 工作階段。工作階段的 Claude Code 程序在發行版內執行,因此它透過上述 WSL 探索路徑解析受管設定:除非部署了wslInheritsWindowsSettings: true,否則僅限 Windows 的來源無法到達它。
Claude Desktop 在偵測到裝置為組織受管的裝置上預設關閉 WSL 工作階段,例如當 C:\Program Files\ClaudeCode\managed-settings.json 存在時。若要開啟它們,請部署 Windows 登錄政策,這需要 Claude Desktop v1.19367.0 或更新版本:
- 在
HKLM\SOFTWARE\Policies\Claude下建立名為disableWslSessions的值,並將其設定為REG_SZ字串false或REG_DWORD0。此值位於 Claude Desktop 政策金鑰下,與包含受管設定的ClaudeCode金鑰分開。在 HKLM 下部署該值,這需要管理員權限才能寫入。HKCU 下的值不會啟用 WSL 工作階段。 - 如果您部署
C:\Program Files\ClaudeCode\managed-settings.json,請保留它。一旦 HKLM 下的disableWslSessions為false,Desktop 即使該檔案存在也允許 WSL 工作階段。
main.log 以查找 [wslPolicyGate] denying WSL session。拒絕的原因在括號中,例如 (cli-file-present)。
啟用 WSL 工作階段後,將您的受管設定擴展到它們:
- 透過 HKLM 登錄或
C:\Program Files\ClaudeCode檔案部署wslInheritsWindowsSettings: true,以便 WSL 工作階段繼承與主機工作階段相同的政策。 - 透過在 WSL 工作階段內執行
/status進行驗證,並讀取Setting sources行。若要解釋它列出的內容,請參閱在 /status 中讀取來源。
決定要執行什麼
受管設定可以鎖定工具、沙箱執行、限制 MCP 伺服器和外掛程式來源,以及控制哪些 hooks 執行。每一行都是一個控制表面,具有驅動它的設定鍵。
如果您的成員透過 claude.ai 或 Anthropic API 登入,且您使用 Claude Enterprise 方案,您也可以從組織的管理設定中管理模型,而無需部署任何內容:
- Organization model restrictions:停用個別模型。在伺服器端執行。
- Organization default model:設定新工作階段啟動時使用的模型。成員仍可切換模型。若要在啟動時將他們恢復為您的預設模型,請開啟該節所述的覆寫設定。若要限制他們可選擇的模型,請使用組織模型限制。
- Organization effort limits:按角色限制工作量級別。在伺服器端執行。
availableModels 用於限制、model 用於預設值,以及 maxEffortLevel 用於工作量限制。
Cloud sessions 在 claude.ai 上有其專屬的管理介面:
- Cloud environments 頁面:擁有者建立組織共享環境,設定成員雲端工作階段的網路存取級別、環境變數和設定指令碼。
- 預設環境:擁有者在 claude.ai/admin-settings/claude-code 另外選擇組織的預設環境。
- Git providers 頁面:請參閱已連結的 GitHub 帳戶,以了解連結至您組織的 GitHub 帳戶。
curl 和 wget 仍然可以到達任何 URL。沙箱透過在作業系統級別執行的網路網域允許清單來彌補這一差距。
有關這些控制防禦的威脅模型,請參閱 Security。
已連結的 GitHub 帳戶
在 Team 和 Enterprise 方案中,Organization settings > Git providers 的 GitHub 區段會列出透過 Claude GitHub App 連結至您 Claude 組織的 GitHub 組織和個人帳戶。Claude Code、Claude Tag 和 Claude Security 共用此清單。開啟此頁面需要您在 Claude 組織中具備管理員角色。 管理員或成員都可以連結帳戶:- 管理員連線:管理員在該區段中點擊 Connect,或在已連結帳戶後點擊 Add organization,並在 GitHub 組織上安裝 Claude GitHub App。以此方式連結組織,需要一位同時是該 GitHub 組織擁有者及您 Claude 組織管理員的人員。
- 成員連線:當成員將其 GitHub 帳戶連接至 Claude 時(例如在設定雲端工作階段期間),Claude 會連結該成員所擁有、且已安裝 Claude GitHub App 的 GitHub 帳戶。這可能包括其個人帳戶以及其擁有的 GitHub 組織。
github_app_installation_linked 和 github_app_installation_unlinked。
設定使用情況可見性
根據您需要報告的內容選擇監控。儀表板、API 和支出控制在 Claude for Teams 或 Enterprise 計畫與 Claude Console 組織之間有所不同,因此在根據功能規劃報告之前,請檢查「可用性」欄。
在 Teams 和 Enterprise 上,每個使用者的使用情況和支出數字來自您組織分析設定中的支出報告,而不是分析儀表板。雲端提供者透過 AWS Cost Explorer、GCP Billing 或 Azure Cost Management 公開支出。如需規劃跨 Claude chat、Claude Code 和 Cowork 的企業預算,請參閱 Claude Enterprise 消費指南。
檢查資料處理
在 Team、Enterprise、Claude API 和雲端提供者計畫上,Anthropic 不會在您的程式碼或提示上訓練模型。您的 API 提供者決定保留和合規狀況。
如果您需要請求層級的稽核日誌記錄或依資料敏感性路由流量,我們建議您在開發人員和您的提供者之間放置閘道:自行託管的 Claude apps gateway 會記錄包含 IdP 身分的每個請求稽核日誌,或者您也可以使用另一個 LLM gateway。透過閘道進行的工作階段不適用於 HIPAA 設定。檢查開發人員如何登入和連線列出了哪些登入和連線方式適用。有關法規要求和認證,請參閱 Legal and compliance。
驗證和上線
配置受管設定後,讓開發人員在 Claude Code 內執行/status。在 Status 標籤上,Setting sources 行顯示 Enterprise managed settings 後面跟著括號中的來源;驗證強制執行列出標籤。
分享這些資源以幫助開發人員入門:
- 快速入門:從安裝到使用專案的首次會話逐步說明
- 常見工作流程:日常任務的模式,例如程式碼審查、重構和除錯
- Claude Code 101 和 Claude Code in Action:Claude Academy 上的免費自進度課程
- 執行
/logout然後/login以切換帳戶 - 如果缺少企業驗證選項,執行
claude update - 更新後重新啟動終端
後續步驟
選擇提供者和傳遞機制後,繼續進行詳細設定:- Server-managed settings:從 Claude 管理員控制台傳遞受管政策
- All settings:每個設定鍵、檔案位置和範例
- Which value Claude Code uses:跨受管、專案、本機和使用者設定的優先級規則
- Monorepos and large repos:為部署到 monorepo 的組織提供的每個目錄設定模式
- Amazon Bedrock、Google Cloud’s Agent Platform、Microsoft Foundry:提供者特定部署
- Claude Enterprise Administrator Guide:SSO、SCIM、座位管理和推出劇本