这是 Workstation 关于 AWS 上的 Claude Opus 5 的开发者指南 — Anthropic 最强的 Opus 模型，现已登陆 Amazon Bedrock 与 Claude Platform on AWS。内容涵盖能力、Bedrock 与 Claude Platform 对比、模型 ID、Invoke/Converse/Mantle 代码、治理（ZDR）、缓存，以及如何在不撑爆 token 预算的情况下把 Opus 5 接入生产智能体系统。
来源：AWS Machine Learning Blog — Introducing Claude Opus 5 on AWS（2026 年 7 月）。规格已与 Bedrock 模型卡 及 Anthropic 定价页交叉核对。投产前请在 AWS/Anthropic 文档中核实当前区域与价格。
1. 已上线内容
2026 年 7 月 24 日，Claude Opus 5 通过以下方式在 AWS 可用：
- Amazon Bedrock — 统一推理，含 Guardrails、Knowledge Bases、IAM，以及默认零数据保留（ZDR）。
- Claude Platform on AWS — Anthropic 原生 API/控制台体验，AWS 计费与认证；ZDR 可按需开通。
Anthropic 将 Opus 5 定位为面向 智能体编码、长时运行智能体 与 文档密集型专业工作 的跃升，据其称在许多领域智能水平可媲美 Fable 5，定价为 Opus 档。
2. 工程师关心的规格
| 能力 | Opus 5（Bedrock 模型卡） |
|---|---|
| 上下文窗口 | 100 万 tokens |
| 最大输出 | 128K tokens |
| 推理 | 默认开启 Adaptive thinking（可关闭；关闭时 effort 上限较高） |
| 知识截止日期 | 2026 年 5 月 |
| 模态 | 文本 + 图像输入；文本输出 |
| Prompt caching | 支持 — 每个 checkpoint 最少 512 tokens；最多 4 个 checkpoint；TTL 5 分钟或 1 小时 |
| API | Invoke、Converse、Messages（bedrock-runtime / bedrock-mantle） |
标价（Claude Platform / Anthropic 公布）： 约 $5 / MTok 输入 与 $25 / MTok 输出，通过 prompt cache 命中与 batch 可大幅节省。Bedrock 计费可能因层级/区域而异 — 请查看 Bedrock 定价页。
3. 业务成果（通俗说明）
- 更少卡住的智能体 — Opus 5 旨在推进长任务、从工具失败中恢复，并对错误指令提出质疑。
- 更可信的编码助手 — 更好导航大型代码库；在艰难重构上更接近“资深工程师”表现。
- 文档运营 — 合规包、财务分析、多文档报告，一致性更深。
- 数据治理 — Bedrock ZDR + 驻留 geo ID 减少“能否放进公共聊天机器人？”的争议。
对金融服务、工作流自动化与多日项目智能体，Opus 5 是自然的主导模型。在资金、认证与生产部署上仍需人工门控。
4. 开发者路由 — 何时用 Opus 5 vs 其他
Routine tickets / format / classify → Haiku / Sonnet Default product agent / RAG Q&A → Sonnet 5-class Hard coding + long agents + docs → Opus 5 ← you are here Peak-critical / Mythos-only paths → Fable 5 / Mythos 5 (if licensed)
Workstation 经验法则：把 Opus 5 放在 planner 与 lead-builder 智能体；扇出 worker 用更便宜的模型。参见我们的 多智能体团队手册。
5. Bedrock vs Claude Platform on AWS
| 关注点 | Amazon Bedrock | Claude Platform on AWS |
|---|---|---|
| ZDR | 默认 | 按需 |
| AWS Guardrails / KB / AgentCore | 原生 | Anthropic 原生功能集 |
| 认证 / 计费 | IAM + AWS 账单 | AWS Console + 统一计费 |
| 最适合 | 企业 AWS 环境 | 已在 Anthropic API 上的团队 |
6. 模型 ID 与地理路由
在 bedrock-runtime 上：
global.anthropic.claude-opus-5— 最大吞吐量，无驻留约束us.anthropic.claude-opus-5— 美国/加拿大驻留路径eu.anthropic.claude-opus-5— 欧盟驻留路径au.anthropic.claude-opus-5— 澳大利亚驻留路径
在 bedrock-mantle Messages API 上，使用 anthropic.claude-opus-5 与 Mantle 区域端点。在 IaC 中选择 geo ID — 对受监管工作负载不要硬编码 global.。
区域可用性（公告）：包括美国东部（弗吉尼亚北部）、亚太（墨尔本）、欧洲（爱尔兰）、欧洲（斯德哥尔摩）等 — 请在 Bedrock 文档中确认实时列表。
7. 前置条件
- 已为 Opus 5 启用 Bedrock 模型访问的 AWS 账户
- IAM：
bedrock:InvokeModel、bedrock:InvokeModelWithResponseStream（以及所需的 create/inference 权限） - Python 3.8+、
boto3，可选anthropic[bedrock] - 已为目的区域配置 AWS CLI
8. 代码 — InvokeModel
import boto3
import json
bedrock = boto3.client("bedrock-runtime", region_name="us-east-1")
response = bedrock.invoke_model(
modelId="global.anthropic.claude-opus-5",
contentType="application/json",
accept="application/json",
body=json.dumps({
"anthropic_version": "bedrock-2023-05-31",
"max_tokens": 4096,
"messages": [
{
"role": "user",
"content": (
"Design a multi-region AWS architecture in Python that "
"supports 100k RPS with graceful degradation."
),
}
],
}),
)
result = json.loads(response["body"].read())
# Content blocks may include thinking + text — print text blocks
for block in result.get("content", []):
if block.get("type") == "text" or "text" in block:
print(block.get("text", block))
9. 代码 — Converse API（推荐的多模型形态）
import boto3
bedrock = boto3.client("bedrock-runtime", region_name="us-east-1")
response = bedrock.converse(
modelId="global.anthropic.claude-opus-5",
messages=[
{
"role": "user",
"content": [
{
"text": (
"Design a multi-region AWS architecture in Python that "
"supports 100k RPS with graceful degradation."
)
}
],
}
],
inferenceConfig={"maxTokens": 4096},
)
blocks = response["output"]["message"]["content"]
print("\n".join(b.get("text", "") for b in blocks if "text" in b))
若您已在单一客户端后切换模型，Converse 通常是最干净的路径。
10. 代码 — 经 Bedrock Mantle 的 Anthropic Messages
from anthropic import AnthropicBedrockMantle
client = AnthropicBedrockMantle(aws_region="us-east-1")
message = client.messages.create(
model="anthropic.claude-opus-5",
max_tokens=4096,
messages=[
{
"role": "user",
"content": (
"Design a multi-region AWS architecture in Python that "
"supports 100k RPS with graceful degradation."
),
}
],
)
for block in message.content:
text = getattr(block, "text", None)
if text:
print(text)
安装：pip install 'anthropic[bedrock]'。Mantle 自动使用 SigV4。
11. 对话中途工具
Bedrock 上的 Opus 5 支持通过 role: "system" 消息上的 tool_addition / tool_removal 内容块在对话中途增删工具，而无需重发完整的顶层 tools 数组。这对仅在风险门控后才解锁工具的长时智能体很重要。确切 schema 请见当前 Bedrock 文档。
12. 网络/安全说明
AWS 指出 Opus 5 相对 Opus 4.8 提升了与网络相关的能力。在更高风险领域，服务可能回退到 Opus 4.8 并通知您；请在 API 中有意配置回退，使生产行为可预测。
13. 生产清单（Workstation）
- 启用模型访问；为驻留固定 geo model ID。
- 附加 Bedrock Guardrails（PII、主题、在使用处做 grounding）。
- 对大型 system prompt / 工具 schema 开启 prompt caching。
- 限制
maxTokens；按智能体角色记录输入/输出 tokens。 - 路由：困难路径用 Opus 5；量大的用更便宜模型。
- 写工具、部署与支出采用人机回环。
- 在生产切换默认模型前准备评测集（golden tasks）。
- 接入 Review Bot + CI — Opus 5 仍需门控（见 wise-developer 工作流）。
- 对 Bedrock 支出设预算告警；批量任务优先 cache + batch。
- 在 ADR 中记录选择：“默认主导模型 = Bedrock 上的 Opus 5。”
14. 如何融入 Workstation 多智能体栈
Brief → Planner (Opus 5) → Builders (Sonnet/Opus mix)
→ Review Bot + Reviewer agent (Opus 5 on hard diffs)
→ Ops / GitOps promote with human gate
Opus 5 的长时运行行为非常适合必须在上下文中保持 Spec 与大 diff 的 Planner 与 Reviewer 智能体。不要把 Opus 5 的 token 花在每一次 lint 修复上。
15. 明天一早怎么开始
- 打开 Bedrock Playground → 选择 Claude Opus 5 → 跑一条困难编码提示。
- 把上面的 Converse 片段复制到 scratch Lambda 或 notebook。
- 在 10 个 golden tasks 上对比质量与当前 Sonnet/Opus 4.x 默认。
- 若在困难任务上胜出，只在配置中切换 lead-agent 的 model ID — 不要整支舰队一起换。
可选：使用 Bedrock Advanced Prompt Optimization，按评测标准改写提示。
16. 结语
AWS 上的 Claude Opus 5 为企业提供通往前沿 Opus 级编码与智能体性能的受治理路径。Bedrock 默认 ZDR 的故事与模型卡同样重要。开发者应采用 Converse 或 Mantle，固定 geo ID，积极缓存，并把 Opus 5 留在关键路径 — 而不是每一次聊天。这就是 Workstation 推荐交付 Opus 5 的方式：高杠杆、成本可控、生产门控完整。
由 Workstation 发布。
