如果您的開發人員使用 Claude Code CLI,請將其與桌面應用程式分開設定。桌面應用程式從其 Claude Desktop on 3P 設定中取得提供者設定,而不是從 ANTHROPIC_BASE_URL 或 settings.json,並且將其傳遞給它啟動的 Code 工作階段。CLI 讀取環境變數、設定檔和Claude Code 受管設定,這些設定使用單獨的原則金鑰。
本指南適用於 Claude Enterprise 方案組織的管理員。
本文章是從 Claude Enterprise 移動到雲端提供者上的 Claude Desktop的一部分,該文章定義了波次、重疊期間和截止日期等術語。
CLI 和在本機執行的所有內容都可在每個提供者上運作。移動後,開發人員以不同方式登入,您的原則以不同方式到達他們的電腦,某些功能無法使用。
將 CLI 連接到您的提供者
為Amazon Bedrock、Google Cloud、Microsoft Foundry 或LLM 閘道設定提供者變數。開發人員不需要 claude.ai 瀏覽器登入。使用閘道時,設定基本 URL 和閘道認證。僅使用基本 URL 時,已儲存的 claude.ai 登入保持為作用中認證,因此其限制和計費仍然適用。在團隊推出前,固定您的模型版本。
將原則傳遞到每個裝置
設定第三方提供者或自訂基本 URL 時,伺服器管理的設定不適用。將這些原則移動到裝置上的受管設定。您可以將其作為 managed-settings.json 檔案、com.anthropic.claudecode macOS 設定檔或 HKLM\SOFTWARE\Policies\ClaudeCode 登錄機碼傳遞。它們優先於使用者和專案設定,除了少數安全敏感的金鑰,其中來自較低層級的更嚴格值仍然適用。
限制電腦可以使用的提供者:設定
allowedProviders(Claude Code v2.1.285 或更新版本)。在重疊期間,列表如["anthropic", "bedrock"]讓開發人員使用其中任一個。移動後,僅列出新提供者。在使用者在 Claude Desktop 中保持登入 claude.ai 的電腦上保留 「anthropic」,因為沒有它,他們的 Cowork 工作階段會被拒絕。對於透過ANTHROPIC_BASE_URL到達的閘道,列出"customEndpoint"並將閘道 URL 放在同一受管來源的env區塊中。移除舊登入設定:使用閘道認證時,移除
forceLoginMethod和forceLoginOrgUUID,因為任一金鑰都會在啟動時阻止閘道認證。在雲端提供者上,這些金鑰僅在某些認證仍在電腦上時才阻止工作階段:ANTHROPIC_API_KEY、ANTHROPIC_AUTH_TOKEN、apiKeyHelper認證或由較早的 Claude Console 登入儲存的 API 金鑰。
追蹤成本和使用情況
在 Bedrock、Google Cloud 和 Foundry 上,使用情況按權杖計費到您的雲端帳戶,成本控制在您的雲端計費主控台中。透過閘道,使用情況按權杖計費給擁有閘道轉發之認證的人。claude.ai 分析儀表板和 Claude Code Analytics API 不涵蓋此使用情況。如需按使用者報告,請使用OpenTelemetry 或 LLM 閘道。
開發人員保留的內容
項目 | 移動後 | 要執行的操作 |
設定、 | 它們保留。它們位於 | 無,除非您登出(見下文)。在任何清理期間將這些資料夾保留在原位。 |
本機工作階段記錄 | 它們保留在 | 在您的試驗中測試繼續工作階段。在 Bedrock、Google Cloud 和 Foundry 上,工作階段的較早模型不會被還原。如果閘道的上游拒絕較早的思考簽名,Claude Code 會捨棄較早的思考區塊並重試。 |
雲端工作階段 | Anthropic 將其儲存在 Claude 帳戶下。為第三方提供者設定 Claude Code 時, | 在移動前,使用 |
來自 claude.ai 的連接器 | 將其新增為使用者或專案範圍的 MCP 伺服器,或透過受管 MCP 設定部署它們。某些 Anthropic 託管的連接器(例如 Microsoft 365、Gmail 和 Google Calendar)不支援從您自己新增的伺服器登入,因此請為這些連接器規劃不同的伺服器。 | |
從 claude.ai 同步的技能 | 技能同步不會在 Bedrock、Google Cloud 或 Foundry 上的工作階段中執行,或當閘道認證取代 claude.ai 登入時。較早同步的技能保留在 | 將您依賴的任何技能從 |
從 claude.ai 同步的外掛程式 | 在 Bedrock、Google Cloud 或 Foundry 上的工作階段中既不下載也不載入,因為這些工作階段不會從 Anthropic 擷取功能旗標。當 | 如果市場提供它們,請從市場重新安裝它們。 |
需要 claude.ai 登入的功能 | 無法從提供者到達。這些包括雲端工作階段、例行程序、受管程式碼審查、Ultrareview、遠端控制、Chrome 擴充功能和語音聽寫。在 Bedrock、Google Cloud 和 Foundry 上,頻道和分析儀表板也無法使用。Advisor 和 Code Mode 也是如此。CLI 的網路搜尋在 Bedrock 上無法使用。快速模式在 Bedrock 和 Foundry 上無法使用,在 Google Cloud 上限制為 Claude Fable 5.2。 | 使用 |
在重疊期間要注意的事項
在仍使用 claude.ai 進行驗證的工作階段中,伺服器管理的設定優先。預設情況下,Claude Code 使用它們並跳過裝置上的受管設定,除了少數例外,例如
env區塊和allowedProviders。如果某些開發人員保留在 claude.ai 上,為他們使用伺服器管理的設定,為其他人使用檔案或作業系統原則。已儲存的 claude.ai 登入保留在電腦上。雲端提供者認證優先於它,
/logout在雲端提供者處於作用中後無法使用。如果您想移除登入,請在部署提供者設定前讓開發人員登出。登出也移除已儲存的 MCP 伺服器登入和外掛程式祕密,因此他們需要再次授權這些。使用閘道認證時,/logout保持可用,您可以執行它以清除已儲存的登入。CLI 原則可以覆蓋您的桌面原則的一部分。預設情況下,如果電腦有 Claude Code 受管設定,桌面 Code 工作階段會忽略桌面應用程式提供的受管原則值。若要同時使用兩者,請參閱部署受管設定中的
parentSettingsBehavior。
開發人員檢查清單
移動前
將 Claude Code 更新到您的管理員指定的版本。
使用
claude --teleport將您需要的任何雲端工作階段拉入終端機。首先確保工作階段的分支已推送到遠端,並清理您的工作樹。列出您使用的 claude.ai 連接器,以便將其新增為 MCP 伺服器。
複製您依賴的任何技能(超出
~/.claude/skills/synced/),並列出您需要重新安裝的同步外掛程式。
在您移動的那一天
按照您的管理員描述的方式登入您的雲端提供者,例如使用
aws sso login、gcloud auth application-default login或az login。啟動
claude並執行/status。檢查提供者、模型和設定來源。使用
claude --resume重新開啟最近的工作階段,並確認它有回應。告知您的管理員任何遺失的工具或連接器。
