亚马逊AWS官方博客

通过 Amazon Bedrock 运行 Claude Cowork 配置实践

摘要:我们希望用一个详细的案例来解读亚马逊云科技的 CUR(Cost and Usage Report,成本及用量报告)报告,并且分享一些 CUR 可视化的思路。


一、背景

Claude Cowork 是 Anthropic 推出的 AI 助手桌面端产品,支持通过 Amazon Bedrock 作为推理后端运行。这意味着你可以在不注册 Anthropic 账号的情况下,直接使用 AWS 账号来驱动 Claude,所有模型推理流量都走你自己的 AWS 账户,数据不会被存储或用于训练。

对于希望在企业内统一 AI 使用治理、让数据流量留在自己 AWS 账户内、并按量计费的团队而言,这是目前最干净的 Claude 桌面端接入路径。本文将带你从零开始,完成 Claude Cowork + Amazon Bedrock 的配置,整个过程大约 10 分钟。

参考资料: – AWS 官方博客 — From developer desks to the whole organization: Running Claude Cowork in Amazon BedrockAnthropic 官方文档 — Cowork 3P Installation

二、前置条件

  • 一台 macOS 或 Windows 电脑
  • 一个 AWS 账号,且已开通 Amazon Bedrock 服务访问权限
  • 确保你的 AWS 账号在目标 Region(如 us-east-1)已启用 Claude 模型的访问权限

三、第一步:下载安装 Claude 桌面端

  1. 打开浏览器,访问 https://claude.com/download
  2. 根据你的操作系统下载对应的安装包:
    • macOS:下载 .dmg 文件,打开后将 Claude 拖入 Applications 文件夹
    • Windows:下载 .msix 安装包,双击安装
  3. 安装完成后,先打开 Claude 应用,你会看到一个登录页面(Sign In),显示 “Continue with Google” 和 “Enter your email” 等选项

不要着急登录! 我们不需要通过 Anthropic 账号登录,接下来的步骤会配置 Bedrock 作为推理后端。

四、第二步:在 Amazon Bedrock 控制台生成 API Key

4.1 进入 API Keys 页面

  1. 登录 AWS 管理控制台
  2. 在搜索栏输入 Bedrock,进入 Amazon Bedrock 服务
  3. 在左侧导航栏中,找到 Discover 区域,点击 API keys

你会看到如下页面,包含 Short-term API keys 和 Long-term API keys 两种类型:

[图1:Bedrock API Keys 页面]

4.2 生成 Long-term API Key

  1. 切换到 Long-term API keys 标签页
  2. 点击右上角的 Generate long-term API keys 按钮(橙色按钮)

4.3 配置 API Key 参数

在弹出的配置页面中:

[图2:配置 API Key]

  • API key name:系统会自动生成一个名称(格式类似 BedrockAPIKey-xxxx-at-<your-account-id>)
  • API key expiration:选择有效期,建议选择 365 days
  • Advanced permissions:勾选 Permissions to access Amazon Bedrock Marketplace models(这会附加 AmazonBedrockMarketplaceAccess 策略)
  • 点击右下角 Generate 按钮

4.4 处理安全风险提示

生成过程中可能会弹出安全风险确认对话框:

[图3:安全风险确认]

  • 在 “Additional comments” 文本框中输入确认理由,例如:I decide to accept this risk
  • 点击 Send feedback and proceed 按钮

4.5 复制 API Key

生成成功后,页面会显示你的 API Key:

[图4:复制 API Key]

⚠️ 重要提示:

页面上会有黄色警告 “Copy your API key now – you won’t be able to retrieve it after leaving this page.”

  • 点击 Copy API Key 按钮,将 API Key 复制到剪贴板
  • 建议同时点击 Download API Key 保存到本地,以防丢失
  • 妥善保管这个 Key,后续配置 Claude 时需要用到

五、第三步:启用 Developer Mode

回到 Claude 桌面端应用。此时你应该还停留在登录页面,接下来我们需要先启用开发者模式。

