跳至主要內容

移動 Claude Code CLI 使用者

如果您的開發人員使用 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 金鑰。

開發人員可以執行 /status 以查看作用中提供者及其設定的來源。如需遙測、網路主機和更新,請參閱資料使用、企業網路設定和進階設定。

追蹤成本和使用情況

在 Bedrock、Google Cloud 和 Foundry 上,使用情況按權杖計費到您的雲端帳戶,成本控制在您的雲端計費主控台中。透過閘道,使用情況按權杖計費給擁有閘道轉發之認證的人。claude.ai 分析儀表板和 Claude Code Analytics API 不涵蓋此使用情況。如需按使用者報告,請使用OpenTelemetry 或 LLM 閘道。

開發人員保留的內容

項目

移動後

要執行的操作

設定、CLAUDE.md、自動記憶、技能、子代理、命令、掛鉤、外掛程式和 MCP 伺服器

它們保留。它們位於~/.claude、~/.claude.json 和專案資料夾中。

無,除非您登出(見下文)。在任何清理期間將這些資料夾保留在原位。

本機工作階段記錄

它們保留在 ~/.claude/projects/ 中,直到cleanupPeriodDays 移除它們。預設值為 30 天。claude --continue 和 claude --resume 重新開啟它們。

在您的試驗中測試繼續工作階段。在 Bedrock、Google Cloud 和 Foundry 上,工作階段的較早模型不會被還原。如果閘道的上游拒絕較早的思考簽名,Claude Code 會捨棄較早的思考區塊並重試。

雲端工作階段

Anthropic 將其儲存在 Claude 帳戶下。為第三方提供者設定 Claude Code 時,--cloud 無法使用,--resume 不會列出雲端工作階段。

在移動前,使用 --teleport 將您需要的每個工作階段拉入終端機。它會建立本機副本。它需要 claude.ai 登入、乾淨的工作樹、相同儲存庫的簽出以及推送到遠端的工作階段分支。

來自 claude.ai 的連接器

將其新增為使用者或專案範圍的 MCP 伺服器,或透過受管 MCP 設定部署它們。某些 Anthropic 託管的連接器(例如 Microsoft 365、Gmail 和 Google Calendar)不支援從您自己新增的伺服器登入,因此請為這些連接器規劃不同的伺服器。

從 claude.ai 同步的技能

技能同步不會在 Bedrock、Google Cloud 或 Foundry 上的工作階段中執行,或當閘道認證取代 claude.ai 登入時。較早同步的技能保留在 ~/.claude/skills/synced/ 中的磁碟上。

將您依賴的任何技能從 ~/.claude/skills/synced/ 複製到 ~/.claude/skills/。

從 claude.ai 同步的外掛程式

在 Bedrock、Google Cloud 或 Foundry 上的工作階段中既不下載也不載入,因為這些工作階段不會從 Anthropic 擷取功能旗標。當 ANTHROPIC_AUTH_TOKEN 或 apiKeyHelper 提供認證時,情況也是如此。

如果市場提供它們,請從市場重新安裝它們。

需要 claude.ai 登入的功能

無法從提供者到達。這些包括雲端工作階段、例行程序、受管程式碼審查、Ultrareview、遠端控制、Chrome 擴充功能和語音聽寫。在 Bedrock、Google Cloud 和 Foundry 上,頻道和分析儀表板也無法使用。Advisor 和 Code Mode 也是如此。CLI 的網路搜尋在 Bedrock 上無法使用。快速模式在 Bedrock 和 Foundry 上無法使用,在 Google Cloud 上限制為 Claude Fable 5.2。

使用 /loop 進行排程,使用 GitHub Actions 或 GitLab CI/CD 進行雲端執行(Foundry 上僅限 GitHub Actions),以及本機 /code-review。決定開發人員是否仍需要 Team 或 Enterprise 座位。

在重疊期間要注意的事項

開發人員檢查清單

移動前

  • 將 Claude Code 更新到您的管理員指定的版本。

  • 使用 claude --teleport 將您需要的任何雲端工作階段拉入終端機。首先確保工作階段的分支已推送到遠端,並清理您的工作樹。

  • 列出您使用的 claude.ai 連接器,以便將其新增為 MCP 伺服器。

  • 複製您依賴的任何技能(超出 ~/.claude/skills/synced/),並列出您需要重新安裝的同步外掛程式。

在您移動的那一天

  1. 按照您的管理員描述的方式登入您的雲端提供者,例如使用 aws sso login、gcloud auth application-default login 或 az login。

  2. 啟動 claude 並執行 /status。檢查提供者、模型和設定來源。

  3. 使用 claude --resume 重新開啟最近的工作階段,並確認它有回應。

  4. 告知您的管理員任何遺失的工具或連接器。

是否回答了您的問題?