Claude Opus 5 完全指南
官方模型页把 Claude Opus 5 归入上一代(legacy),它仍然可用,但官方建议考虑迁移到 Claude Opus 5.5。它与 Opus 4.8 同价、同上下文窗口,可以直接切换;差别在提示缓存与可靠知识截止:缓存门槛从 1024 token 降到 512,短系统提示和工具定义也能被缓存命中。
Claude Opus 5(claude-opus-5)自 2026-07-24 起可用,API 标价每百万 token 输入 $5 / 输出 $25,与 Opus 4.8 相同。官方模型页现在把它列在上一代(legacy)一档,写明仍然可用,但建议考虑迁移到 Claude Opus 5.5;官方弃用表给的暂定退役时间是「不早于 2027-07-24」。截至 2026-10-20,官方最新的 Opus 仍是 2026-09-22 发布的 Claude Opus 5.5($4 / $20,缓存读 $0.20)。能力与价格细节以官方文档为准。
关键参数
输入 $5、输出 $25 每百万 token,与 Opus 4.8 在官方价表上同价。
官方模型页写的 claude-opus-5 输入上下文就是 100 万 token,不需要额外配置;[1m] 是给更早的型号在 Claude Code 里选 1M 变体的后缀。
512 token 即可缓存,Opus 4.8 需要 1024
单次响应最多 12.8 万 token
与 Opus 4.8 到底差在哪
先说结论:官方模型页上两个型号的单价、上下文与能力项写法逐项一致;差别在提示缓存的最小长度和可靠知识截止。
价格与窗口:完全相同
官方定价页里 Claude Opus 5 与 Claude Opus 4.8 两行的输入、输出、缓存写入与缓存读取单价相同,两个模型页的上下文窗口与最大输出也一致:输入 $5 / 输出 $25 每百万 token,缓存写入 $6.25、缓存读取 $0.50,输入 100 万 / 输出 12.8 万 token —— 两个型号逐项一致。
提示缓存门槛:512 vs 1024
提示缓存按型号设了最小可缓存长度:官方缓存文档把 Claude Opus 5 列在 512 token 一档,Claude Opus 4.8 列在 1,024 一档,Claude Opus 4.7 列在 2,048 一档(2026-10-20 核对)。短于这个长度,官方写明标了 cache_control 也不会进缓存。Opus 4.8 的门槛是 1024 token,Opus 4.7 仍为 2048 —— 这条线此前在 2026-09-21 核过官方文档,本次复核分档未变。
缓存写入与读取的单价,两个型号在官方价表上同为每百万 token $6.25 与 $0.50,所以变的只是这条长度线。系统提示偏短、工具定义偏多、轮次很密的 agentic 工作流,最容易感到差别。
能力集:一致
官方两个模型页列出的能力项一致:输入是文本与图像、输出是文本,上下文 100 万 token、单次最大输出 12.8 万 token;视觉输入、工具调用(function calling)、PDF 输入、computer use、提示缓存这些标记在两页上也相同,为 Opus 4.8 写的集成代码通常不需要改动。要留意的是可靠知识截止不同:Opus 5 标 2026 年 5 月,Opus 4.8 标 2026 年 1 月。
怎么调用
在 Claude Code 里切换
会话中直接输入 /model 命令即可切换,不需要重启。
/model claude-opus-5
用环境变量指定默认模型
适合固定用某个型号的场景,写进 shell profile 即可长期生效。
ANTHROPIC_MODEL=claude-opus-5 claude
100 万 token 的上下文与 [1m] 后缀
官方模型页写的上下文窗口本来就是 100 万 token;Claude Code 文档也写明 Opus 4.7 及以后的型号默认就跑在 1M 窗口,不需要再加 [1m] 后缀,给更早的型号显式选 1M 变体时才用这个写法。
/model claude-opus-5[1m]
Claude 阵容怎么选
下表每百万 token 的输入与输出单价逐行取自 Anthropic 官方定价页;QCode 按 token 计费,各模型单价见 /models。
| 模型 | 输入 $/M | 输出 $/M | 上下文 / 输出 | 适合场景 |
|---|---|---|---|---|
| claude-opus-5 | $5.00 | $25.00 | 1M / 128K | 官方已列为上一代(legacy);缓存最小长度更低,适合工具定义多、轮次密集的用法;2026-09-22 起由 Opus 5.5 接任 |
| claude-opus-4-8 | $5.00 | $25.00 | 1M / 128K | 同价同窗口的成熟选择,官方价表里仍列这一行 |
| claude-fable-5 | $10.00 | $50.00 | 1M / 128K | 定价高于 Opus 的档位,面向长文与创意写作 |
| claude-sonnet-5 | $2.00 | $10.00 | 1M / 128K | 日常编码的性价比之选 |
| claude-haiku-4-5 | $1.00 | $5.00 | 200K / 64K | 格式化、简单问答、批量操作 |
表中单价与 Anthropic 官方定价页逐行核对过。QCode 侧的完整清单见 模型与价格页
常见问题
Opus 5 和 Opus 4.8 应该用哪个?
两者同价同窗口,可以互换,Opus 4.8 在官方模型页上仍标着 Active (legacy),继续提供服务。差别在提示缓存的最小长度:Opus 5 更低,工具定义多、单轮偏短的 agentic 用法更容易命中缓存。还在选型的话,官方模型总表的建议是从 Claude Opus 5.5 起步,它自 2026-09-22 起是最新的 Opus 型号($4 / $20),截至 2026-10-20 这一状态未变。
从 Opus 4.8 迁过来要改代码吗?
不需要。两个型号在官方模型页上的能力项与单价写法一致,通常只要把模型名从 claude-opus-4-8 换成 claude-opus-5。
对外可用的模型名有哪些?
官方模型页给出的 Claude API 型号名是 claude-opus-5,这个 ID 在 QCode 可调。在 Claude Code 里还可以给型号名或别名加 [1m] 后缀,用来选 100 万 token 的变体。
价格是多少?包含缓存吗?
官方价表:每百万 token 输入 $5、输出 $25,缓存写入 $6.25、缓存读取 $0.50,一小时的缓存档写入 $10。QCode 按 token 计费,各模型单价见 /models,实时数字以那一页为准。
支持哪些能力?
官方模型页写明输入是文本与图像、输出是文本,提示缓存对它开放;视觉输入、工具调用(function calling)、PDF 输入、computer use、提示缓存这些能力与 Opus 4.8 相同。走 Message Batches API 并加官方 beta 头时,单次最大输出可到 30 万 token。
需要单独开通吗?
不需要。列出的型号在所有套餐里都能调用,模型权限不因套餐不同,也不需要额外付费或提交申请。不想包月?按量包 ¥26 起买一笔额度,7 天内用完为止(人民币充值 ¥30 起)。
在 QCode 上使用 Opus 5
一个 Key 跨客户端通用
同一个 API Key 在 Claude Code 与 OpenAI Codex CLI 中通用,不必分别购买。
全部模型开放
所有套餐均可调用全部模型,不按套餐限制型号,也没有额外解锁费用。
按 token 计费
QCode 按 token 计费,各模型单价见 /models 页面。
国内直连
国内网络环境下可直接使用,无需自行处理网络问题。