[图5:启用 Developer Mode]

  1. 点击顶部菜单栏的 Help
  2. 选择 Troubleshooting(子菜单会展开)
  3. 点击 Enable Developer Mode

启用后,菜单栏会出现新的 Developer 菜单项。

六、第四步:配置 Third-Party Inference(核心步骤)

6.1 打开配置窗口

[图6:打开配置窗口]

  1. 点击顶部菜单栏的 Developer
  2. 选择 Configure Third-Party Inference…

6.2 填写 Bedrock 连接信息

在打开的配置窗口中:

[图7:填写 Bedrock 配置]

Connection 部分

选择推理提供商为 Bedrock(AWS)

BEDROCK CREDENTIALS 部分

字段 填写内容 说明
AWS region us-east-1 你的 Bedrock 服务所在区域
AWS bearer token 粘贴第二步复制的 API Key 这就是之前生成的 Long-term API Key
Bedrock base URL 留空 除非你使用 VPC 端点
AWS profile name 留空 使用 bearer token 时会被忽略
AWS config directory ~/.aws 默认值即可

IDENTITY & MODELS 部分

在 Model list 中输入模型 ID。

⚠️ 重要提示:

模型 ID 需要加上 us. 前缀! 这是跨区域推理配置文件(Cross-Region Inference Profile)的要求。

输入以下两个模型 ID(按回车确认每一个):

us.anthropic.claude-opus-4-7

us.anthropic.claude-sonnet-4-6

ℹ️ 提示:

Model list 中第一个模型会作为默认模型。你也可以根据需要调整顺序或只添加其中一个。

其他字段(Organization UUID、Credential helper script)留空即可。

6.3 应用配置

填写完毕后,点击窗口右下角的 Apply locally 按钮。

“Apply locally” 会将配置写入本地,仅对当前设备生效。如果你需要导出给团队使用,可以点击 “Export” 导出为 .mobileconfig(macOS)或 .reg(Windows)文件。

七、第五步:重启 Claude

点击 “Apply locally” 后,会弹出一个对话框:

[图8:Relaunch Claude]

“Relaunch Claude?” Configuration was written to disk. Claude needs to relaunch to use this provider.

点击 Relaunch now 按钮,Claude 会自动重启。

八、第六步:选择 Continue with Bedrock

重启后,Claude 登录页面会出现新的选项。选择 Continue with Bedrock,即可跳过 Anthropic 账号登录,直接通过 Bedrock 进入。

九、第七步:大功告成!

成功进入后,你会看到 Claude Cowork 的主界面:

[图9:Cowork 主界面]

注意左下角显示 Cowork 3P | Bedrock,确认你已经成功通过 Amazon Bedrock 连接。

此时你可以: – 在对话框输入问题,开始与 Claude 交互 – 右下角切换模型(如 Opus 4.7 / Sonnet 4.6) – 使用 “Work in a project” 功能进行项目级协作 – 创建计划任务(Scheduled)等

十、第八步:启用 1M Context 超长上下文(推荐)

完成上面的基础配置后,你可能会注意到模型选择器显示的是 Opus 4.7,而不是 Opus 4.7 (1M context)。这是因为 Claude Desktop 默认以 200K context 运行,需要额外配置才能解锁 1M 上下文窗口。

为什么需要这一步? Bedrock 上的 Claude Opus 4.7 原生支持 1M context window,但 Claude Desktop 需要你在模型配置中显式声明 supports1m: true,才会以 1M 模式发送请求。

10.1 打开配置文件

由于 UI 输入框会将 JSON 对象当作纯文本字符串保存(导致 400 错误),我们需要直接编辑配置文件。

方法一:通过 Claude 界面找到配置文件

1. 点击左下角的 Cowork 3P | Bedrock 区域,弹出菜单

[图10:Settings 菜单]

2. 选择 Settings(快捷键 Cmd + ,)

3. 在 Settings 页面左侧,点击 Developer

4. 点击 Edit Config 按钮,系统会用默认编辑器打开配置文件所在目录

[图11:Developer Edit Config]

