接入教程

claude 模型命名:Haiku、Sonnet、Opus 与 API ID(2026)

ROIBest AI

Claude 模型命名:Anthropic 怎么给模型起名

claude 模型命名(英文常说 Claude model naming)是 Anthropic 用来区分代数、能力档位和 API id 的一套叫法。若把营销名和 API 字符串搞混,SDK 就会打到错误模型,甚至已退休的别名。

文档和后台里通常能看到三层:

  1. 家族 / 品牌 — Claude
  2. 档位昵称 — Haiku(更快更便宜)、Sonnet(均衡)、Opus(能力最高)
  3. 带版本的 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。

团队落地清单

  1. 每次发版前拉官方模型列表;不要只硬编码昵称。
  2. 配置 / 功能开关里存 model_id,界面文案再用昵称。
  3. 在 Claude Code / agent 里确认改模型的配置键(配置文件位置、MCP 配置)。
  4. Runbook 里同时写中文检索词(claude 模型命名、Haiku/Sonnet/Opus)和对应 API id。
  5. 即使同昵称,升级带日期 id 后也要跑一小撮黄金用例。

常见混用

  • Slack 说 Opus,代码却打 Sonnet id
  • 以为凡是 claude-xxx 主机都是 Anthropic 官方
  • 没固定 max tokens 与提示长度就跨昵称比延迟
  • 界面翻译了昵称,却忘了 API id 保持英文原样

小结

claude 模型命名要把友好档位(Haiku / Sonnet / Opus)和真正计费路由的 API id 分开。生产钉 id,昵称给人看;有人搜 claude 模型命名 时,同时回答档位故事和客户端实际发送的字符串。