如果您的开发人员使用 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重新打开最近的会话并确认它响应。告诉您的管理员任何缺失的工具或连接器。