点击 Edit Config 后,Finder 会打开 Claude-3p 目录,找到 configLibrary 文件夹并进入:

[图12:configLibrary 文件夹]

方法二:直接在终端中打开

# macOS
open ~/Library/Application\ Support/Claude-3p/configLibrary/

# Windows
explorer %APPDATA%\Claude-3p\configLibrary\

10.2 编辑配置文件

在 configLibrary/ 目录下,你会看到一个 UUID 命名的 .json 文件(如 ba652f1b-fd10-415f-88e1-5ac467c813a1.json),用任意文本编辑器打开它。

找到 inferenceModels 字段,将纯字符串格式改为 对象格式,并加上 "supports1m": true

修改前(默认 200K)

"inferenceModels": [
  "us.anthropic.claude-opus-4-7",
  "us.anthropic.claude-sonnet-4-6"
]

修改后(启用 1M)

"inferenceModels": [
  { "name": "us.anthropic.claude-opus-4-7", "supports1m": true },
  { "name": "us.anthropic.claude-sonnet-4-6", "supports1m": true }
]

保存文件。

10.3 重启 Claude 使配置生效

完全退出 Claude 并重新打开:

# macOS:强制退出并重新打开
killall Claude && open -a Claude

或者手动 Cmd + Q 退出,再重新启动。

10.4 验证 1M 已生效

重新进入 Cowork 后,点击右下角的模型选择器,你会看到每个模型都多了一个 (1M context) 变体:

[图13:1M Context 已生效]

选择 Opus 4.7 (1M context) 或 Sonnet 4.6 (1M context) 即可使用 1M 超长上下文。

ℹ️ 注意:

如果你在 UI 的 Model list 输入框中直接输入 {“name”:”us.anthropic.claude-opus-4-7″,”supports1m”:true},Claude Desktop 会把它当作字符串保存(变成 “{\”name\”:…}”),导致向 Bedrock 发送请求时报 400 错误。这是 UI 的已知限制,所以必须通过直接编辑配置文件来解决。

十一、常见问题

Q:重启后仍然显示普通登录页面,没有 “Continue with Bedrock” 选项?

  • 检查是否正确启用了 Developer Mode
  • 确认 “Apply locally” 是否点击成功
  • 完全退出 Claude(Cmd+Q / 右键退出),再重新打开
  • 检查日志:~/Library/Logs/Claude/main.log(macOS)或 %APPDATA%\Claude\logs\main.log(Windows)

Q:连接后报错或无法使用模型?

  • 确认 AWS 账号在对应 Region 已开启 Claude 模型的访问权限(Model access)
  • 确认 API Key 没有过期
  • 确认模型 ID 前缀为 us.(跨区域推理要求)

Q:API Key 安全吗?

  • Long-term API Key 建议仅用于个人测试和探索
  • 生产环境建议使用 Short-term API Key(12 小时自动过期)或 IAM 角色认证
  • 定期轮换 Key,设置合理的过期时间

Q:费用如何计算?

  • 使用 Bedrock 推理的费用通过你的 AWS 账单结算
  • 采用按量付费(consumption-based pricing),无需额外的 Anthropic 订阅费
  • 具体价格参考 Amazon Bedrock 定价页面

十二、配置快速参考

