claude 模型命名:Haiku、Sonnet、Opus 与 API ID(2026)
Claude 模型命名:Anthropic 怎么给模型起名
claude 模型命名(英文常说 Claude model naming)是 Anthropic 用来区分代数、能力档位和 API id 的一套叫法。若把营销名和 API 字符串搞混,SDK 就会打到错误模型,甚至已退休的别名。
文档和后台里通常能看到三层:
- 家族 / 品牌 — Claude
- 档位昵称 — Haiku(更快更便宜)、Sonnet(均衡)、Opus(能力最高)
- 带版本的 API id — 以官方 Models 列表 / 文档里的快照字符串为准(不要凭记忆硬写)
昵称给人看;计费、限流和评测认的是 API id。
昵称档位怎么理解
|
昵称 |
典型角色 |
团队何时选用 |
|---|---|---|
|
Haiku |
更低延迟 / 成本 |
分类、轻改写、高 QPS 工具 |
|
Sonnet |
默认主力 |
编程代理、RAG 回答、多数生产对话 |
|
Opus |
最高质量 |
重推理、长规划、高风险草稿 |
具体速度与价格随代数变。上表只表意图,上线前仍以当前价目页对应 id 为准。
延伸阅读:How to use Claude API、在 Claude Code 里配置模型、Claude models comparison。
API id 和展示名
- claude.ai / Console 展示名可能缩短或本地化。
- 请求里的 model 参数必须是文档中的 id(大小写敏感)。
- 别名有时把 “latest” Sonnet/Opus 指到滚动目标——生产若要可复现评测,应钉死带日期的 id。
- 镜像 / 网关可能再次改名;要显式维护 别名 → 上游 Anthropic id(参见 OpenAI SDK with Claude)。
排查超时或过载时,日志里记下真实发出的 model id,不要只写 “Sonnet”。可对照:operation timed out、529 overloaded。
团队落地清单
- 每次发版前拉官方模型列表;不要只硬编码昵称。
- 配置 / 功能开关里存
model_id,界面文案再用昵称。 - 在 Claude Code / agent 里确认改模型的配置键(配置文件位置、MCP 配置)。
- Runbook 里同时写中文检索词(claude 模型命名、Haiku/Sonnet/Opus)和对应 API id。
- 即使同昵称,升级带日期 id 后也要跑一小撮黄金用例。
常见混用
- Slack 说 Opus,代码却打 Sonnet id
- 以为凡是
claude-xxx主机都是 Anthropic 官方 - 没固定 max tokens 与提示长度就跨昵称比延迟
- 界面翻译了昵称,却忘了 API id 保持英文原样
小结
claude 模型命名要把友好档位(Haiku / Sonnet / Opus)和真正计费路由的 API id 分开。生产钉 id,昵称给人看;有人搜 claude 模型命名 时,同时回答档位故事和客户端实际发送的字符串。