配置项
Provider Bedrock (AWS)
AWS Region us-east-1(或你的目标区域)
AWS Bearer Token Bedrock Long-term API Key
Model ID (推荐) us.anthropic.claude-opus-4-7
Model ID (备选) us.anthropic.claude-sonnet-4-6
1M Context 需编辑配置文件,使用 {“name”:”<model-id>”,”supports1m”:true} 对象格式
配置文件路径 (macOS) ~/Library/Application Support/Claude-3p/configLibrary/*.json
配置文件路径 (Windows) %APPDATA%\Claude-3p\configLibrary\*.json

十三、附录:Windows 部署与配置指南(注册表方式)

本节适用于 Windows 环境下通过 MSIX 包部署 Claude Desktop 并使用注册表配置 Bedrock 推理服务的场景。

13.1 环境要求

  • 操作系统:Windows 10 或 Windows 11
  • 管理员权限:安装 MSIX 包及启用系统功能需要管理员权限
  • 虚拟机平台 (Virtual Machine Platform):运行 Claude Cowork 沙箱环境的必要组件,未开启则应用无法正常启动

13.2 W1. 下载安装包

从 Anthropic 官方下载页面获取最新的 Windows MSIX 安装包:

13.3 W2. 使用 PowerShell 安装

以管理员身份打开 PowerShell,进入安装包所在目录,运行:

Add-AppxPackage -Path ".\Claude.msix" -Verbose
  • Verbose 参数能让你实时看到安装进度。命令运行后直接返回且无红字报错,则表示安装成功。

13.4 W3. 开启虚拟化支持

Claude 的 Cowork 功能依赖 Windows 虚拟化底层。安装后运行以下命令并重启电脑:

Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform -All

此功能必须重启后才能生效。

13.5 W4. 配置第三方推理服务(注册表方式)

对于企业部署或不方便使用 GUI 的场景,推荐直接通过注册表注入配置。

注册表路径:HKEY_CURRENT_USER\Software\Policies\Claude

13.5.1 创建注册表脚本

将以下内容保存为 Claude_Bedrock_Config.reg:

Windows Registry Editor Version 5.00

[HKEY_CURRENT_USER\Software\Policies\Claude]
"inferenceProvider"="bedrock"
"inferenceBedrockRegion"="us-east-1"
"inferenceBedrockBearerToken"="YOUR_BEDROCK_API_TOKEN"
"inferenceModels"="[{\"name\":\"us.anthropic.claude-opus-4-7\",\"supports1m\":true},{\"name\":\"us.anthropic.claude-sonnet-4-6\",\"supports1m\":true}]"

ℹ️ 注意:

将 YOUR_BEDROCK_API_TOKEN 替换为你在第二步中生成的 Bedrock API Key。模型 ID 已包含 us. 前缀和 supports1m: true 配置,直接支持 1M 上下文。

13.5.2 导入配置

  1. 双击 Claude_Bedrock_Config.reg
  2. 在弹出的系统警告中点击 “是” 确认导入

13.6 W5. 验证与排查

在开始菜单中搜索并启动 Claude。如果配置成功:

  • 界面左侧会出现 Cowork 和 Code 标签
  • 应用不会跳转到 claude.ai 登录页面,而是直接进入推理模式

13.7 常见问题

问题 排查方法
启动无反应 检查任务管理器确保没有旧 Claude 进程残留;确认”虚拟机平台”是否已启用并重启
无法调用模型 确认注册表中 inferenceBedrockBearerToken 是否有效;确认 us-east-1 区域权限已下发
查看详细日志 PowerShell 运行:Get-AppxLog -ActivityId (Get-AppxPackage *Claude*).PackageFullName

Windows 参考文档: – Install and configure Claude Cowork with third-party platformsDeploy Claude Desktop for Windows

十四、参考链接

十五、结语

➡️ 下一步行动:

相关产品:

相关文章:

*前述特定亚马逊云科技生成式人工智能相关的服务目前在亚马逊云科技海外区域可用。亚马逊云科技中国区域相关云服务由西云数据和光环新网运营,具体信息以中国区域官网为准。

本篇作者

陈映初

AWS 解决方案架构师,专注于 Agentic AI 与生成式 AI 应用在 AWS 上的架构设计与落地实践。Apache DevLake(ASF 顶级项目)PMC 成员,长期参与开源社区建设。

马立博

AWS HCLS 行业解决方案架构师,15 年 IT 架构与 DevOps 深耕经验,先后在金融、汽车、游戏等高并发、高可用业务场景中承担核心技术工作,目前全面拥抱且专注 Agentic AI / AIOps 应用系统及解决方案的创新。


AWS 架构师中心:云端创新的引领者

探索 AWS 架构师中心,获取经实战验证的最佳实践与架构指南,助您高效构建安全、可靠的云上应用